Spec-Zone.ru › OpenJDK 17

Класс PKIXCertPathChecker

java.lang.Object
java.security.cert.PKIXCertPathChecker
Все реализованные интерфейсы:
Cloneable, CertPathChecker
Прямые известные подклассы:
PKIXRevocationChecker
public abstract class PKIXCertPathChecker extends Object implements CertPathChecker, Cloneable
Абстрактный класс, выполняющий одну или несколько проверок на X509Certificate.

Можно создать конкретную реализацию класса PKIXCertPathChecker, чтобы расширить алгоритм проверки цепочки сертификатов PKIX. Например, реализация может проверять и обрабатывать критический частный расширенный элемент каждого сертификата в цепочке сертификатов.

Экземпляры класса PKIXCertPathChecker передаются в качестве параметров с помощью методов setCertPathCheckers или addCertPathChecker класса PKIXParameters и PKIXBuilderParameters. Каждый из методов check этих экземпляров будет вызываться по очереди для каждого сертификата, обрабатываемого реализацией PKIX CertPathValidator или CertPathBuilder.

Класс PKIXCertPathChecker может вызываться несколько раз для последовательных сертификатов в цепочке сертификатов. Ожидается, что конкретные подклассы будут сохранять все внутреннее состояние, которое может потребоваться для проверки последовательных сертификатов. Метод init используется для инициализации внутреннего состояния проверяющего, чтобы можно было проверить сертификаты новой цепочки сертификатов. Для реализации со состоянием обязательно переопределить метод clone, если это необходимо, чтобы позволить реализации PKIX CertPathBuilder эффективно отслеживать назад и пытаться использовать другие пути. В таких ситуациях CertPathBuilder может восстановить предыдущие состояния проверки пути, восстанавливая клонированные PKIXCertPathChecker.

Порядок, в котором сертификаты представляются проверяющему PKIXCertPathChecker, может быть либо в прямом направлении (от целевого к наиболее доверенному ЦС) либо в обратном направлении (от наиболее доверенного ЦС к целевому). Реализация PKIXCertPathChecker обязана поддерживать обратную проверку (способность выполнять проверки, когда ей представлены сертификаты в обратном направлении), и может поддерживать прямую проверку (способность выполнять проверки, когда ей представлены сертификаты в прямом направлении). Метод isForwardCheckingSupported указывает, поддерживается ли прямая проверка.

Дополнительные входные параметры, необходимые для выполнения проверки, могут быть указаны через конструкторы конкретных реализаций этого класса.

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

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

С момента:
1.4
См. также:
  • PKIXParameters
  • PKIXBuilderParameters

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

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

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

Модификатор и тип Метод Описание
void check(Certificate cert)
Выполняет проверку(и) на указанном сертификате, используя его внутреннее состояние.
abstract void check(Certificate cert, Collection<String> unresolvedCritExts)
Выполняет проверку(и) на указанном сертификате, используя его внутреннее состояние и удаляет все критические расширения, которые он обрабатывает, из указанного набора строк OID, представляющих неразрешенные критические расширения.
Object clone()
Возвращает клон этого объекта.
abstract Set<String> getSupportedExtensions()
Возвращает неизменяемый набор расширений сертификата X.509, которые поддерживает (т. е. распознает, может обработать) этот проверяющий, или null если не поддерживаются расширения.
abstract void init(boolean forward)
Инициализирует внутреннее состояние этого проверяющего.
abstract boolean isForwardCheckingSupported()
Указывает, поддерживается ли прямая проверка.

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

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

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

PKIXCertPathChecker

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

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

init

public abstract void init(boolean forward) throws CertPathValidatorException
Инициализирует внутреннее состояние этого проверяющего.

Флаг forward указывает порядок, в котором сертификаты будут передаваться методу check (прямой или обратный). Реализация PKIXCertPathChecker обязана поддерживать обратную проверку и может поддерживать прямую проверку.

Определено в:
init в интерфейсе CertPathChecker
Параметры:
forward - порядок, в котором сертификаты представлены методу check . Если true, сертификаты представлены от целевого к наиболее доверенному ЦС (прямое направление); если false, от наиболее доверенного ЦС к целевому (обратное направление).
Исключение:
CertPathValidatorException - если этот проверяющий не может проверить сертификаты в указанном порядке; он никогда не должен выбрасываться, если флаг прямого направления ложный, так как обратная проверка должна поддерживаться

isForwardCheckingSupported

public abstract boolean isForwardCheckingSupported()
Указывает, поддерживается ли прямая проверка. Прямая проверка относится к способности проверяющего PKIXCertPathChecker выполнять свои проверки, когда сертификаты представлены методу check в прямом направлении (от целевого к наиболее доверенному ЦС).
Определено в:
isForwardCheckingSupported в интерфейсе CertPathChecker
Возвращает:
true если прямая проверка поддерживается, false в противном случае

getSupportedExtensions

public abstract Set<String> getSupportedExtensions()
Возвращает неизменяемый набор расширений сертификата X.509, которые поддерживает (т. е. распознает, может обработать) этот проверяющий, или null если не поддерживаются расширения.

Каждый элемент набора представляет собой String , представляющий идентификатор объекта (OID) поддерживаемого расширения X.509. OID представляется набором неотрицательных целых чисел, разделенных точками.

Все расширения сертификатов X.509, которые проверяющий может потенциально обработать, должны быть включены в набор.

Возвращает:
неизменяемый набор OID расширений X.509 (в формате String ), поддерживаемых этим проверяющим, или null если не поддерживаются расширения

check

public abstract void check(Certificate cert, Collection<String> unresolvedCritExts) throws CertPathValidatorException
Выполняет проверку(и) на указанном сертификате, используя его внутреннее состояние, и удаляет все критические расширения, которые он обрабатывает, из указанного набора строк OID, представляющих неразрешенные критические расширения. Сертификаты представляются в порядке, указанном методом init.
Параметры:
cert - проверяемый Certificate
unresolvedCritExts - набор строк OID, представляющих текущий набор неразрешенных критических расширений
Исключение:
CertPathValidatorException - если указанный сертификат не проходит проверку

check

public void check(Certificate cert) throws CertPathValidatorException
Выполняет проверку(и) на указанном сертификате, используя его внутреннее состояние. Сертификаты представляются в порядке, указанном методом init.

Эта реализация вызывает check(cert, java.util.Collections.<String>emptySet()).

Определено в:
check в интерфейсе CertPathChecker
Параметры:
cert - проверяемый Certificate
Исключение:
CertPathValidatorException - если указанный сертификат не проходит проверку

clone

public Object clone()
Возвращает клон этого объекта. Вызывает метод Object.clone(). Все подклассы, которые сохраняют состояние, должны поддерживать и переопределять этот метод, если необходимо.
Переопределяет:
clone в классе Object
Возвращает:
копию этого проверяющего 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/PKIXCertPathChecker.html

Spec-Zone.ru

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