HTTP Want-Content-Digest Header

Der HTTP-Header Want-Content-Digest ist ein Request-Header, der dem Server mitteilt, welche Hash-Algorithmen der Client für Content-Integrität bevorzugt. Der Server antwortet mit Content-Digest Header zur Verifikation der Payload-Integrität.

Typ

Request-Header

Syntax

Der Header listet bevorzugte Hash-Algorithmen mit optionalen Quality-Werten auf.

http 
Want-Content-Digest: sha-256
Want-Content-Digest: sha-512=10, sha-256=5

Direktiven

Die Direktiven definieren gewünschte Hash-Algorithmen und deren Priorität.

<algorithm>
Hash-Algorithmus wie sha-256, sha-512, md5, crc32c. Standardisierte Algorithmen aus IANA Hash Algorithm Registry.
<quality>
Optional: Ganzzahl-Priorität (höher = bevorzugter), Standard ist 1. Format: algorithm=priority.

Beispiele

Nachfolgend finden Sie praktische Anwendungsbeispiele für den Want-Content-Digest-Header.

Beispiel 1 SHA-256 Integrity Check

http 
POST /api/upload HTTP/1.1
Host: storage.example.com
Want-Content-Digest: sha-256
Content-Type: application/octet-stream

[binary file data]

Response:

http 
HTTP/1.1 201 Created
Content-Digest: sha-256=:X48E9qOokqqrvdts8nOJRJN3OWDUoyWxBf7kbu9DBPE=:
Location: /files/abc123

Client fordert SHA-256-Hash an, Server berechnet und liefert Digest zur Verifikation des Uploads.

Beispiel 2 Priorisierte Algorithmen

http 
GET /api/download/firmware.bin HTTP/1.1
Host: cdn.example.com
Want-Content-Digest: sha-512=10, sha-256=5, crc32c=1

Response:

http 
HTTP/1.1 200 OK
Content-Digest: sha-512=:WZDPaVn/7XgHaAy8pmojAkGWoRx2UFChF41A2svX+TaPm+AbwAgBWnrIiYllu7BNNyealdVLvRwEmTHWXvJwew==:

[firmware binary]

Client bevorzugt SHA-512 für höchste Sicherheit, Server liefert entsprechenden Hash für Firmware-Verifikation.

Beispiel 3 Multiple Digests Response

http 
GET /api/archive.tar.gz HTTP/1.1
Host: files.example.com
Want-Content-Digest: sha-256, md5

Response:

http 
HTTP/1.1 200 OK
Content-Digest: sha-256=:RK/0qy18MlBSVnWgjwz6lZEWjP/lF5HF9bvEF8FabDg=:, md5=:je89MzJVv1Aiqp4YPx+LDQ==:

[archive data]

Server liefert beide angeforderten Hashes für Kompatibilität mit verschiedenen Verifikations-Tools.

Content Digest Flow

Want-Content-Digest Request Flow

Vorteile für die Systemarchitektur

  • End-to-End-Integrität: Client verifiziert empfangene/gesendete Daten gegen kryptografische Hashes
  • Korruptionserkennung: Erkennung von Netzwerkfehlern oder Proxy-Modifikationen während Übertragung
  • Compliance-Anforderungen: Erfüllt Audit-Anforderungen für sichere Dateiübertragungen in regulierten Umgebungen

Spezifikation

RFC 9530 – Digest Fields https://www.rfc-editor.org/rfc/rfc9530.html#name-want-content-digest

Weitere Spezifikationen

Content-Digest Header, Want-Repr-Digest Header