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オブジェクトを構築します。 -
メソッドのサマリー
-
コンストラクタの詳細
-
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。 このメソッドが呼び出されるたびに新しい配列を作成します。
-