Spec-Zone.ru › OpenJDK 24

Класс DomainLoadStoreParameter

java.lang.Object
java.security.DomainLoadStoreParameter
Все реализованные интерфейсы:
KeyStore.LoadStoreParameter
public final class DomainLoadStoreParameter extends Object implements KeyStore.LoadStoreParameter
Данные конфигурации, определяющие хранилища ключей в домене хранилища ключей. Домен хранилища ключей — это набор хранилищ ключей, представленных как единое логическое хранилище ключей. Данные конфигурации используются во время KeyStore load и store операций.

Следующий синтаксис поддерживается для данных конфигурации:


     domain <domainName> [<property> ...] {
         keystore <keystoreName> [<property> ...] ;
         ...
     };
     ...
 
где domainName и keystoreName — идентификаторы, а property — пара ключ/значение. Ключ и значение разделены символом «равно», а значение заключено в двойные кавычки. Значение свойства может быть либо печатаемой строкой, либо двоичной строкой, состоящей из разделенных двоеточием пар шестнадцатеричных цифр. Многозначные свойства представлены как список значений, разделённых запятой и заключённых в квадратные скобки. См. Arrays.toString(java.lang.Object[]).

Для обеспечения уникальной идентификации записей хранилища ключей, каждый алиас записи префиксруется её keystoreName, а затем разделителем имени записи, и каждое keystoreName должно быть уникальным в своём домене. Префиксы имён записей опускаются при сохранении хранилища ключей.

Свойства контекстно-зависимые: свойства, применяемые ко всем хранилищам ключей в домене, находятся в разделе домена, а свойства, применяемые только к конкретному хранилищу ключей, находятся в разделе этого хранилища ключей. Если не указано иное, свойство в разделе хранилища ключей переопределяет свойство с тем же именем в разделе домена. Все имена свойств регистронезависимы. Поддерживаются следующие свойства:

keystoreType="<type>"
Тип хранилища ключей.
keystoreURI="<url>"
Местоположение хранилища ключей.
keystoreProviderName="<name>"
Имя поставщика JCE хранилища ключей.
keystorePasswordEnv="<environment-variable>"
Переменная среды, которая хранит пароль хранилища ключей. В качестве альтернативы пароли могут быть переданы методу конструктора в Map<String, ProtectionParameter>.
entryNameSeparator="<separator>"
Разделитель между префиксом имени хранилища ключей и именем записи. Если указано, он применяется ко всем записям в домене. Его значение по умолчанию — пробел.

Например, данные конфигурации для простого домена хранилища ключей, состоящего из трёх хранилищ ключей, показаны ниже:


 domain app1 {
     keystore app1-truststore
         keystoreURI="file:///app1/etc/truststore.jks";

     keystore system-truststore
         keystoreURI="${java.home}/lib/security/cacerts";

     keystore app1-keystore
         keystoreType="PKCS12"
         keystoreURI="file:///app1/etc/keystore.p12";
 };

 
С момента:
1.8

Краткое описание конструкторов

Конструктор Описание
DomainLoadStoreParameter(URI configuration, Map<String, KeyStore.ProtectionParameter> protectionParams)
Создает DomainLoadStoreParameter для домена хранилища ключей с параметрами, используемыми для защиты данных хранилища ключей.

Краткое описание методов

Модификатор и тип Метод Описание
URI getConfiguration()
Получает идентификатор для данных конфигурации домена.
KeyStore.ProtectionParameter getProtectionParameter()
Получает параметры защиты хранилища ключей для данного домена.
Map<String, KeyStore.ProtectionParameter> getProtectionParams()
Получает параметры защиты хранилища ключей для хранилищ ключей в данном домене.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

DomainLoadStoreParameter

public DomainLoadStoreParameter(URI configuration, Map<String, KeyStore.ProtectionParameter> protectionParams)
Создает DomainLoadStoreParameter для домена хранилища ключей с параметрами, используемыми для защиты данных хранилища ключей.
Параметры:
configuration - идентификатор для данных конфигурации домена. Имя целевого домена должно быть указано в фрагменте java.net.URI компонента, когда необходимо различать несколько конфигураций домена в одном и том же местоположении.
protectionParams - карта от имени хранилища ключей к параметру, используемому для защиты данных хранилища ключей. java.util.Collections.EMPTY_MAP должна использоваться, когда параметры защиты не требуются или когда они были заданы свойствами в данных конфигурации домена. Он клонируется для предотвращения последующего изменения.
Исключения:
NullPointerException - если configuration или protectionParams является null

Подробное описание методов

getConfiguration

public URI getConfiguration()
Получает идентификатор для данных конфигурации домена.
Возвращает:
идентификатор для данных конфигурации

getProtectionParams

public Map<String, KeyStore.ProtectionParameter> getProtectionParams()
Получает параметры защиты хранилища ключей для хранилищ ключей в данном домене.
Возвращает:
неизменяемую карту имён хранилищ ключей к параметрам защиты

getProtectionParameter

public KeyStore.ProtectionParameter getProtectionParameter()
Получает параметры защиты хранилища ключей для данного домена. Домены хранилищ ключей не поддерживают параметр защиты.
Определено в:
getProtectionParameter в интерфейсе KeyStore.LoadStoreParameter
Возвращает:
всегда возвращает null

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/security/DomainLoadStoreParameter.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API