Класс CertPathValidator
public class CertPathValidator extends Object
Этот класс использует архитектуру, основанную на поставщиках. Для создания CertPathValidator, вызовите один из статических getInstance методов, передав имя алгоритма CertPathValidator и необязательно имя поставщика.
После создания объекта CertPathValidator, его можно использовать для проверки цепочек сертификатов, вызвав метод validate и передав ему CertPath для проверки и набор параметров, специфичных для алгоритма. В случае успеха результат возвращается в объекте, реализующем интерфейс CertPathValidatorResult.
Метод getRevocationChecker() позволяет приложению указать дополнительные параметры и опции, специфичные для алгоритма, используемые CertPathValidator при проверке статуса отзыва сертификатов. Вот пример, демонстрирующий его использование с алгоритмом PKIX:
CertPathValidator cpv = CertPathValidator.getInstance("PKIX");
PKIXRevocationChecker rc = (PKIXRevocationChecker)cpv.getRevocationChecker();
rc.setOptions(EnumSet.of(Option.SOFT_FAIL));
params.addCertPathChecker(rc);
CertPathValidatorResult cpvr = cpv.validate(path, params);
Каждая реализация платформы Java обязана поддерживать следующие стандартные CertPathValidator алгоритмы:
PKIX
Доступность для нескольких потоков
Статические методы этого класса гарантированно являются потокобезопасными. Несколько потоков могут одновременно вызывать статические методы, определенные в этом классе, без каких-либо негативных последствий.
Однако это не относится к методам, не являющимся статическими, определёнными в этом классе. Если не указано иное поставщиком, потоки, которым нужно одновременно обращаться к одному экземпляру CertPathValidator , должны синхронизироваться между собой и обеспечить необходимые блокировки. Несколько потоков, манипулирующих различными экземплярами CertPathValidator , не требуют синхронизации.
- С тех пор как:
- 1.4
- См. также:
Краткое описание конструкторов
| Модификатор | Конструктор | Описание |
|---|---|---|
protected |
Создаёт объект CertPathValidator заданного алгоритма и инкапсулирует в нём реализацию заданного поставщика (объект SPI). |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
final String |
getAlgorithm() |
Возвращает имя алгоритма этого CertPathValidator. |
static final String |
getDefaultType() |
Возвращает тип по умолчанию CertPathValidator , как указано в свойстве безопасности certpathvalidator.type, или строку "PKIX", если такого свойства нет. |
static CertPathValidator |
getInstance |
Возвращает объект CertPathValidator , реализующий указанный алгоритм. |
static CertPathValidator |
getInstance |
Возвращает объект CertPathValidator , реализующий указанный алгоритм. |
static CertPathValidator |
getInstance |
Возвращает объект CertPathValidator , реализующий указанный алгоритм. |
final Provider |
getProvider() |
Возвращает Provider этого CertPathValidator. |
final CertPathChecker |
getRevocationChecker() |
Возвращает CertPathChecker, которое использует реализация инкапсулированного CertPathValidatorSpi для проверки статуса отзыва сертификатов. |
final CertPathValidatorResult |
validate |
Проверяет указанную цепочку сертификатов с использованием набора параметров заданного алгоритма. |
Подробное описание конструкторов
CertPathValidator
protected CertPathValidator(CertPathValidatorSpi validatorSpi, Provider provider, String algorithm)
CertPathValidator заданного алгоритма и инкапсулирует в нём заданную реализацию поставщика (объект SPI).- Параметры:
-
validatorSpi- реализация поставщика -
provider- поставщик -
algorithm- имя алгоритма
Подробное описание методов
getInstance
public static CertPathValidator getInstance(String algorithm) throws NoSuchAlgorithmException
CertPathValidator, реализующий указанный алгоритм. Этот метод проходит по списку зарегистрированных поставщиков безопасности, начиная с наиболее предпочтительного. Возвращается новый объект CertPathValidator, инкапсулирующий реализацию CertPathValidatorSpi из первого поставщика, поддерживающего указанный алгоритм.
Обратите внимание, что список зарегистрированных поставщиков можно получить с помощью метода Security.getProviders().
- Примечание о реализации:
- Реализация JDK дополнительно использует свойство
jdk.security.provider.preferredSecurityдля определения предпочтительного порядка поставщиков для указанного алгоритма. Это может отличаться от порядка поставщиков, возвращаемого методомSecurity.getProviders(). - Параметры:
-
algorithm- имя запрашиваемого алгоритмаCertPathValidator. См. раздел CertPathValidator в Спецификации имен стандартных алгоритмов Java Security для получения информации о стандартных именах алгоритмов. - Возвращает:
- объект
CertPathValidator, реализующий указанный алгоритм - Исключения:
-
NoSuchAlgorithmException- если ни один поставщикProviderне поддерживает реализациюCertPathValidatorSpiдля указанного алгоритма -
NullPointerException- еслиalgorithmявляетсяnull - См. также:
getInstance
public static CertPathValidator getInstance(String algorithm, String provider) throws NoSuchAlgorithmException, NoSuchProviderException
CertPathValidator, реализующий указанный алгоритм. Возвращается новый объект CertPathValidator, инкапсулирующий реализацию CertPathValidatorSpi от указанного поставщика. Указанный поставщик должен быть зарегистрирован в списке поставщиков безопасности.
Обратите внимание, что список зарегистрированных поставщиков можно получить с помощью метода Security.getProviders().
- Параметры:
-
algorithm- имя запрашиваемого алгоритмаCertPathValidator. См. раздел CertPathValidator в Спецификации имен стандартных алгоритмов Java Security для получения информации о стандартных именах алгоритмов. -
provider- имя поставщика. - Возвращает:
- объект
CertPathValidator, реализующий указанный алгоритм - Исключения:
-
IllegalArgumentException- если поставщикproviderявляетсяnullили пустым -
NoSuchAlgorithmException- если реализацияCertPathValidatorSpiдля указанного алгоритма недоступна от указанного поставщика -
NoSuchProviderException- если указанный поставщик не зарегистрирован в списке поставщиков безопасности -
NullPointerException- еслиalgorithmявляетсяnull - См. также:
getInstance
public static CertPathValidator getInstance(String algorithm, Provider provider) throws NoSuchAlgorithmException
CertPathValidator, реализующий указанный алгоритм. Возвращается новый объект CertPathValidator, инкапсулирующий реализацию CertPathValidatorSpi из указанного объекта Provider. Обратите внимание, что указанный объект Provider не обязательно должен быть зарегистрирован в списке поставщиков.
- Параметры:
-
algorithm- имя запрашиваемого алгоритмаCertPathValidator. См. раздел CertPathValidator в Спецификации имен стандартных алгоритмов Java Security для получения информации о стандартных именах алгоритмов. -
provider- поставщик. - Возвращает:
- объект
CertPathValidator, реализующий указанный алгоритм - Исключения:
-
IllegalArgumentException- еслиproviderявляетсяnull -
NoSuchAlgorithmException- если реализацияCertPathValidatorSpiдля указанного алгоритма недоступна от указанного объекта Provider -
NullPointerException- еслиalgorithmявляетсяnull - См. также:
getProvider
public final Provider getProvider()
CertPathValidator. - Возвращает:
- поставщик этого объекта
CertPathValidator
getAlgorithm
public final String getAlgorithm()
CertPathValidator. - Возвращает:
- имя алгоритма этого объекта
CertPathValidator
validate
public final CertPathValidatorResult validate(CertPath certPath, CertPathParameters params) throws CertPathValidatorException, InvalidAlgorithmParameterException
Указанная CertPath должна быть типа, поддерживаемого алгоритмом проверки, в противном случае будет выброшено исключение InvalidAlgorithmParameterException. Например, CertPathValidator, реализующий алгоритм PKIX, проверяет объекты типа X.509.
- Параметры:
-
certPath- проверяемаяCertPath -
params- параметры алгоритма - Возвращает:
- результат алгоритма проверки
- Исключения:
-
CertPathValidatorException- еслиCertPathне прошла проверку -
InvalidAlgorithmParameterException- если указанные параметры или тип указаннойCertPathнеподходящие для этого объектаCertPathValidator
getDefaultType
public static final String getDefaultType()
CertPathValidator по умолчанию, указанный свойством безопасности certpathvalidator.type, или строку "PKIX", если такое свойство не существует. Тип CertPathValidator по умолчанию может использоваться приложениями, которые не хотят использовать жёстко заданный тип при вызове одного из методов getInstance, и хотят предоставить тип по умолчанию в случае, если пользователь не указывает свой собственный.
Тип CertPathValidator по умолчанию может быть изменён путём установки значения свойства безопасности certpathvalidator.type на желаемый тип.
- Возвращает:
- тип
CertPathValidatorпо умолчанию, указанный свойством безопасностиcertpathvalidator.type, или строку "PKIX", если такое свойство не существует. - См. также:
getRevocationChecker
public final CertPathChecker getRevocationChecker()
CertPathChecker, который использует инкапсулированная реализация CertPathValidatorSpi для проверки статуса отзыва сертификатов. Реализация PKIX возвращает объекты типа PKIXRevocationChecker. Каждый вызов этого метода возвращает новый экземпляр CertPathChecker. Основная цель этого метода — позволить вызывающим сторонам указывать дополнительные входные параметры и опции, специфичные для проверки отзыва. См. описание класса для примера.
- Возвращает:
- объект
CertPathChecker - Исключения:
-
UnsupportedOperationException- если поставщик сервиса не поддерживает этот метод - С тех пор:
- 1.8
© 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/CertPathValidator.html