4. Integritätspräferenzfelder

Absender können ihr Interesse an Integritätsfeldern und Hashing-Algorithmus-Präferenzen mithilfe der HTTP-Felder Want-Content-Digest oder Want-Repr-Digest angeben. Diese können sowohl in Anfragen als auch in Antworten verwendet werden.

Want-Content-Digest gibt an, dass der Absender (über das Content-Digest-Feld) einen Inhalts-Digest für Nachrichten erhalten möchte, die mit der Anfrage-URI und den Repräsentationsmetadaten verknüpft sind. Want-Repr-Digest gibt an, dass der Absender (über das Repr-Digest-Feld) einen Repräsentations-Digest für Nachrichten erhalten möchte, die mit der Anfrage-URI und den Repräsentationsmetadaten verknüpft sind.

Wenn Want-Content-Digest oder Want-Repr-Digest in einer Antwort verwendet werden, bedeutet dies, dass der Server möchte, dass der Client das entsprechende Integritätsfeld bei zukünftigen Anfragen bereitstellt.

Integritätspräferenzfelder sind nur ein Hinweis. Der Empfänger des Feldes kann es ignorieren und ein Integritätsfeld unter Verwendung eines beliebigen Algorithmus senden oder das Feld vollständig weglassen; siehe zum Beispiel Anhang C.2. Es ist kein Protokollfehler, wenn Präferenzen ignoriert werden. Anwendungen, die Integritätsfelder und Integritätspräferenzen verwenden, können Erwartungen oder Einschränkungen definieren, die zusätzlich zu dieser Spezifikation gelten. Ignorierte Präferenzen sind ein anwendungsspezifisches Anliegen.

Want-Content-Digest und Want-Repr-Digest sind vom Typ Wörterbuch, wobei jedes:

Schlüssel den Hashing-Algorithmus übermittelt (siehe Abschnitt 5);
Wert eine Ganzzahl ist (Abschnitt 3.3.1 von [STRUCTURED-FIELDS]), die eine aufsteigende, relative, gewichtete Präferenz übermittelt. Sie muss im Bereich von 0 bis 10 einschließlich liegen. 1 ist am wenigsten bevorzugt, 10 ist am meisten bevorzugt, und ein Wert von 0 bedeutet "nicht akzeptabel".

Beispiele:

Want-Repr-Digest: sha-256=1
Want-Repr-Digest: sha-512=3, sha-256=10, unixsum=0
Want-Content-Digest: sha-256=1
Want-Content-Digest: sha-512=3, sha-256=10, unixsum=0