O cabeçalho HTTPWant-Digest é primordialmente usado em uma requisição HTTP, para pedir ao respondedor para prover uma digestão (digest) do recurso requisitado usando o cabeçalho de respostaDigest.

O cabeçalho contém identificadores para um ou mais algoritmos de digestão que o remetente deseja que o respondedor use para criar a digestão. O remetente pode usarvalores de qualidade para indicar sua preferência ordenando dentre as escolhas que ele oferece.

SeWant-Digest não inclui nenhum algoritmo de digestão que aquele servidor suporta, o servidor pode responder com:

• uma digestão calculada usando outro algoritmo de digestão, ou
• um erro400 Bad Request, e inclui outro cabeçalhoWant-Digest com a resposta, listando os algoritmos que ele suporta.

Veja a página do cabeçalhoDigest para mais informações.

Sintaxe

Want-Digest: <digest-algorithm>// Múltiplos algoritmos, pesados com a sintaxe de qualidade de valor:Want-Digest: <digest-algorithm><q-value>,<digest-algorithm><q-value>

Diretivas

<digest-algorithm>

Algoritmos de digestão suportados são definidos naRFC 3230 eRFC 5843, e incluiSHA-256 eSHA-512. Alguns algoritmos suportados, incluindounixsum eMD5 são sujeitos a colisões e não são apropriados para aplicações em que resistência à colisão é importante.

<q-value>

Ovalor de qualidade para aplicar aquela opção.

Exemplos

Want-Digest: sha-256Want-Digest: SHA-512;q=0.3, sha-256;q=1, md5;q=0

Operação básica

O remetente provém a lista de digestões que ele está preparado para aceitar, e o servidor usa um deles:

Request:  GET /item  Want-Digest: sha-256;q=0.3, sha;q=1Response:  HTTP/1.1 200 Ok  Digest: sha-256=X48E9qOokqqrvdts8nOJRJN3OWDUoyWxBf7kbu9DBPE=

Digestões não suportadas

O servidor não suporta nenhum do algoritmos de digestão requisitados, então ele usa um algoritmo diferente:

Request:  GET /item  Want-Digest: sha;q=1Response:  HTTP/1.1 200 Ok  Digest: sha-256=X48E9qOokqqrvdts8nOJRJN3OWDUoyWxBf7kbu9DBPE=

O servidor não suporta nenhuma dos algoritmos de digestão requisitados, então responde com um erro 400 e inclui outro cabeçalhoWant-Digest, listando os algoritmos que ele suporta:

Request:  GET /item  Want-Digest: sha;q=1Response:  HTTP/1.1 400 Bad Request  Want-Digest: sha-256, sha-512

Especificações

Este cabeçalho foi originalmente definido naRFC 3230, mas a definição de "representação selecionada" naRFC 7231 fez a definição original ficar inconsistente com as atuais especificações HTTP. Quando lançado, o rascunho "Digestões de Recursos para HTTP" tornará a RFC 3230 obsoleta e vai atualizar o padrão para ficar consistente.

Compatibilidade com navegadores

Veja também

• Digest