Qual é o problema associado ao erro 401?

O erro 401 Unauthorized indica que a solicitação do cliente não foi autorizada. Isso significa que o cliente não possui as credenciais necessárias (por exemplo, login e senha, token de acesso) para acessar o recurso solicitado.

Principais problemas relacionados ao erro 401:

1. Credenciais incorretas ou ausentes:
   • O usuário inseriu login/senha incorretos.
   • A solicitação foi enviada sem as credenciais necessárias (por exemplo, sem o cabeçalho Authorization).
   • O token de acesso expirou ou está incorreto.
2. Erro no lado do servidor:
   • O servidor está mal configurado para lidar com autenticação.
   • Problemas com o serviço de autenticação (por exemplo, indisponível ou funcionando incorretamente).
   • Erro ao verificar a assinatura do token.
3. Problemas de infraestrutura:
   • Um proxy ou firewall bloqueia a transmissão de dados de autenticação.
   • Problemas com DNS ou rede que impedem uma interação correta com o serviço de autenticação.
4. Lógica incorreta no lado do cliente:
   • A aplicação do cliente não envia ou envia com erros os dados de autenticação.
   • Manipulação incorreta da resposta 401 (por exemplo, não redireciona para a página de login).

Para diagnosticar e resolver o problema, o engenheiro de QA deve:

• Verificar os logs do servidor e do cliente.
• Utilizar as ferramentas de desenvolvimento do navegador (aba Rede) para analisar a solicitação e a resposta (especialmente os cabeçalhos Authorization e WWW-Authenticate).
• Verificar a correção das credenciais.
• Revisar a documentação da API quanto aos requisitos de autenticação.
• Verificar o funcionamento do serviço de autenticação, se for separado.

Exemplo de cabeçalho Authorization na solicitação:

// GET /api/v1/resource HTTP/1.1
// Host: example.com
// Authorization: Bearer your_access_token
// User-Agent: Your-Client/1.0
// Accept: application/json

Exemplo de cabeçalho WWW-Authenticate na resposta 401:

// HTTP/1.1 401 Unauthorized
// Content-Type: text/plain
// WWW-Authenticate: Bearer realm="Access to the protected area"
// Content-Length: 21
// Connection: keep-alive
//
// Unauthorized access.