Класс 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";
};