Digest Authentication は、Basic Auth よりも強化されたセキュリティを提供する HTTP アクセス制御認証メカニズムです。Basic Auth が認証情報をプレーンテキスト(Base64 エンコード)で送信するのに対し、Digest Auth は暗号学的ハッシュを使用して、送信中のユーザー認証情報を保護します。Digest Auth の仕組み#
Basic Auth では、クライアントはユーザー名とパスワードを Base64 エンコードでサーバーに送信します。これらの認証情報はネットワーク上で送信されるため、中間者に傍受される可能性があり、簡単にデコードされるおそれが あります。Digest Authentication は、暗号化アルゴリズムを使用してユーザー認証情報の送信を保護することで、この問題を解決します。パスワードを送信する代わりに、クライアントはパスワードを他の値(nonce、realm など)と組み合わせたハッシュを送信します。これにより、攻撃者が認証情報を傍受して再利用することがはるかに困難になります。Basic Auth: ユーザー名とパスワードを Base64 で送信します(簡単にデコード可能)
Digest Auth: パスワードの代わりに暗号学的ハッシュを送信します(簡単に元に戻すことはできません)
基本設定#
Auth ページで、認可方式として Digest Auth を選択し、認証情報を設定します。| パラメータ | 説明 | 必須 |
|---|
| Username | 認証用ユーザー名 | はい |
| Password | 認証用パスワード | はい |
詳細設定#
Advanced オプションをクリックして、追加の暗号化パラメータを設定します。空白のまま にした場合、サーバーのレスポンスに基づいて自動的に生成されます。| パラメータ | 説明 | ソース |
|---|
| Realm | 保護領域の識別子 | サーバーにより WWW-Authenticate ヘッダーで提供されます |
| Nonce | サーバーが指定する一意の文字列 | サーバーにより WWW-Authenticate ヘッダーで提供されます |
| Algorithm | 暗号学的ハッシュアルゴリズム | MD5, SHA-256, SHA-256-sess, SHA-512-256, SHA-512-256-sess |
| qop (Quality of Protection) | ダイジェストアルゴリズムの品質レベル | auth(認証のみ)または auth-int(認証 + 完全性) |
| Client Nonce | クライアントが生成する乱数 | 各リクエストに対してクライアントが生成します |
| Opaque | サーバーが提供するランダム文字列 | サーバーから返され、変更せずに送り返されます |
Quality of Protection(qop)の値#
| 値 | 説明 | ユースケース |
|---|
| auth | 認証品質保証 | 標準的なダイジェスト認証 |
| auth-int | 認証 + 完全性保護 | メッセージ完全性検証による強化されたセキュリティ |
ほとんどの場合、ユーザー名とパスワードを指定するだけで十分です。Apidog は、サーバーの初回レスポンスから Realm、Nonce、その他のパラメータを自動的に抽出し、設定します。
API エンドポイントが選択したアルゴリズムをサポートしていることを確認してください。最新の実装では通常、従来の MD5 アルゴリズムよりも強化されたセキュリティを提供するために、SHA-256 または SHA-512 系のバリアントがサポートされています。