10.2 `hmac` -- メッセージ認証のための鍵付きハッシュ化

バージョン 2.2 で新たに追加された仕様です。

このモジュールでは RFC 2104 で記述されている HMAC アルゴリズムを実装しています。

new( key[, msg[, digestmod]]): 新たな hmac オブジェクトを返します。msg が存在すれば、メソッド呼び出し updatemsg を行います。 digestmod は HMAC オブジェクトが使うダイジェストコンストラクタあるいはモジュールです。標準では hashlib.md5 コンストラクタになっています。注意: md5ハッシュには既知の脆弱性がありますが、後方互換性を考慮してデフォルトのままにしています。使用するアプリケーションにあわせてよりよいものを選択してください。

HMAC オブジェクトは以下のメソッドを持っています:

update( msg): hmac オブジェクトを文字列 msg で更新します。繰り返し呼び出しを行うと、それらの引数を全て結合した引数で単一の呼び出しをした際と同じに等価になります: すなわち m.update(a); m.update(b) は m.update(a + b) と等価です。

digest( ): これまで update() メソッドに渡された文字列のダイジェスト値を返します。これはdigest_sizeバイトの文字列で、NULL バイトを含む非 ASCII 文字が含まれることがあります。

hexdigest( ): digest()と似ていますが、返される文字列は倍の長さとなり、16進形式となります。これは、電子メールなどの非バイナリ環境で値を交換する場合に便利です。

copy( ): hmac オブジェクトのコピー (``クローン'') を返します。このコピーは最初の部分文字列が共通になっている文字列のダイジェスト値を効率よく計算するために使うことができます。

参考:

hashlib:モジュール: セキュアハッシュ関数を提供するpythonモジュールです。.

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。