Интерфейс Key

public interface Key
extends Serializable

Интерфейс Key является основным интерфейсом для всех ключей. Он определяет функциональность, общую для всех объектов ключей. Все ключи имеют три характеристики:

• Алгоритм

  Это алгоритм ключа. Алгоритм ключа обычно представляет собой алгоритм шифрования или асимметричной операции (такой как DSA или RSA), который будет работать с этими алгоритмами и связанными алгоритмами (такими как MD5 с RSA, SHA-1 с RSA, Raw DSA и т.д.). Название алгоритма ключа получается с помощью метода getAlgorithm.

• Кодированная форма

  Это внешняя кодированная форма ключа, используемая, когда требуется стандартное представление ключа за пределами виртуальной машины Java, например, при передаче ключа другой стороне. Ключ кодируется в соответствии со стандартным форматом (например, X.509 SubjectPublicKeyInfo или PKCS#8) и возвращается с помощью метода getEncoded. Примечание: синтаксис типа ASN.1 SubjectPublicKeyInfo определяется следующим образом:

  SubjectPublicKeyInfo ::= SEQUENCE {
     algorithm AlgorithmIdentifier,
     subjectPublicKey BIT STRING }
  
   AlgorithmIdentifier ::= SEQUENCE {
     algorithm OBJECT IDENTIFIER,
     parameters ANY DEFINED BY algorithm OPTIONAL }

  Более подробную информацию можно найти в RFC 5280: Профили сертификатов и списков отозванных сертификатов (CRL) инфраструктуры открытых ключей X.509 Интернета.
• Формат

  Это имя формата закодированного ключа. Возвращается методом getFormat.

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

Ключ должен использовать KeyRep в качестве своего сериализованного представления. Обратите внимание, что сериализованный ключ может содержать конфиденциальную информацию, которую не следует раскрывать в ненадежных средах. Дополнительную информацию см. в Приложении "Безопасность" спецификации сериализации.

Подробное описание полей

serialVersionUID

static final long serialVersionUID

Отпечаток класса, установленный для указания совместимости сериализации с предыдущей версией класса.

См. также:

Значения постоянных полей

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

getAlgorithm

String getAlgorithm()

Возвращает стандартное имя алгоритма для этого ключа. Например, «DSA» указывает, что этот ключ является ключом DSA. Дополнительную информацию см. в документе Стандартные имена алгоритмов Java Security.

Возвращает:

имя алгоритма, связанного с этим ключом.

getFormat

String getFormat()

Возвращает имя первичного формата кодирования этого ключа или null, если этот ключ не поддерживает кодирование. Первичный формат кодирования называется в терминах соответствующего формата данных ASN.1, если для этого ключа существует спецификация ASN.1. Например, имя формата данных ASN.1 для открытых ключей — SubjectPublicKeyInfo, как определено стандартом X.509; в этом случае возвращаемый формат — "X.509". Аналогично, имя формата данных ASN.1 для закрытых ключей — PrivateKeyInfo, как определено стандартом PKCS #8; в этом случае возвращаемый формат — "PKCS#8".

Возвращает:

первичный формат кодирования ключа.

getEncoded

byte[] getEncoded()

Возвращает ключ в его первичном формате кодирования или null, если этот ключ не поддерживает кодирование.

Возвращает:

закодированный ключ или null, если ключ не поддерживает кодирование.