\section{\module{hmac} ---
         メッセージ認証のための鍵付きハッシュ化}

\declaremodule{standard}{hmac}
\modulesynopsis{Python で実装された、メッセージ認証のための鍵付き
ハッシュ化 (HMAC: Keyed-Hashing for Message Authentication)
アルゴリズム。}
\moduleauthor{Gerhard H{\"a}ring}{ghaering@users.sourceforge.net}
\sectionauthor{Gerhard H{\"a}ring}{ghaering@users.sourceforge.net}

\versionadded{2.2}

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

\begin{funcdesc}{new}{key\optional{, msg\optional{, digestmod}}}
新たな hmac オブジェクトを返します。\var{msg} が存在すれば、
メソッド呼び出し \code{update\var{msg}} を行います。
\var{digestmod} は HMAC オブジェクトが使うダイジェストモジュール
です。標準では \refmodule{md5} モジュールになっています。
\end{funcdesc}

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

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

\begin{methoddesc}[hmac]{digest}{}
これまで \method{update()} メソッドに渡された文字列のダイジェスト値
を返します。個の値は 16 バイトの文字列 (\refmodule{md5} の場合) か、
20 バイトの文字列 (\refmodule{sha} の場合) で、NULL バイトを含む
非 \ASCII{} 文字が含まれることがあります。
\end{methoddesc}

\begin{methoddesc}[hmac]{hexdigest}{}
\method{digest()} と似ていますが、ダイジェスト値が \refmodule{md5} 
のときで長さ 32 文字 (\refmodule{sha} のときで 40文字) の 16進数字
のみを含む文字列で返されます。この値は電子メールやその他の非バイナリ
環境で値をやり取りする際に使うことができます。
\end{methoddesc}

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