メインコンテンツまでスキップ

2. Content-Digest フィールド

Content-Digest HTTP フィールドは、リクエストとレスポンスで使用して、実際のメッセージコンテンツ([HTTP] のセクション 6.4 を参照)にハッシュアルゴリズムを適用して計算されたダイジェストを伝達できます。これは辞書([STRUCTURED-FIELDS] のセクション 3.2 を参照)であり、それぞれ:

  • キーは、ダイジェストの計算に使用されるハッシュアルゴリズム(セクション 5 を参照)を伝達します。

  • 値は、ダイジェスト計算によって生成されたバイト出力のエンコードされたバージョンを伝達するバイトシーケンス([STRUCTURED-FIELDS] のセクション 3.3.5)です。

例:

注:RFC 8792 による '' 行の折り返し

Content-Digest: \
sha-512=:YMAam51Jz/jOATT6/zvHrLVgOYTGFy1d6GJiOHTohq4yP+pgk4vf2aCs\
yRZOtw8MjkM7iw7yZ/WkppmM44T3qg==:

辞書タイプは、たとえば、異なる機能を持つ、または機能が進化しているエンドポイントの集団をサポートするために、異なるハッシュアルゴリズムを使用して計算された複数のダイジェストを添付するために使用できます。このようなアプローチは、より弱いアルゴリズムからの移行をサポートできます(セクション 6.6 を参照)。

注:RFC 8792 による '' 行の折り返し

Content-Digest: \
sha-256=:d435Qo+nKZ+gLcUHn7GQtQ72hiBVAgqoLsZnZPiTGPk=:,\
sha-512=:YMAam51Jz/jOATT6/zvHrLVgOYTGFy1d6GJiOHTohq4yP+pgk4vf2aCs\
yRZOtw8MjkM7iw7yZ/WkppmM44T3qg==:

受信者は、任意のダイジェストまたはすべてのダイジェストを無視してもよい (MAY)。アプリケーション固有の動作またはローカルポリシーは、伝達されたダイジェストの処理および検証の実践に追加の制約を設定してもよい (MAY)。セキュリティに関する考慮事項では、ダイジェストの無視(セクション 6.6 を参照)および複数のダイジェストの検証(セクション 6.7 を参照)に関連する問題の一部を扱っています。

送信者は、受信者が特定のハッシュアルゴリズムをサポートしているかどうかを知らなくてもダイジェストを送信してもよい (MAY)。送信者は、受信者がそれを無視することを知っている場合でもダイジェストを送信してもよい (MAY)。

Content-Digest はトレーラーセクションで送信できます。この場合、Content-Digest はヘッダーセクションにマージされてもよい (MAY)。[HTTP] のセクション 6.5.1 を参照してください。