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 YW5hOnMzbmg0LWZvcnRlDecodificando o Base64: ana:s3nh4-forteO fluxo no navegador
Primeiro acesso a um recurso protegido por Basic Auth
- Navegador → Servidor: GET /trilhas. Sem o cabeçalho Authorization.
- Servidor → Navegador: 401 Unauthorized. Com
WWW-Authenticate: Basic realm="Trilha Info". - Navegador → Navegador: Janela de login. O navegador pede usuário e senha.
- Navegador → Servidor: GET /trilhas + Authorization.
Basicseguido do Base64. - Servidor → Servidor: Confere as credenciais. Compara com o hash guardado.
- 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.