Класс PKIXRevocationChecker

java.lang.Object

java.security.cert.PKIXCertPathChecker

java.security.cert.PKIXRevocationChecker

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

public abstract class PKIXRevocationChecker extends PKIXCertPathChecker

Проверка статуса отзыва сертификатов с помощью алгоритма PKIX.

Проверка статуса отзыва сертификатов осуществляется с помощью протокола Online Certificate Status Protocol (OCSP) или списков отзыва сертификатов (CRL). OCSP описан в RFC 2560 и представляет собой сетевой протокол для определения статуса сертификата. CRL – это отметенный во времени список, идентифицирующий отозванные сертификаты, алгоритм определения статуса отзыва сертификатов с использованием CRL описан в RFC 5280.

Каждый объект проверки должен быть способен проверять статус отзыва сертификатов с помощью OCSP и CRL. По умолчанию OCSP является предпочтительным механизмом проверки статуса отзыва, а CRL – резервным механизмом. Однако эта предпочтительность может быть переключена на CRL с помощью опции PREFER_CRLS. Кроме того, резервный механизм может быть отключен с помощью опции NO_FALLBACK.

Объект проверки отзыва получается путем вызова метода getRevocationChecker объекта PKIX проверки цепочки сертификатов. Дополнительные параметры и опции, специфичные для отзыва, могут быть установлены (например, с помощью метода setOcspResponder). Объект проверки отзыва добавляется в объект параметров PKIX с помощью метода addCertPathChecker или setCertPathCheckers, а затем передается вместе с проверяемой цепочкой сертификатов в метод validate объекта PKIX проверки цепочки сертификатов. В этом случае проверка отзыва будет выполняться независимо от состояния флага RevocationEnabled. Аналогично, объект проверки отзыва может быть добавлен в объект параметров для использования с объектом PKIX проверки цепочки сертификатов.

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

Любой не установленный (или установленный в значение по умолчанию) параметр будет установлен в значение по умолчанию для этого параметра.

Доступность из нескольких потоков

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

С тех пор:

1.8

См. также:

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`static enum`	`PKIXRevocationChecker.Option`	Различные опции отзыва, которые могут быть указаны для механизма проверки отзыва.

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

PKIXRevocationChecker()

Модификатор	Конструктор	Описание
`protected`	Конструктор по умолчанию.

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

Модификатор и тип	Метод	Описание
`PKIXRevocationChecker`	`clone()`	Возвращает клонированный экземпляр объекта.
`List<Extension>`	`getOcspExtensions()`	Возвращает опциональные расширения запроса OCSP.
`URI`	`getOcspResponder()`	Возвращает URI, определяющий местоположение ответчика OCSP.
`X509Certificate`	`getOcspResponderCert()`	Возвращает сертификат ответчика OCSP.
`Map<X509Certificate,byte[]>`	`getOcspResponses()`	Возвращает ответы OCSP.
`Set<PKIXRevocationChecker.Option>`	`getOptions()`	Возвращает опции отзыва.
`abstract List<CertPathValidatorException>`	`getSoftFailExceptions()`	Возвращает список исключений, игнорируемых проверяющим отзыва при установке опции `SOFT_FAIL`.
`void`	`setOcspExtensions(List<Extension> extensions)`	Устанавливает опциональные расширения запроса OCSP.
`void`	`setOcspResponder(URI uri)`	Устанавливает URI, определяющий местоположение ответчика OCSP.
`void`	`setOcspResponderCert(X509Certificate cert)`	Устанавливает сертификат ответчика OCSP.
`void`	`setOcspResponses(Map<X509Certificate,byte[]> responses)`	Устанавливает ответы OCSP.
`void`	`setOptions(Set<PKIXRevocationChecker.Option> options)`	Устанавливает опции отзыва.

Методы, унаследованные от класса java.security.cert.PKIXCertPathChecker

check, check, getSupportedExtensions, init, isForwardCheckingSupported

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

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

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

PKIXRevocationChecker

protected PKIXRevocationChecker()

Конструктор по умолчанию.

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

setOcspResponder

public void setOcspResponder(URI uri)

Устанавливает URI, определяющий расположение ответчика OCSP. Это переопределяет свойство безопасности ocsp.responderURL и любого ответчика, указанного в расширении доступа к информации об авторитете сертификата, как определено в RFC 5280.

Параметры:: uri - URI ответчика

getOcspResponder

public URI getOcspResponder()

Возвращает URI, определяющий расположение ответчика OCSP. Это переопределяет свойство безопасности ocsp.responderURL. Если этот параметр или свойство ocsp.responderURL не установлены, расположение определяется из расширения доступа к информации об авторитете сертификата, как определено в RFC 5280.

Возвращает:: URI ответчика или null, если не установлен

setOcspResponderCert

public void setOcspResponderCert(X509Certificate cert)

Устанавливает сертификат ответчика OCSP. Это переопределяет свойства безопасности ocsp.responderCertSubjectName, ocsp.responderCertIssuerName, и ocsp.responderCertSerialNumber.

Параметры:: cert - сертификат ответчика

getOcspResponderCert

public X509Certificate getOcspResponderCert()

Возвращает сертификат ответчика OCSP. Это переопределяет свойства безопасности ocsp.responderCertSubjectName, ocsp.responderCertIssuerName, и ocsp.responderCertSerialNumber. Если этот параметр или указанные выше свойства не установлены, сертификат ответчика определяется в соответствии с RFC 2560.

Возвращает:: сертификат ответчика, или null, если не установлен

setOcspExtensions

public void setOcspExtensions(List<Extension> extensions)

Устанавливает необязательные расширения запроса OCSP.

Параметры:: extensions - список расширений. Список копируется для защиты от последующих изменений.

getOcspExtensions

public List<Extension> getOcspExtensions()

Возвращает необязательные расширения запроса OCSP.

Возвращает:: неизменяемый список расширений. Список пустой, если расширения не указаны.

setOcspResponses

public void setOcspResponses(Map<X509Certificate,byte[]> responses)

Устанавливает ответы OCSP. Эти ответы используются для определения статуса отзыва указанных сертификатов при использовании OCSP.

Параметры:: responses - карта ответов OCSP. Каждый ключ - X509Certificate, отображающий соответствующий закодированный в DER ответ OCSP для данного сертификата. Выполняется глубокая копия карты для защиты от последующих изменений.

getOcspResponses

public Map<X509Certificate,byte[]> getOcspResponses()

Возвращает ответы OCSP. Эти ответы используются для определения статуса отзыва указанных сертификатов при использовании OCSP.

Возвращает:: карта ответов OCSP. Каждый ключ - X509Certificate, отображающий соответствующий закодированный в DER ответ OCSP для данного сертификата. Возвращается глубокая копия карты для защиты от последующих изменений. Возвращает пустую карту, если ответы не указаны.

setOptions

public void setOptions(Set<PKIXRevocationChecker.Option> options)

Устанавливает параметры отзыва.

Параметры:: options - набор параметров отзыва. Набор копируется для защиты от последующих изменений.

getOptions

public Set<PKIXRevocationChecker.Option> getOptions()

Возвращает параметры отзыва.

Возвращает:: неизменяемый набор параметров отзыва. Набор пустой, если параметры не указаны.

getSoftFailExceptions

public abstract List<CertPathValidatorException> getSoftFailExceptions()

Возвращает список исключений, которые игнорируются проверяющим отзыва, когда установлен параметр SOFT_FAIL. Список очищается каждый раз, когда вызывается init. Список упорядочен по возрастанию индекса сертификата, возвращаемого методом getIndex каждого элемента.

Реализация PKIXRevocationChecker отвечает за добавление игнорируемых исключений в список.

Возвращает:: неизменяемый список игнорируемых исключений. Список пустой, если исключения не были проигнорированы.

clone

public PKIXRevocationChecker clone()

Описание скопировано из класса: PKIXCertPathChecker

Возвращает клонированную копию этого объекта. Вызывает метод Object.clone() . Все подклассы, сохраняющие состояние, должны поддерживать и переопределять этот метод при необходимости.

Переопределяет:

clone в классе PKIXCertPathChecker

Возвращает:

копию этого PKIXCertPathChecker

См. также:

Cloneable

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