Spec-Zone.ru › OpenJDK 21

Класс Certificate

java.lang.Object
java.security.cert.Certificate
Все реализуемые интерфейсы:
Serializable
Прямые известные подклассы:
X509Certificate
public abstract class Certificate extends Object implements Serializable

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

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

Сертификаты X.509, PGP и SDSI могут быть реализованы путём наследования от класса Certificate, даже если они содержат различные наборы информации и хранят/получают её по-разному.

С:
1.2
См. также:
  • X509Certificate
  • CertificateFactory
  • Сериализованная форма

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

Модификатор и тип Класс Описание
protected static class  Certificate.CertificateRep
Альтернативный Certificate класс для сериализации.

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

Certificate(String type)
Модификатор Конструктор Описание
protected
Создаёт сертификат указанного типа.

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

Модификатор и тип Метод Описание
boolean equals(Object other)
Сравнивает этот сертификат с указанным объектом на равенство.
abstract byte[] getEncoded()
Возвращает закодированную форму этого сертификата.
abstract PublicKey getPublicKey()
Получает открытый ключ из этого сертификата.
final String getType()
Возвращает тип этого сертификата.
int hashCode()
Возвращает хэш-код для этого сертификата на основе его закодированной формы.
abstract String toString()
Возвращает строковое представление этого сертификата.
abstract void verify(PublicKey key)
Проверяет, был ли этот сертификат подписан с использованием закрытого ключа, соответствующего указанному открытому ключу.
abstract void verify(PublicKey key, String sigProvider)
Проверяет, был ли этот сертификат подписан с использованием закрытого ключа, соответствующего указанному открытому ключу.
void verify(PublicKey key, Provider sigProvider)
Проверяет, был ли этот сертификат подписан с использованием закрытого ключа, соответствующего указанному открытому ключу.
protected Object writeReplace()
Заменяет Certificate на сериализацию с объектом CertificateRep, содержащим тип и закодированные байты Certificate.

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

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

Сертификат

protected Certificate(String type)
Создает сертификат указанного типа.
Параметры:
type - стандартное имя типа сертификата. См. раздел CertificateFactory в Спецификации имен алгоритмов Java Security Standard для получения информации о стандартных типах сертификатов.

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

getType

public final String getType()
Возвращает тип данного сертификата.
Возвращает:
тип данного сертификата.

equals

public boolean equals(Object other)
Сравнивает данный сертификат на равенство с указанным объектом. Если объект other является объектом instanceof Certificate, то извлекается его закодированная форма и сравнивается с закодированной формой данного сертификата.
Переопределяет:
equals в классе Object
Параметры:
other - объект, с которым необходимо сравнить данный сертификат на равенство.
Возвращает:
true, если закодированные формы двух сертификатов совпадают, иначе false.
См. также:
  • Object.hashCode()
  • HashMap

hashCode

public int hashCode()
Возвращает значение хеш-кода для данного сертификата, вычисленное по его закодированной форме.
Переопределяет:
hashCode в классе Object
Возвращает:
значение хеш-кода.
См. также:
  • Object.equals(java.lang.Object)
  • System.identityHashCode(java.lang.Object)

getEncoded

public abstract byte[] getEncoded() throws CertificateEncodingException
Возвращает закодированную форму данного сертификата. Предполагается, что каждый тип сертификата имеет только одну форму кодирования; например, сертификаты X.509 закодированы в ASN.1 DER.
Возвращает:
закодированную форму данного сертификата
Исключения:
CertificateEncodingException - если произошла ошибка кодирования.

verify

public abstract void verify(PublicKey key) throws CertificateException, NoSuchAlgorithmException, InvalidKeyException, NoSuchProviderException, SignatureException
Проверяет, был ли данный сертификат подписан с использованием закрытого ключа, соответствующего указанному открытому ключу.
Параметры:
key - открытый ключ, используемый для проверки.
Исключения:
NoSuchAlgorithmException - при использовании неподдерживаемых алгоритмов подписи.
InvalidKeyException - при некорректном ключе.
NoSuchProviderException - если нет поставщика по умолчанию.
SignatureException - при ошибках подписи.
CertificateException - при ошибках кодирования.

verify

public abstract void verify(PublicKey key, String sigProvider) throws CertificateException, NoSuchAlgorithmException, InvalidKeyException, NoSuchProviderException, SignatureException
Проверяет, был ли данный сертификат подписан с использованием закрытого ключа, соответствующего указанному открытому ключу. Этот метод использует движок проверки подписи, предоставленный указанным поставщиком.
Параметры:
key - открытый ключ, используемый для проверки.
sigProvider - имя поставщика подписи.
Исключения:
NoSuchAlgorithmException - при использовании неподдерживаемых алгоритмов подписи.
InvalidKeyException - при некорректном ключе.
NoSuchProviderException - при некорректном поставщике.
SignatureException - при ошибках подписи.
CertificateException - при ошибках кодирования.

verify

public void verify(PublicKey key, Provider sigProvider) throws CertificateException, NoSuchAlgorithmException, InvalidKeyException, SignatureException
Проверяет, был ли данный сертификат подписан с использованием закрытого ключа, соответствующего указанному открытому ключу. Этот метод использует движок проверки подписи, предоставленный указанным поставщиком. Обратите внимание, что указанный объект Provider не обязательно должен быть зарегистрирован в списке поставщиков.

Этот метод был добавлен в версию 1.8 платформы Java Standard Edition. Для сохранения обратной совместимости с существующими поставщиками услуг этот метод не может быть abstract и по умолчанию выбрасывает UnsupportedOperationException.

Параметры:
key - открытый ключ, используемый для проверки.
sigProvider - поставщик подписи.
Исключения:
NoSuchAlgorithmException - при использовании неподдерживаемых алгоритмов подписи.
InvalidKeyException - при некорректном ключе.
SignatureException - при ошибках подписи.
CertificateException - при ошибках кодирования.
UnsupportedOperationException - если метод не поддерживается
С момента:
1.8

toString

public abstract String toString()
Возвращает строковое представление данного сертификата.
Переопределяет:
toString в классе Object
Возвращает:
строковое представление данного сертификата.

getPublicKey

public abstract PublicKey getPublicKey()
Получает открытый ключ из данного сертификата.
Возвращает:
открытый ключ.

writeReplace

protected Object writeReplace() throws ObjectStreamException
Заменяет Certificate для сериализации объектом CertificateRep, содержащим тип и закодированные байты Certificate.
Возвращает:
объект CertificateRep , содержащий тип и закодированные байты Certificate
Исключения:
ObjectStreamException - если объект CertificateRep , представляющий данный Certificate, не смог быть создан
С момента:
1.3

© 1993, 2023, 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/21/docs/api/java.base/java/security/cert/Certificate.html

Spec-Zone.ru

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