Класс PKIXCertPathChecker

public abstract class PKIXCertPathChecker
extends Object
implements CertPathChecker, Cloneable

Абстрактный класс, выполняющий одну или несколько проверок на X509Certificate.

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

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

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

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

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

Доступ к данным из нескольких потоков

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

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

PKIXCertPathChecker

protected PKIXCertPathChecker()

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

Методы

init

public abstract void init(boolean forward)
                   throws CertPathValidatorException

Указано в:

init в интерфейсе CertPathChecker

Параметры:

forward - порядок представления сертификатов методу check. Если true, сертификаты представляются от целевого к наиболее доверенному удостоверяющему центру (прямой); если false, от наиболее доверенного удостоверяющего центра к целевому (обратный).

Исключения:

CertPathValidatorException - если этот PKIXCertPathChecker не может проверить сертификаты в указанном порядке; он никогда не должен выбрасываться, если флаг forward false, так как обратная проверка должна поддерживаться

isForwardCheckingSupported

public abstract boolean isForwardCheckingSupported()

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

Указано в:

isForwardCheckingSupported в интерфейсе CertPathChecker

Возвращает:

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

getSupportedExtensions

public abstract Set<String> getSupportedExtensions()

Возвращает:

неизменяемый набор OID расширений X.509 (в формате String ), поддерживаемых этим PKIXCertPathChecker, или 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

Указано в:

check в интерфейсе CertPathChecker

Параметры:

cert - проверяемый Certificate

Исключения:

CertPathValidatorException - если указанный сертификат не проходит проверку

clone

public Object clone()

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

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

clone в классе Object

Возвращает:

копию этого PKIXCertPathChecker

См. также:

Cloneable