* 仕様書

[REFS[
- [1] [CITE@en[RFC 7616 - HTTP Digest Access Authentication]] ([TIME[2015-11-10 07:05:08 +09:00]] 版) <https://tools.ietf.org/html/rfc7616#section-3.3>
- [8] [CITE@en[RFC 7616 - HTTP Digest Access Authentication]] ([TIME[2015-11-10 07:05:08 +09:00]] 版) <https://tools.ietf.org/html/rfc7616#section-3.4>
]REFS]

* 意味

[5] [[challenge]] では、[[サーバー]]が[[利用者名]]の[[ハッシュ化]]に対応しているかどうかを示します [SRC[>>1]]。

[9] [[credentials]] では、[[クライアント]]が[[利用者名]]を[[ハッシュ化]]したかどうかを示します
[SRC[>>8]]。

* 構文

[6] [[妥当]]な値は [CODE[[[true]]]] か [CODE[[[false]]]] です [SRC[>>1, >>8]]。

[10] [[サーバー]]は、 [[challenge]] で 
[CODE[[[true]]]] を設定する[['''べきです''']] [SRC[>>8]]。

* 文脈

[3] [[ダイジェスト認証]]の [[challenge]] [SRC[>>1]] や
[[credentials]] [SRC[>>8]] の [CODE(ABNF)@en[[[auth-param]]]] で指定できます。

[4] 必須ではありません [SRC[>>1, >>8]]。

* 処理

[7] 既定値は [CODE[[[false]]]] です [SRC[>>1, >>8]]。

[11] [[challenge]] の [CODE(HTTP)@en[[[userhash]]]]
[[引数]]は、 [[credentials]] の [CODE[[[response]]]] [[引数]]の計算は影響しません。

[14] [[challenge]] の [CODE(HTTP)@en[[[userhash]]]]
[[引数]]は、 [[credentials]] の [CODE[[[username]]]] [[引数]]の値に影響します。

[12] [[クライアント]]は、 [[challenge]] で [CODE[[[userhash]]]] [[引数]]が [CODE[[[true]]]]
に設定されていれば、 [[credentials]] で [CODE[[[userhash]]]]
[[引数]]を [CODE[[[true]]]] に設定しなければ[['''なりません''']] [SRC[>>8]]。

[13] [[サーバー]]は、[[クライアント]]が [[credentials]] で [CODE[[[userhash]]]]
[[引数]]の値を [CODE[[[true]]]] に設定していないか、
[[利用者名]]を[[ハッシュ化]]していなければ、
[[要求]]を拒絶して構いません [SRC[>>8]]。

* 歴史

[2] [[RFC 7616]] で追加されました。