Spec-Zone.ru › OpenJDK 17

Интерфейс Key

Все суперинтерфейсы:
Serializable
Все известные подинтерфейсы:
DHPrivateKey, DHPublicKey, DSAPrivateKey, DSAPublicKey, ECPrivateKey, ECPublicKey, EdECPrivateKey, EdECPublicKey, PBEKey, PrivateKey, PublicKey, RSAMultiPrimePrivateCrtKey, RSAPrivateCrtKey, RSAPrivateKey, RSAPublicKey, SecretKey, XECPrivateKey, XECPublicKey
Все известные реализующие классы:
EncryptionKey, KerberosKey, SecretKeySpec
public interface Key extends Serializable
Интерфейс Key — это интерфейс верхнего уровня для всех ключей. Он определяет функциональность, общую для всех объектов ключей. Все ключи имеют три характеристики:
  • Алгоритм

    Это алгоритм ключа. Алгоритм ключа обычно является алгоритмом шифрования или асимметричной операции (таким как DSA или RSA), который будет работать с этими алгоритмами и связанными алгоритмами (такими как MD5 с RSA, SHA-1 с RSA, необработанный 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.

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

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

С:
1.1
См. также:
  • PublicKey
  • PrivateKey
  • KeyPair
  • KeyPairGenerator
  • KeyFactory
  • KeyRep
  • KeySpec
  • Identity
  • Signer

Краткое описание полей

Модификатор и тип Поле Описание
static final long serialVersionUID
Устарело.
Поле serialVersionUID в интерфейсе неэффективно.

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

Модификатор и тип Метод Описание
String getAlgorithm()
Возвращает стандартное имя алгоритма для данного ключа.
byte[] getEncoded()
Возвращает ключ в формате его первичного кодирования или null, если этот ключ не поддерживает кодирование.
String getFormat()
Возвращает имя первичного формата кодирования этого ключа или null, если этот ключ не поддерживает кодирование.

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

serialVersionUID

@Deprecated static final long serialVersionUID
Устарело.
Поле serialVersionUID в интерфейсе неэффективно. Не использовать; нет замены.
Отпечаток класса, который задан для указания совместимости сериализации с предыдущей версией класса.
См. также:
  • Значения константных полей

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

getAlgorithm

String getAlgorithm()
Возвращает стандартное имя алгоритма для данного ключа. Например, "DSA" указывает, что этот ключ является ключом DSA. См. разделы, связанные с ключами (KeyFactory, KeyGenerator, KeyPairGenerator и SecretKeyFactory), в Спецификации имен стандартных алгоритмов безопасности Java, чтобы узнать информацию о стандартных именах алгоритмов ключей.
Возвращает:
имя алгоритма, связанного с этим ключом.

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, если ключ не поддерживает кодирование.

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

Spec-Zone.ru

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