Класс PKIXBuilderParameters

java.lang.Object

java.security.cert.PKIXParameters

java.security.cert.PKIXBuilderParameters

Все реализуемые интерфейсы:: Cloneable, CertPathParameters

public class PKIXBuilderParameters extends PKIXParameters

Параметры, используемые в качестве входных данных для алгоритма PKIX CertPathBuilder.

Алгоритм PKIX CertPathBuilder использует эти параметры для build пути сертификации, который был проверен в соответствии с алгоритмом проверки пути сертификации PKIX.

Для создания объекта PKIXBuilderParameters приложение должно указать один или несколько наиболее надёжных ЦС, как определено алгоритмом проверки пути сертификации PKIX. Наиболее надёжный ЦС можно указать, используя один из двух конструкторов. Приложение может вызвать PKIXBuilderParameters(Set, CertSelector), указав набор Set объектов TrustAnchor, каждый из которых идентифицирует наиболее надёжный ЦС. В качестве альтернативы приложение может вызвать PKIXBuilderParameters(KeyStore, CertSelector), указав экземпляр KeyStore, содержащий записи доверенных сертификатов, каждый из которых будет рассматриваться как наиболее надёжный ЦС.

Кроме того, приложение должно указать ограничения на целевой сертификат, к которому CertPathBuilder будет пытаться построить путь. Ограничения задаются как объект CertSelector. Эти ограничения должны предоставить CertPathBuilder достаточные критерии поиска целевого сертификата. Минимальные критерии для X509Certificate обычно включают имя субъекта и/или один или несколько альтернативных имён субъекта. Если не указаны достаточные критерии, CertPathBuilder может выбросить исключение CertPathBuilderException.

Одновременный доступ

Если не указано иное, методы, определённые в этом классе, не являются потокобезопасными. Несколько потоков, которым требуется одновременный доступ к одному объекту, должны синхронизироваться между собой и обеспечить необходимую блокировку. Несколько потоков, манипулирующих разными объектами, синхронизироваться не должны.

С тех пор:

1.4

См. также:

CertPathBuilder

Краткое описание конструкторов

Конструктор	Описание
`PKIXBuilderParameters(KeyStore keystore, CertSelector targetConstraints)`	Создаёт экземпляр `PKIXBuilderParameters`, заполняющий набор наиболее надёжных ЦС из записей доверенных сертификатов, содержащихся в указанном `KeyStore`.
`PKIXBuilderParameters(Set<TrustAnchor> trustAnchors, CertSelector targetConstraints)`	Создаёт экземпляр `PKIXBuilderParameters` с указанным `Set` набора наиболее надёжных ЦС.

Краткое описание методов

Модификатор и тип	Метод	Описание
`int`	`getMaxPathLength()`	Возвращает значение максимального числа промежуточных несамовыпущенных сертификатов, которые могут существовать в пути сертификации.
`void`	`setMaxPathLength(int maxPathLength)`	Устанавливает значение максимального числа несамовыпущенных промежуточных сертификатов, которые могут существовать в пути сертификации.
`String`	`toString()`	Возвращает отформатированную строку, описывающую параметры.

Методы, объявленные в классе java.security.cert.PKIXParameters

addCertPathChecker, addCertStore, clone, getCertPathCheckers, getCertStores, getDate, getInitialPolicies, getPolicyQualifiersRejected, getSigProvider, getTargetCertConstraints, getTrustAnchors, isAnyPolicyInhibited, isExplicitPolicyRequired, isPolicyMappingInhibited, isRevocationEnabled, setAnyPolicyInhibited, setCertPathCheckers, setCertStores, setDate, setExplicitPolicyRequired, setInitialPolicies, setPolicyMappingInhibited, setPolicyQualifiersRejected, setRevocationEnabled, setSigProvider, setTargetCertConstraints, setTrustAnchors

Методы, объявленные в классе java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Подробное описание конструкторов

PKIXBuilderParameters

public PKIXBuilderParameters(Set<TrustAnchor> trustAnchors, CertSelector targetConstraints) throws InvalidAlgorithmParameterException

Создаёт экземпляр PKIXBuilderParameters с указанным Set набора наиболее надёжных ЦС. Каждый элемент набора — TrustAnchor.

Обратите внимание, что набор Set копируется для защиты от последующих изменений.

Параметры:: trustAnchors - набор Set TrustAnchor; targetConstraints - объект CertSelector, определяющий ограничения на целевой сертификат
Исключения:: InvalidAlgorithmParameterException - если набор trustAnchors пуст (trustAnchors.isEmpty() == true); NullPointerException - если объект trustAnchors равен null; ClassCastException - если любой из элементов набора trustAnchors не является объектом java.security.cert.TrustAnchor

PKIXBuilderParameters

public PKIXBuilderParameters(KeyStore keystore, CertSelector targetConstraints) throws KeyStoreException, InvalidAlgorithmParameterException

Создаёт экземпляр PKIXBuilderParameters, заполняющий набор наиболее надёжных ЦС из записей доверенных сертификатов, содержащихся в указанном KeyStore. Только записи хранилища ключей, содержащие доверенные X509Certificateы, рассматриваются; все другие типы сертификатов игнорируются.

Параметры:: keystore - хранилище ключей, из которого будет заполнен набор наиболее надёжных ЦС; targetConstraints - объект CertSelector, определяющий ограничения на целевой сертификат
Исключения:: KeyStoreException - если хранилище ключей keystore не было инициализировано; InvalidAlgorithmParameterException - если хранилище ключей keystore не содержит хотя бы одну запись доверенного сертификата; NullPointerException - если объект keystore равен null

Подробное описание методов

setMaxPathLength

public void setMaxPathLength(int maxPathLength)

Устанавливает значение максимального числа несамовыпущенных промежуточных сертификатов, которые могут существовать в пути сертификации. Сертификат является самовыпущенным, если DN в полях субъекта и эмитента идентичны и не пусты. Обратите внимание, что последний сертификат в пути сертификации не является промежуточным сертификатом и не входит в это ограничение. Обычно последний сертификат является сертификатом конечного пользователя, но может быть и сертификатом ЦС. Экземпляр PKIX CertPathBuilder не должен строить пути, длина которых превышает указанную.

Значение 0 означает, что путь может содержать только один сертификат. Значение -1 означает, что длина пути не ограничена (т.е. нет максимального значения). По умолчанию максимальная длина пути, если не указана, равна 5. Установка значения меньше -1 приведёт к исключению.

Если любой из сертификатов ЦС содержит BasicConstraintsExtension, значение поля pathLenConstraint расширения переопределяет параметр максимальной длины пути всякий раз, когда результатом является путь сертификации меньшей длины.

Параметры:

maxPathLength - максимальное число несамовыпущенных промежуточных сертификатов, которые могут существовать в пути сертификации

Исключения:

InvalidParameterException - если maxPathLength установлено значением меньше -1

См. также:

getMaxPathLength()

getMaxPathLength

public int getMaxPathLength()

Возвращает значение максимального числа промежуточных несамовыпущенных сертификатов, которые могут существовать в пути сертификации. Подробности см. в методе setMaxPathLength(int).

Возвращает:

максимальное число несамовыпущенных промежуточных сертификатов, которые могут существовать в пути сертификации, или -1, если ограничений нет

См. также:

setMaxPathLength(int)

toString

public String toString()

Возвращает отформатированную строку, описывающую параметры.

Переопределяет:: toString в классе PKIXParameters
Возвращает:: отформатированную строку, описывающую параметры

© 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/cert/PKIXBuilderParameters.html