A Autenticação Digest é um mecanismo de autenticação de controle de acesso HTTP que oferece segurança aprimorada em relação à Basic Auth. Enquanto a Basic Auth envia credenciais em texto simples (codificadas em Base64), a Digest Auth usa hash criptográfico para proteger as credenciais do usuário durante a transmissão.Como a Digest Auth funciona#
Na Basic Auth, o cliente envia o nome de usuário e a senha codificados em Base64 para o servidor. Essas credenciais podem ser transmitidas pela rede e podem ser interceptadas por um intermediário, que pode decodificá-las facilmente.A Autenticação Digest resolve esse problema usando algoritmos de criptografia para proteger a transmissão das credenciais do usuário. Em vez de enviar a senha, o cliente envia um hash da senha combinado com outros valores (nonce, realm etc.), tornando muito mais difícil para invasores interceptarem e reutilizarem credenciais.Basic Auth: nome de usuário e senha enviados em Base64 (facilmente decodificados)
Digest Auth: hash criptográfico enviado em vez da senha (não pode ser facilmente revertido)
Configurações básicas#
Na página Auth, selecione Digest Auth como o método de autorização e configure suas credenciais:| Parâmetro | Descrição | Obrigatório |
|---|
| Username | Seu nome de usuário de autenticação | Sim |
| Password | Sua senha de autenticação | Sim |
Configurações avançadas#
Clique na opção Advanced para configurar parâmetros adicionais de criptografia. Se forem deixados em branco, eles serão gerados automaticamente com base na resposta do servidor.| Parâmetro | Descrição | Origem |
|---|
| Realm | O identificador do espaço de proteção | Fornecido pelo servidor no cabeçalho WWW-Authenticate |
| Nonce | Uma string exclusiva especificada pelo servidor | Fornecida pelo servidor no cabeçalho WWW-Authenticate |
| Algorithm | O algoritmo de hash criptográfico | MD5, SHA-256, SHA-256-sess, SHA-512-256, SHA-512-256-sess |
| qop (Quality of Protection) | O nível de qualidade do algoritmo digest | auth (somente autenticação) ou auth-int (autenticação + integridade) |
| Client Nonce | Número aleatório gerado pelo cliente | Gerado pelo cliente para cada requisição |
| Opaque | String aleatória fornecida pelo servidor | Retornada pelo servidor, enviada de volta sem alterações |
Valores de Quality of Protection (qop)#
| Valor | Descrição | Caso de uso |
|---|
| auth | Garantia de qualidade da autenticação | Autenticação digest padrão |
| auth-int | Autenticação + proteção de integridade | Segurança aprimorada com verificação de integridade da mensagem |
Na maioria dos casos, você só precisa fornecer seu nome de usuário e sua senha. O Apidog extrairá automaticamente o Realm, o Nonce e outros parâmetros da resposta inicial do servidor e os configurará para você.
Certifique-se de que o endpoint da sua API seja compatível com o algoritmo selecionado. Implementações modernas normalmente são compatíveis com variantes SHA-256 ou SHA-512 para maior segurança em relação ao algoritmo MD5 legado.