Класс DomainLoadStoreParameter

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";
 };

Конструкторы

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