Spec-Zone.ru › OpenJDK 21

Класс 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, 2023, 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/21/docs/api/java.base/java/security/DomainLoadStoreParameter.html

Spec-Zone.ru

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