クラスGCMParameterSpec

java.lang.Object
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
外部仕様
関連項目:

  • コンストラクタのサマリー

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

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    byte[]
    getIV()
    初期化ベクトル(IV)を返します。
    int
    getTLen()
    認証タグ長を返します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    String
    toString()
    オブジェクトの文字列表現を返します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • コンストラクタの詳細

    • 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が負の場合、またはoffsetとlenの合計がバイト配列srcの長さよりも大きい場合。

  • メソッドの詳細

    • getTLen

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

    • getIV

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