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