java.security.cert

Класс PKIXBuilderParameters

java.lang. Объект

java.security.cert. PKIXParameters

java.security.cert. PKIXBuilderParameters

Все Реализованные Интерфейсы:

Cloneable, CertPathParameters

public class PKIXBuilderParameters
extends PKIXParameters

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

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

Инстанцировать a PKIXBuilderParameters объект, приложение должно определить одну или более пользующихся наибольшим доверием АВАРИЙ как определено алгоритмом проверки допустимости пути сертификации PKIX. Пользующийся наибольшим доверием CA может быть определен, используя одного из двух конструкторов. Приложение может вызвать PKIXBuilderParameters(Set, CertSelector), определение a Set из TrustAnchor объекты, каждый из которых идентифицирует пользующийся наибольшим доверием CA. Альтернативно, приложение может вызвать PKIXBuilderParameters(KeyStore, CertSelector), определение a KeyStore экземпляр, содержащий, доверял записям сертификата, каждую из которых рассмотрят как пользующийся наибольшим доверием CA.

Кроме того, приложение должно определить ограничения на целевой сертификат что CertPathBuilder попытается создать путь к. Ограничения определяются как a CertSelector объект. Эти ограничения должны обеспечить CertPathBuilder достаточно со многими критериями поиска, чтобы найти целевой сертификат. Минимальные критерии для X509Certificate обычно включайте подчиненное имя и/или одно или более подчиненных альтернативных имен. Если достаточно многие критерии не определяются, CertPathBuilder может бросить a 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) Устанавливает значение максимального количества не сам выпущенные промежуточные сертификаты, которые могут существовать в пути сертификации.
Строка	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 унаследованный от класса. Объект

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

Деталь конструктора

PKIXBuilderParameters

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

Создает экземпляр PKIXBuilderParameters с указанным Set из пользующейся наибольшим доверием АВАРИИ. Каждый элемент набора является a TrustAnchor.

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

Параметры:

trustAnchors - a Set из TrustAnchors

targetConstraints - a 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. Только записи keystore, которые содержат доверяемый X509Certificates рассматривают; все другие типы сертификата игнорируются.

Параметры:

keystore - a KeyStore от которого будет заполнен набор пользующейся наибольшим доверием АВАРИИ

targetConstraints - a CertSelector определение ограничений на целевой сертификат

Броски:

KeyStoreException - если keystore не был инициализирован

InvalidAlgorithmParameterException - если keystore не содержит по крайней мере одну доверяемую запись сертификата

NullPointerException - если keystore null

Деталь метода

setMaxPathLength

public void setMaxPathLength(int maxPathLength)

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

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

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

Параметры:

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

Броски:

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

См. Также:

getMaxPathLength()

getMaxPathLength

public int getMaxPathLength()

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

Возвраты:

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

См. Также:

setMaxPathLength(int)

toString

public String toString()

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

Переопределения:

toString в классе PKIXParameters

Возвраты:

отформатированная строка, описывающая параметры