javax.crypto.spec

クラス 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

関連項目:

Cipher

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

コンストラクタ

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

メソッドのサマリー

メソッド

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

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

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。このメソッドが呼び出されるたびに新しい配列を作成します。