このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

HmacImportParams

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

インスタンスプロパティ

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() の例を参照してください。

仕様書

Specification
Web Cryptography Level 2
# dfn-HmacImportParams

ブラウザーの互換性

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

関連情報