Интерфейс сертификата

@Deprecated(since="1.2", forRemoval=true) public interface Certificate

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

Этот класс устарел и может быть удален в будущей версии Java SE. Он был заменен на java.security.cert.Certificate и связанные классы.

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

В частности, этот интерфейс предназначен для создания общего абстрагирования для конструкций, имеющих разные форматы, но важные общие функции. Например, разные типы сертификатов, такие как сертификаты X.509 и PGP-сертификаты, имеют общие функции сертификации (необходимость кодирования и декодирования сертификатов) и некоторые типы информации, такие как открытый ключ, субъект, которому он принадлежит, и гарант, гарантирующий, что открытый ключ принадлежит указанному субъекту. Таким образом, реализация сертификатов X.509 и реализация PGP-сертификатов могут использовать интерфейс Certificate, даже если их форматы и дополнительные типы и объемы хранимой информации различны.

Важно: Этот интерфейс полезен для каталогизации и группировки объектов, имеющих определённые общие функции. Он не имеет собственной семантики. В частности, объект Certificate не делает никаких заявлений о действительности связи. Приложение, реализующее этот интерфейс, должно проверить сертификат и убедиться в его достоверности.

Since:

1.1

См. также:

Certificate

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

Модификатор и тип	Метод	Описание
`void`	`decode(InputStream stream)`	Устаревший, для удаления: Этот элемент API может быть удален в будущей версии. Декодирует сертификат из потока ввода.
`void`	`encode(OutputStream stream)`	Устаревший, для удаления: Этот элемент API может быть удален в будущей версии. Кодирует сертификат в поток вывода в формате, который может быть декодирован методом `decode`.
`String`	`getFormat()`	Устаревший, для удаления: Этот элемент API может быть удален в будущей версии. Возвращает имя формата кодирования.
`Principal`	`getGuarantor()`	Устаревший, для удаления: Этот элемент API может быть удален в будущей версии. Возвращает гаранта сертификата, то есть субъекта, гарантирующего, что открытый ключ, связанный с этим сертификатом, принадлежит субъекту, связанному с этим сертификатом.
`Principal`	`getPrincipal()`	Устаревший, для удаления: Этот элемент API может быть удален в будущей версии. Возвращает субъекта пары "субъект-ключ", гарантируемой гарантом.
`PublicKey`	`getPublicKey()`	Устаревший, для удаления: Этот элемент API может быть удален в будущей версии. Возвращает ключ пары "субъект-ключ", гарантируемой гарантом.
`String`	`toString(boolean detailed)`	Устаревший, для удаления: Этот элемент API может быть удален в будущей версии. Возвращает строку, представляющую содержимое сертификата.

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

getGuarantor

Principal getGuarantor()

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

Возвращает гаранта сертификата, то есть субъекта, гарантирующего, что открытый ключ, связанный с этим сертификатом, принадлежит субъекту, связанному с этим сертификатом. Для сертификатов X.509 гарантом обычно является центр сертификации (например, United States Postal Service или Verisign, Inc.).

Возвращает:: гаранта, гарантировавшего связь "субъект-ключ".

getPrincipal

Principal getPrincipal()

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

Возвращает субъекта пары "субъект-ключ", гарантируемой гарантом.

Возвращает:: субъект, к которому привязан этот сертификат.

getPublicKey

PublicKey getPublicKey()

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

Возвращает ключ пары "субъект-ключ", гарантируемой гарантом.

Возвращает:: открытый ключ, который этот сертификат подтверждает, как принадлежащий конкретному субъекту.

encode

void encode(OutputStream stream) throws KeyException, IOException

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

Кодирует сертификат в поток вывода в формате, который может быть декодирован методом decode.

Параметры:

stream - поток вывода, в который нужно закодировать сертификат.

Исключения:

KeyException - если сертификат не инициализирован должным образом или отсутствуют данные и т.п.

IOException - если возникает исключение потока при попытке вывести закодированный сертификат в поток вывода.

См. также:

decode(java.io.InputStream)
getFormat()

decode

void decode(InputStream stream) throws KeyException, IOException

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

Декодирует сертификат из потока ввода. Формат должен соответствовать формату, возвращаемому методом getFormat и производимому методом encode.

Параметры:

stream - поток ввода, из которого извлекаются данные, подлежащие декодированию.

Исключения:

KeyException - если сертификат не инициализирован должным образом или отсутствуют данные и т.п.

IOException - если возникает исключение при попытке ввода закодированного сертификата из потока ввода.

См. также:

encode(java.io.OutputStream)
getFormat()

getFormat

String getFormat()

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

Возвращает имя формата кодирования. Это используется в качестве подсказки для поиска подходящего парсера. Может быть "X.509", "PGP" и т.д. Это формат, производимый и понимаемый методами encode и decode.

Возвращает:: имя формата кодирования.

toString

String toString(boolean detailed)

Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.

Возвращает строку, представляющую содержимое сертификата.

Параметры:: detailed - флаг, указывающий, нужно ли предоставлять подробную информацию о сертификате
Возвращает:: строку, представляющую содержимое сертификата

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