Autenticação Básica (Basic Auth)

Usuário e senha em Base64 no cabeçalho Authorization: como funciona, quando faz sentido e os riscos.

5 min de leitura · Iniciante · Revisado em

Como funciona

Na autenticação básica, o cliente envia usuário e senha em cada requisição, no cabeçalho Authorization. Os dois são unidos por : e codificados em Base64.

Requisição com credenciais

GET /trilhas HTTP/1.1
Host: api.trilha.info
Authorization: Basic YW5hOnMzbmg0LWZvcnRl
Decodificando o Base64: ana:s3nh4-forte

O fluxo no navegador

Primeiro acesso a um recurso protegido por Basic Auth

  1. Navegador → Servidor: GET /trilhas. Sem o cabeçalho Authorization.
  2. Servidor → Navegador: 401 Unauthorized. Com WWW-Authenticate: Basic realm="Trilha Info".
  3. Navegador → Navegador: Janela de login. O navegador pede usuário e senha.
  4. Navegador → Servidor: GET /trilhas + Authorization. Basic seguido do Base64.
  5. Servidor → Servidor: Confere as credenciais. Compara com o hash guardado.
  6. Servidor → Navegador: 200 OK. Devolve o conteúdo.

Depois do primeiro login, o navegador reenvia o cabeçalho automaticamente para o mesmo domínio. Não existe "sair" de verdade: as credenciais ficam guardadas até o navegador ser fechado.

Quando faz sentido

Serve bem

Ferramentas internas e integrações simples

Comunicação entre serviços, ambientes de teste ou um painel interno, sempre com HTTPS.

  • Fácil de testar com curl -u usuario:senha
  • Sem estado no servidor

Evite

Login de usuários finais

Para pessoas usando sua aplicação, prefira sessões com cookie ou um provedor com OAuth 2.0 e OpenID Connect.

  • A senha trafega em toda requisição
  • Sem logout, expiração ou segundo fator
  • Interface de login do navegador não é personalizável
401 Unauthorized
Falta autenticação ou ela é inválida. O servidor deve enviar WWW-Authenticate.
403 Forbidden
A pessoa foi identificada, mas não tem permissão para o recurso.

Referências

Trilhas relacionadas