Spec-Zone.ru › OpenJDK 17

Класс 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, 2021, 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://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/security/DomainLoadStoreParameter.html

Spec-Zone.ru

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