クラスHKDFParameterSpec.Builder
- 含まれているインタフェース:
HKDFParameterSpecPREVIEW
Builder
は、JavaプラットフォームのプレビューAPIです。
Builder
は、Extract
およびExtractThenExpand
オブジェクトをビルドします。
Builder
は、HKDFParameterSpec
のofExtract
メソッドを介して初期化されます。 クラスの説明に示されているように、addIKM
またはaddSalt
(あるいはその両方)を必要に応じてコールできます。 最後に、Extract
およびExtractThenExpand
のユースケースに対してextractOnly
またはthenExpand
をそれぞれコールすることで、オブジェクトは"built"です。 Builder
はスレッド・セーフではないことに注意してください。
- 導入されたバージョン:
- 24
-
メソッドのサマリー
修飾子と型メソッド説明addIKM
(byte[] ikm) 入力キーイング・マテリアル(IKM)をビルダーに追加します。入力キーイング・マテリアル(IKM)をビルダーに追加します。addSalt
(byte[] salt) ビルダーに塩を加えます。ビルダーに塩を加えます。Builder
の現在の状態からExtract
オブジェクトを作成します。thenExpand
(byte[] info, int length) Builder
の現在の状態からExtractThenExpand
オブジェクトを作成します。
-
メソッドの詳細
-
extractOnly
public HKDFParameterSpec.ExtractPREVIEW extractOnly()Builder
の現在の状態からExtract
オブジェクトを作成します。- 戻り値:
- 不変の
Extract
オブジェクト
-
thenExpand
public HKDFParameterSpec.ExtractThenExpandPREVIEW thenExpand(byte[] info, int length) Builder
の現在の状態からExtractThenExpand
オブジェクトを作成します。- 実装上のノート:
- HKDFの実装では、長さが255 * HMACの長さを超えないようにします。 HKDF実装では、 {code null} 情報値が長さ0バイト配列として扱われることも強制されます。
- パラメータ:
info
- オプションのコンテキストおよびアプリケーション固有の情報(null
)。バイト配列は、後続の変更を防ぐためにクローニングされますlength
- 出力キーイング材料の長さ (0より大きくする必要があります)- 戻り値:
- 不変の
ExtractThenExpand
オブジェクト - スロー:
IllegalArgumentException
-length
が0より大きくない場合
-
addIKM
public HKDFParameterSpec.BuilderPREVIEW addIKM(SecretKey ikm) 入力キーイング・マテリアル(IKM)をビルダーに追加します。ユーザーは、入力キーイング・マテリアル値をピース・ミールで組み立てる場合、またはIKMの一部をハードウェア暗号化デバイスによって提供する場合に、
addIKM
を複数回コールできます。Extract
オブジェクトまたはExtractThenExpand
オブジェクトのikms()
メソッドは、組み立てられた入力キーイング・マテリアルをSecretKey
オブジェクトのリストとして返します。- パラメータ:
ikm
- 入力キーイング・マテリアル(IKM)値- 戻り値:
- このビルダー
- スロー:
NullPointerException
-ikm
引数がnullの場合
-
addIKM
public HKDFParameterSpec.BuilderPREVIEW addIKM(byte[] ikm) 入力キーイング・マテリアル(IKM)をビルダーに追加します。 長さ0のikm
バイト配列は破棄されることに注意してください。ユーザーは、入力キーイング・マテリアル値をピース・ミールで組み立てる場合、またはIKMの一部をハードウェア暗号化デバイスによって提供する場合に、
addIKM
を複数回コールできます。Extract
オブジェクトまたはExtractThenExpand
オブジェクトのikms()
メソッドは、組み立てられた入力キーイング・マテリアルをSecretKey
オブジェクトのリストとして返します。- パラメータ:
ikm
- 入力キーイング・マテリアルの(IKM)値。ikm
バイト配列はSecretKeySpec
に変換されます。これは、バイト配列がSecretKeySpec
コンストラクタ内でクローニングされることを意味- 戻り値:
- このビルダー
- スロー:
NullPointerException
-ikm
引数がnullの場合
-
addSalt
public HKDFParameterSpec.BuilderPREVIEW addSalt(SecretKey salt) ビルダーに塩を加えます。ユーザーが
addSalt
を複数回コールできるのは、salt値をピース・ミールにアセンブルする場合、またはsaltの一部をハードウェア暗号化デバイスから提供する場合です。 後で構築されるExtract
またはExtractThenExpand
オブジェクトのsalts()
メソッドは、アセンブルされたsaltをSecretKey
オブジェクトのリストとして返します。- パラメータ:
salt
- 塩の値- 戻り値:
- このビルダー
- スロー:
NullPointerException
-salt
がnullの場合
-
addSalt
public HKDFParameterSpec.BuilderPREVIEW addSalt(byte[] salt) ビルダーに塩を加えます。 長さ0のsalt
バイト配列は破棄されることに注意してください。ユーザーが
addSalt
を複数回コールできるのは、salt値をピース・ミールにアセンブルする場合、またはsaltの一部をハードウェア暗号化デバイスから提供する場合です。 後で構築されるExtract
またはExtractThenExpand
オブジェクトのsalts()
メソッドは、アセンブルされたsaltをSecretKey
オブジェクトのリストとして返します。- パラメータ:
salt
- salt値。salt
バイト配列はSecretKeySpec
に変換されます。これは、バイト配列がSecretKeySpec
コンストラクタ内でクローニングされることを意味- 戻り値:
- このビルダー
- スロー:
NullPointerException
-salt
がnullの場合
-
Builder
を使用できます。