HmacImportParams

ウェブ暗号化 API の HmacImportParams 辞書は、HMAC アルゴリズム用の鍵のインポート・アンラップ・導出を行う際、以下の引数として渡すオブジェクトを表します。

• SubtleCrypto.importKey() の引数 algorithm
• SubtleCrypto.unwrapKey() の引数 unwrappedKeyAlgorithm
• SubtleCrypto.deriveKey() の引数 derivedKeyType

インスタンスプロパティ

name

文字列です。HMAC に設定してください。

hash

文字列、または単一の文字列値プロパティ name を持つオブジェクトです。これは、用いるダイジェストアルゴリズムを表す識別子です。以下のいずれかを設定してください。

• SHA-256: SHA-256 アルゴリズムを選択します。
• SHA-384: SHA-384 アルゴリズムを選択します。
• SHA-512: SHA-512 アルゴリズムを選択します。

警告: SHA-1 にも対応していますが、SHA-1 アルゴリズムは脆弱とされており、もう使用しないべきです。

length 省略可

鍵の長さ (ビット数) を表す Number です。省略した場合、鍵の長さは選択したダイジェスト関数により生成されるダイジェストの長さと等しくなります。他の長さを用いる良い理由が無いのであれば、このプロパティを省略し、デフォルト値を使用してください。

例

SubtleCrypto.importKey()・SubtleCrypto.unwrapKey()・SubtleCrypto.deriveKey() の例を参照してください。

仕様書

ブラウザーの互換性

SubtleCrypto.importKey()・SubtleCrypto.unwrapKey()・SubtleCrypto.deriveKey() メソッドで "HMAC" アルゴリズムに対応しているブラウザーは、この型に対応しているはずです。

関連情報

• SubtleCrypto.importKey()
• SubtleCrypto.unwrapKey()
• SubtleCrypto.deriveKey()