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

クラスGCMParameterSpec

  • すべての実装されたインタフェース:
    AlgorithmParameterSpec


    public class GCMParameterSpec
    extends Object
    implements AlgorithmParameterSpec
    GCM (Galois/Counter Mode)モードを使用して、Cipherで必要なパラメータ・セットを指定します。

    単純なブロック暗号モード(CBCなど)は通常、初期化ベクトル(IvParameterSpecなど)のみを必要としますが、GCMはこれらのパラメータを必要とします。

    • IV: 初期化ベクトル(IV)
    • tLen: 認証タグTの長さ(ビット単位)

    ここで説明しているパラメータのほかに、 Cipherクラスではその他のGCM入出力(Additional Authenticated Data (AAD)、鍵、ブロック暗号、平文/暗号テキストおよび認証タグ)が処理されます。

    RFC 5116 (関連データ付き認証付暗号化方式(AEAD)アルゴリズムについて)およびNIST特別出版800-38D「NIST Recommendation for Block Cipher Modes of Operation: Galois/Counter Mode (GCM) and GMAC」を参照してください。

    GCM仕様では、tLenは値{128, 120, 112, 104, 96}のみを持つことができ、アプリケーションによっては{64, 32}を持つことができます。 このクラスではその他の値を指定できますが、すべてのCSP実装でサポートされるわけではありません。

    導入されたバージョン:
    1.7
    関連項目:
    Cipher
    • コンストラクタのサマリー

      コンストラクタ 
      コンストラクタ 説明
      GCMParameterSpec​(int tLen, byte[] src)
      指定された認証タグ・ビット長およびIVバッファを使用して、GCMParameterSpecを構築します。
      GCMParameterSpec​(int tLen, byte[] src, int offset, int len)
      指定された認証タグ・ビット長およびIVなどの指定されたバッファのサブセットを使用して、GCMParameterSpecオブジェクトを構築します。
    • コンストラクタの詳細

      • GCMParameterSpec

        public GCMParameterSpec​(int tLen,
                                byte[] src)
        指定された認証タグ・ビット長およびIVバッファを使用して、GCMParameterSpecを構築します。
        パラメータ:
        tLen - 認証タグ長(ビット単位)
        src - IVソース・バッファ。 このバッファの内容は、後続の変更に影響されないようにコピーされる。
        例外:
        IllegalArgumentException - tLenが負、またはsrcがnullの場合。
      • GCMParameterSpec

        public GCMParameterSpec​(int tLen,
                                byte[] src,
                                int offset,
                                int len)
        指定された認証タグ・ビット長およびIVなどの指定されたバッファのサブセットを使用して、GCMParameterSpecオブジェクトを構築します。
        パラメータ:
        tLen - 認証タグ長(ビット単位)
        src - IVソース・バッファ。 このバッファの内容は、後続の変更に影響されないようにコピーされる。
        offset - IVが始まるsrc内のオフセット
        len - IVバイトの数
        例外:
        IllegalArgumentException - tLenが負の場合、srcがnullの場合、lenまたはoffsetが負の場合、またはoffsetlenの合計がバイト配列srcの長さよりも大きい場合。
    • メソッドの詳細

      • getTLen

        public int getTLen​()
        認証タグ長を返します。
        戻り値:
        認証タグ長(ビット単位)
      • getIV

        public byte[] getIV​()
        初期化ベクトル(IV)を返します。
        戻り値:
        IV。 このメソッドが呼び出されるたびに新しい配列を作成します。