java.security.cert

Класс PKIXParameters

java.lang. Объект

java.security.cert. PKIXParameters

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

Cloneable, CertPathParameters

Прямые Известные Подклассы:

PKIXBuilderParameters

public class PKIXParameters
extends Object
implements CertPathParameters

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

PKIX CertPathValidator использование эти параметры, чтобы проверить a CertPath согласно сертификации PKIX соединяют алгоритм проверки допустимости каналом.

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

Однажды a PKIXParameters объект был создан, другие параметры могут быть определены (вызывая setInitialPolicies или setDate, например) и затем PKIXParameters передается наряду с CertPath быть проверенным к CertPathValidator.validate.

Любые параметры, которые не устанавливаются (или устанавливается в null) будет установлен в значение по умолчанию для того параметра. Значение по умолчанию для date параметр null, который указывает на текущее время, когда путь проверяется. Значение по умолчанию для остающихся параметров является наименее ограниченным.

Параллельный Доступ

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

С тех пор:

1.4

См. Также:

CertPathValidator

Сводка конструктора

Конструкторы

Конструктор и Описание
PKIXParameters(KeyStore keystore) Создает экземпляр PKIXParameters это заполняет набор пользующейся наибольшим доверием АВАРИИ от доверяемых записей сертификата, содержавшихся в указанном KeyStore.
PKIXParameters(Set<TrustAnchor> trustAnchors) Создает экземпляр PKIXParameters с указанным Set из пользующейся наибольшим доверием АВАРИИ.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	addCertPathChecker(PKIXCertPathChecker checker) Добавляет a PKIXCertPathChecker к списку сертификации соединяют средства проверки каналом.
void	addCertStore(CertStore store) Добавляет a CertStore до конца списка CertStores используемый в обнаружении сертификатов и CRL.
Объект	clone() Делает копию из этого PKIXParameters объект.
List<PKIXCertPathChecker>	getCertPathCheckers() Возвраты List из сертификации соединяют средства проверки каналом.
List<CertStore>	getCertStores() Возвращает неизменное List из CertStores, которые используются, чтобы найти сертификаты и CRL.
Дата	getDate() Возвращает время, в течение которого должна быть определена законность пути сертификации.
Set<String>	getInitialPolicies() Возвращает неизменное Set из начальных идентификаторов политики (строки OID), указывая, что любая из этих политик была бы приемлемой для пользователя сертификата в целях обработки пути сертификации.
boolean	getPolicyQualifiersRejected() Получает флаг PolicyQualifiersRejected.
Строка	getSigProvider() Возвращает имя провайдера подписи, или null если не набор.
CertSelector	getTargetCertConstraints() Возвращает необходимые ограничения на целевой сертификат.
Set<TrustAnchor>	getTrustAnchors() Возвращает неизменное Set из пользующейся наибольшим доверием АВАРИИ.
boolean	isAnyPolicyInhibited() Проверки, должен ли любой OID политики быть обработан, если он включается в сертификат.
boolean	isExplicitPolicyRequired() Проверки, если явная политика требуется.
boolean	isPolicyMappingInhibited() Проверки, если отображение политики запрещается.
boolean	isRevocationEnabled() Проверяет флаг RevocationEnabled.
void	setAnyPolicyInhibited(boolean val) Состояние наборов, чтобы определить, должен ли любой OID политики быть обработан, если это включается в сертификат.
void	setCertPathCheckers(List<PKIXCertPathChecker> checkers) Наборы a List из дополнительной сертификации соединяют средства проверки каналом.
void	setCertStores(List<CertStore> stores) Устанавливает список CertStores, чтобы использоваться в обнаружении сертификатов и CRL.
void	setDate(Date date) Устанавливает время, в течение которого должна быть определена законность пути сертификации.
void	setExplicitPolicyRequired(boolean val) Устанавливает флаг ExplicitPolicyRequired.
void	setInitialPolicies(Set<String> initialPolicies) Наборы Set из начальных идентификаторов политики (строки OID), указывая, что любая из этих политик была бы приемлемой для пользователя сертификата в целях обработки пути сертификации.
void	setPolicyMappingInhibited(boolean val) Устанавливает флаг PolicyMappingInhibited.
void	setPolicyQualifiersRejected(boolean qualifiersRejected) Устанавливает флаг PolicyQualifiersRejected.
void	setRevocationEnabled(boolean val) Устанавливает флаг RevocationEnabled.
void	setSigProvider(String sigProvider) Определяет имя провайдера подписи.
void	setTargetCertConstraints(CertSelector selector) Устанавливает необходимые ограничения на целевой сертификат.
void	setTrustAnchors(Set<TrustAnchor> trustAnchors) Наборы Set из пользующейся наибольшим доверием АВАРИИ.
Строка	toString() Возвращает отформатированную строку, описывающую параметры.

Методы java.lang унаследованный от класса. Объект

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

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

PKIXParameters

public PKIXParameters(Set<TrustAnchor> trustAnchors)
               throws InvalidAlgorithmParameterException

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

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

Параметры:

trustAnchors - a Set из TrustAnchors

Броски:

InvalidAlgorithmParameterException - если указанное Set пусто (trustAnchors.isEmpty() == true)

NullPointerException - если указанное Set null

ClassCastException - если любой из элементов в Set не имеют типа java.security.cert.TrustAnchor

PKIXParameters

public PKIXParameters(KeyStore keystore)
               throws KeyStoreException,
                      InvalidAlgorithmParameterException

Создает экземпляр PKIXParameters это заполняет набор пользующейся наибольшим доверием АВАРИИ от доверяемых записей сертификата, содержавшихся в указанном KeyStore. Только записи keystore, которые содержат доверяемый X509Certificates рассматриваются; все другие типы сертификата игнорируются.

Параметры:

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

Броски:

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

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

NullPointerException - если keystore null

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

getTrustAnchors

public Set<TrustAnchor> getTrustAnchors()

Возвращает неизменное Set из пользующейся наибольшим доверием АВАРИИ.

Возвраты:

неизменное Set из TrustAnchors (никогда null)

См. Также:

setTrustAnchors(java.util.Set<java.security.cert.TrustAnchor>)

setTrustAnchors

public void setTrustAnchors(Set<TrustAnchor> trustAnchors)
                     throws InvalidAlgorithmParameterException

Наборы Set из пользующейся наибольшим доверием АВАРИИ.

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

Параметры:

trustAnchors - a Set из TrustAnchors

Броски:

InvalidAlgorithmParameterException - если указанное Set пусто (trustAnchors.isEmpty() == true)

NullPointerException - если указанное Set null

ClassCastException - если какой-либо из элементов в наборе не имеет типа java.security.cert.TrustAnchor

См. Также:

getTrustAnchors()

getInitialPolicies

public Set<String> getInitialPolicies()

Возвращает неизменное Set из начальных идентификаторов политики (строки OID), указывая, что любая из этих политик была бы приемлемой для пользователя сертификата в целях обработки пути сертификации. Возвращаемое значение по умолчанию является пустым Set, который интерпретируется как то, чтобы подразумевать, что любая политика была бы приемлемой.

Возвраты:

неизменное Set из начальных OID политики в String формат, или пустое Set (допущение любой политики является приемлемым). Никогда возвраты null.

См. Также:

setInitialPolicies(java.util.Set<java.lang.String>)

setInitialPolicies

public void setInitialPolicies(Set<String> initialPolicies)

Наборы Set из начальных идентификаторов политики (строки OID), указывая, что любая из этих политик была бы приемлемой для пользователя сертификата в целях обработки пути сертификации. По умолчанию любая политика является приемлемой (то есть все политики), таким образом, пользователь, который хочет позволить любую политику как приемлемую, не должен вызвать этот метод, или может вызвать это с пустым Set (или null).

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

Параметры:

initialPolicies - a Set из начальных OID политики в String формат (или null)

Броски:

ClassCastException - если какой-либо из элементов в наборе не имеет типа String

См. Также:

getInitialPolicies()

setCertStores

public void setCertStores(List<CertStore> stores)

Устанавливает список CertStores, чтобы использоваться в обнаружении сертификатов и CRL. Может быть null, когда нет CertStores будет использоваться. Первое CertStores в списке может быть предпочтен тем, которые появляются позже.

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

Параметры:

stores - a List из CertStores (или null)

Броски:

ClassCastException - если какой-либо из элементов в списке не имеет типа java.security.cert.CertStore

См. Также:

getCertStores()

addCertStore

public void addCertStore(CertStore store)

Добавляет a CertStore до конца списка CertStores используемый в обнаружении сертификатов и CRL.

Параметры:

store - CertStore добавить. Если null, хранилище игнорируется (не добавленный к списку).

getCertStores

public List<CertStore> getCertStores()

Возвращает неизменное List из CertStores, которые используются, чтобы найти сертификаты и CRL.

Возвраты:

неизменное List из CertStores (может быть пустым, но никогда null)

См. Также:

setCertStores(java.util.List<java.security.cert.CertStore>)

setRevocationEnabled

public void setRevocationEnabled(boolean val)

Устанавливает флаг RevocationEnabled. Если этот флаг будет истиной, то механизм проверки аннулирования по умолчанию базового поставщика услуг PKIX будет использоваться. Если этот флаг будет ложью, то механизм проверки аннулирования по умолчанию будет отключен (не используемый).

Когда a PKIXParameters объект создается, этот флаг устанавливается в истину. Эта установка отражает наиболее распространенную стратегию проверки аннулирования, так как каждый поставщик услуг должен поддерживать проверку аннулирования, чтобы быть PKIX совместимый. Сложные приложения должны установить этот флаг в ложь, когда это не практично, чтобы использовать механизм проверки аннулирования поставщика услуг PKIX по умолчанию или когда альтернативным механизмом проверки аннулирования нужно заменить (также вызывая addCertPathChecker или setCertPathCheckers методы).

Параметры:

val - новое значение флага RevocationEnabled

isRevocationEnabled

public boolean isRevocationEnabled()

Проверяет флаг RevocationEnabled. Если этот флаг будет истиной, то механизм проверки аннулирования по умолчанию базового поставщика услуг PKIX будет использоваться. Если этот флаг будет ложью, то механизм проверки аннулирования по умолчанию будет отключен (не используемый). См. setRevocationEnabled метод для большего количества деталей об установке значения этого флага.

Возвраты:

текущая стоимость флага RevocationEnabled

setExplicitPolicyRequired

public void setExplicitPolicyRequired(boolean val)

Устанавливает флаг ExplicitPolicyRequired. Если этот флаг является истиной, приемлемая политика должна быть явно идентифицирована в каждом сертификате. По умолчанию флаг ExplicitPolicyRequired является ложью.

Параметры:

val - true если явная политика состоит в том, чтобы требоваться, false иначе

isExplicitPolicyRequired

public boolean isExplicitPolicyRequired()

Проверки, если явная политика требуется. Если этот флаг является истиной, приемлемая политика должна быть явно идентифицирована в каждом сертификате. По умолчанию флаг ExplicitPolicyRequired является ложью.

Возвраты:

true если явная политика требуется, false иначе

setPolicyMappingInhibited

public void setPolicyMappingInhibited(boolean val)

Устанавливает флаг PolicyMappingInhibited. Если этот флаг является истиной, отображение политики запрещается. По умолчанию отображение политики не запрещается (флаг является ложью).

Параметры:

val - true если отображение политики должно быть запрещено, false иначе

isPolicyMappingInhibited

public boolean isPolicyMappingInhibited()

Проверки, если отображение политики запрещается. Если этот флаг является истиной, отображение политики запрещается. По умолчанию отображение политики не запрещается (флаг является ложью).

Возвраты:

истина, если отображение политики запрещается, ложь иначе

setAnyPolicyInhibited

public void setAnyPolicyInhibited(boolean val)

Состояние наборов, чтобы определить, должен ли любой OID политики быть обработан, если это включается в сертификат. По умолчанию любой OID политики не запрещается (isAnyPolicyInhibited() возвраты false).

Параметры:

val - true если любой OID политики должен быть запрещен, false иначе

isAnyPolicyInhibited

public boolean isAnyPolicyInhibited()

Проверки, должен ли любой OID политики быть обработан, если он включается в сертификат.

Возвраты:

true если любой OID политики запрещается, false иначе

setPolicyQualifiersRejected

public void setPolicyQualifiersRejected(boolean qualifiersRejected)

Устанавливает флаг PolicyQualifiersRejected. Если этот флаг является истиной, отклоняются сертификаты, которые включают спецификаторы политики в расширение политик сертификата, которое отмечается критическое. Если флаг является ложью, сертификаты не отклоняются на этой основе.

Когда a PKIXParameters объект создается, этот флаг устанавливается в истину. Эта установка отражает наиболее распространенное (и самый простой) стратегия обработки спецификаторов политики. Приложения, которые хотят использовать более сложную политику, должны установить этот флаг в ложь.

Отметьте, что алгоритм проверки допустимости пути сертификации PKIX определяет, что любой спецификатор политики в расширении политик сертификата, которое отмечается критическое, должен быть обработан и проверен. Иначе путь сертификации должен быть отклонен. Если флаг policyQualifiersRejected устанавливается в ложь, это до приложения, чтобы проверить всех спецификаторов политики этим способом, чтобы быть PKIX совместимый.

Параметры:

qualifiersRejected - новое значение флага PolicyQualifiersRejected

См. Также:

getPolicyQualifiersRejected(), PolicyQualifierInfo

getPolicyQualifiersRejected

public boolean getPolicyQualifiersRejected()

Получает флаг PolicyQualifiersRejected. Если этот флаг является истиной, отклоняются сертификаты, которые включают спецификаторы политики в расширение политик сертификата, которое отмечается критическое. Если флаг является ложью, сертификаты не отклоняются на этой основе.

Когда a PKIXParameters объект создается, этот флаг устанавливается в истину. Эта установка отражает наиболее распространенное (и самый простой) стратегия обработки спецификаторов политики. Приложения, которые хотят использовать более сложную политику, должны установить этот флаг в ложь.

Возвраты:

текущая стоимость флага PolicyQualifiersRejected

См. Также:

setPolicyQualifiersRejected(boolean)

getDate

public Date getDate()

Возвращает время, в течение которого должна быть определена законность пути сертификации. Если null, текущее время используется.

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

Возвраты:

Date, или null если не набор

См. Также:

setDate(java.util.Date)

setDate

public void setDate(Date date)

Устанавливает время, в течение которого должна быть определена законность пути сертификации. Если null, текущее время используется.

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

Параметры:

date - Date, или null в течение текущего времени

См. Также:

getDate()

setCertPathCheckers

public void setCertPathCheckers(List<PKIXCertPathChecker> checkers)

Наборы a List из дополнительной сертификации соединяют средства проверки каналом. Если указанное List содержит объект, который не является a PKIXCertPathChecker, это игнорируется.

Каждый PKIXCertPathChecker указанные реализации дополнительные проверки на сертификате. Как правило, они - проверки, чтобы обработать и проверить частные расширения, содержавшиеся в сертификатах. Каждый PKIXCertPathChecker должен быть инстанцирован с любыми параметрами инициализации, должен был выполнить проверку.

Этот метод позволяет сложным приложениям расширять PKIX CertPathValidator или CertPathBuilder. Каждый из указанных PKIXCertPathCheckers вызовет, поочередно, PKIX CertPathValidator или CertPathBuilder для каждого сертификата, обработанного или проверенного.

Независимо от ли они дополнительные PKIXCertPathCheckers устанавливаются, PKIX CertPathValidator или CertPathBuilder должен выполнить все необходимые PKIX, проверяет каждый сертификат. Одно исключение к этому правилу - то, если флаг RevocationEnabled устанавливается в ложь (см. setRevocationEnabled метод).

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

Параметры:

checkers - a List из PKIXCertPathCheckers. Может быть null, когда никакие дополнительные средства проверки не будут использоваться.

Броски:

ClassCastException - если какой-либо из элементов в списке не имеет типа java.security.cert.PKIXCertPathChecker

См. Также:

getCertPathCheckers()

getCertPathCheckers

public List<PKIXCertPathChecker> getCertPathCheckers()

Возвраты List из сертификации соединяют средства проверки каналом. Возвращенный List является неизменным, и каждый PKIXCertPathChecker в List клонируется, чтобы защитить от последующих модификаций.

Возвраты:

неизменное List из PKIXCertPathCheckers (может быть пустым, но нет null)

См. Также:

setCertPathCheckers(java.util.List<java.security.cert.PKIXCertPathChecker>)

addCertPathChecker

public void addCertPathChecker(PKIXCertPathChecker checker)

Добавляет a PKIXCertPathChecker к списку сертификации соединяют средства проверки каналом. См. setCertPathCheckers метод для большего количества деталей.

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

Параметры:

checker - a PKIXCertPathChecker добавить к списку проверок. Если null, средство проверки игнорируется (не добавленный к списку).

getSigProvider

public String getSigProvider()

Возвращает имя провайдера подписи, или null если не набор.

Возвраты:

имя провайдера подписи (или null)

См. Также:

setSigProvider(java.lang.String)

setSigProvider

public void setSigProvider(String sigProvider)

Определяет имя провайдера подписи. Указанный провайдер будет предпочтен, создавая Signature объекты. Если null или не набор, первый провайдер нашел, что поддержка алгоритма будет использоваться.

Параметры:

sigProvider - имя провайдера подписи (или null)

См. Также:

getSigProvider()

getTargetCertConstraints

public CertSelector getTargetCertConstraints()

Возвращает необходимые ограничения на целевой сертификат. Ограничения возвращаются как экземпляр CertSelector. Если null, никакие ограничения не определяются.

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

Возвраты:

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

См. Также:

setTargetCertConstraints(java.security.cert.CertSelector)

setTargetCertConstraints

public void setTargetCertConstraints(CertSelector selector)

Устанавливает необходимые ограничения на целевой сертификат. Ограничения определяются как экземпляр CertSelector. Если null, никакие ограничения не определяются.

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

Параметры:

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

См. Также:

getTargetCertConstraints()

клон

public Object clone()

Делает копию из этого PKIXParameters объект. Изменения к копии не будут влиять на оригинал и наоборот.

Определенный:

clone в интерфейсе CertPathParameters

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

clone в классе Object

Возвраты:

копия этого PKIXParameters объект

См. Также:

Cloneable

toString

public String toString()

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

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

toString в классе Object

Возвраты:

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