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