モジュール java.base
パッケージ javax.crypto

クラスKEM.Encapsulator

java.lang.Object
javax.crypto.KEM.Encapsulator
含まれているクラス:
KEM
public static final class KEM.Encapsulator extends Object
エンカプセレータ。KEM送信側のKEM.newEncapsulator(java.security.PublicKey)によって生成されます。

このクラスは、KEMのキー・カプセル化関数を表します。 encapsulateメソッドを起動するたびに、KEM.Encapsulatedオブジェクトで返される新しい秘密キーおよびキー・カプセル化メッセージが生成されます。

APIのノート:
このクラスは、Java SE 17 Maintenance Release 1で定義されています。
導入されたバージョン:
17

  • メソッドの詳細

    • providerName

      public String providerName()
      プロバイダの名前を返します。
      戻り値:
      プロバイダの名前

    • encapsulate

      public KEM.Encapsulated encapsulate()
      キー・カプセル化機能。

      このメソッドはencapsulate(0, secretSize(), "Generic")と同等です。 この引数の組合せは、すべての実装でサポートされる必要があります。

      生成された秘密キーは通常、キー導出関数(KDF)に入力キーイング・マテリアルとして渡されます。

      戻り値:
      共有シークレット、キー・カプセル化メッセージおよびオプション・パラメータを含むKEM.Encapsulatedオブジェクト。 共有シークレットは、シークレットのすべてのバイトと"一般"のアルゴリズム名を含むSecretKeyです。

    • encapsulate

      public KEM.Encapsulated encapsulate(int from, int to, String algorithm)
      キー・カプセル化機能。

      このメソッドを起動するたびに、KEM.Encapsulatedオブジェクトで返される新しい秘密キーおよびキーのカプセル化メッセージが生成されます。

      実装では、from、toおよびalgorithmの任意の組合せをサポートしないことを選択できます。

      パラメータ:
      from - 返される共有シークレット・バイト配列の初期インデックス(両端を含む)
      to - 返される共有シークレット・バイト配列の最終インデックス、排他的
      algorithm - 返される秘密キーのアルゴリズム名
      戻り値:
      共有シークレットの一部、キー・カプセル化メッセージおよびオプション・パラメータを含むKEM.Encapsulatedオブジェクト。 共有シークレットの一部は、fromからtoまでのシークレットのバイトを含むSecretKey、排他的、および指定されたアルゴリズム名です。 たとえば、encapsulate(0, 16, "AES")は、共有シークレットの最初の16バイトを128ビットのAESキーとして使用します。
      throws:
      IndexOutOfBoundsException - from < 0、from > toまたはto > secretSize()の場合
      NullPointerException - algorithmがnullである場合
      UnsupportedOperationException - from、to、およびalgorithmの組み合わせがエンカプセレータによってサポートされない場合

    • secretSize

      public int secretSize()
      共有シークレットのサイズを返します。

      このメソッドをコールして、encapsulateがコールされる前に共有シークレットの長さを調べるか、取得したSecretKeyが抽出可能でないかを確認できます。

      戻り値:
      共有シークレットのサイズ

    • encapsulationSize

      public int encapsulationSize()
      キー・カプセル化メッセージのサイズを返します。

      このメソッドをコールして、encapsulateがコールされる前にカプセル化メッセージの長さを確認できます。

      戻り値:
      キー・カプセル化メッセージのサイズ