Em resumo
- Crie o arquivo
.htaccessdentro da pasta que você quer proteger. - Crie o arquivo
.htpasswdcom os usuários e as senhas criptografadas. - Envie os dois arquivos via FTP para a mesma pasta.
- Teste no navegador: ele deve pedir usuário e senha.
Em algumas situações pode ser necessário restringir o acesso a determinados conteúdos do seu site, como uma pasta específica contendo arquivos administrativos, relatórios, documentos internos ou áreas de teste.
Uma forma simples, eficiente e bastante segura de fazer isso é utilizando o próprio servidor web (Apache), que permite proteger pastas com usuário e senha.
Quando essa proteção é aplicada, qualquer visitante que tentar acessar aquela pasta verá uma tela solicitando login e senha antes mesmo do conteúdo ser carregado.
Importante lembrar
Essa proteção funciona apenas para acesso via HTTP ou HTTPS (navegador). Ela não bloqueia acesso via FTP.
Passo 1 — Criando o arquivo .htaccess
Crie um arquivo chamado .htaccess (note que o nome começa com um ponto) contendo o seguinte conteúdo:
AuthUserFile "/DADOS/sites-dominio/www.seu-dominio/public_html/PASTA/.htpasswd"
AuthGroupFile /dev/null
AuthName "Acesso Restrito"
AuthType Basic
Require valid-user
Explicação dos parâmetros
AuthUserFile
Define onde está localizado o arquivo .htpasswd, que contém os usuários e senhas permitidos.
Exemplo:
Se você deseja proteger a pasta:
www.seusite.com.br/interno/conf/prot
o caminho deverá ser:
/DADOS/sites-dominio/www.seusite.com.br/public_html/interno/conf/prot/.htpasswd
Ou seja, o caminho precisa ser completo dentro do servidor.
AuthName
Define o texto que aparecerá na janela de autenticação do navegador.
Exemplo:
AuthName "Área Administrativa"
Você pode usar qualquer texto entre aspas.
| Parâmetro | Para que serve |
|---|---|
AuthUserFile | Caminho completo do arquivo .htpasswd com os usuários e senhas |
AuthGroupFile /dev/null | Indica que não há arquivo de grupos; apenas usuários individuais |
AuthName | Texto exibido na janela de login do navegador |
AuthType Basic | Tipo de autenticação: a janela padrão de usuário e senha do navegador |
Require valid-user | Libera o acesso a qualquer usuário válido listado no .htpasswd |
Passo 2 — Enviando o arquivo para o servidor
Envie o arquivo .htaccess via FTP para dentro da pasta que você deseja proteger.
Não sabe como enviar arquivos por FTP? Veja Como alterar os arquivos do seu site.
Atenção
Alguns programas de FTP não exibem arquivos ocultos (arquivos que começam com ponto).
Se você não visualizar o arquivo após enviar, configure o FTP para exibir arquivos ocultos.
Também pode ocorrer do arquivo ser enviado como:
.htaccess.txt
Nesse caso basta renomear para .htaccess.
Passo 3 — Criando o arquivo .htpasswd
Agora crie outro arquivo chamado .htpasswd.
Esse arquivo armazenará os usuários autorizados.
Formato do arquivo:
usuario:senha-criptografada
Exemplo:
teste:AWMFU9MocfJi8
Nesse exemplo:
- usuário → teste
- senha criptografada → AWMFU9MocfJi8
A senha precisa estar criptografada, pois o Apache não aceita senhas em texto simples.
Gerando a senha criptografada
Para gerar a senha criptografada, acesse o PDC (Painel de Controle) e utilize a opção:
Gerar Senha Criptografada para usar no .htpasswd
Copie a linha gerada e cole dentro do arquivo .htpasswd.
Exemplo de criação de usuário:
Usuário desejado:
teste
Senha escolhida:
a1b2c3
Resultado no .htpasswd:
teste:AWMFU9MocfJi8
Observação importante
A criptografia pode gerar resultados diferentes para a mesma senha, isso é normal e aumenta a segurança do sistema.
Os exemplos desta página (usuário teste e senha a1b2c3) são apenas ilustrativos. Em uma pasta real, escolha uma senha forte e exclusiva.
Criando múltiplos usuários
Você pode criar quantos usuários desejar.
Basta adicionar um por linha:
teste:AWMFU9MocfJi8
user:VRMFA9MochJi0
nome:YTGBLmkn867
Passo 4 — Enviando o .htpasswd
Envie o arquivo .htpasswd via FTP para a mesma pasta onde está o .htaccess.
A estrutura final ficará assim:
/pasta-protegida/
.htaccess
.htpasswd
Novamente, caso o arquivo seja enviado como:
.htpasswd.txt
renomeie para:
.htpasswd
Testando a proteção
Após concluir os passos acima, tente acessar a pasta protegida pelo navegador.
Exemplo:
www.seusite.com.br/pasta-protegida/
O navegador exibirá automaticamente uma janela solicitando usuário e senha.
Somente após inserir as credenciais corretas o conteúdo será exibido.
Algo não funcionou?
| O que você vê | Causa provável | O que fazer |
|---|---|---|
| A pasta abre sem pedir senha | O arquivo está com outro nome (como .htaccess.txt) ou na pasta errada | Renomeie para .htaccess e confira se ele está dentro da pasta que você quer proteger |
| Erro 500 (Internal Server Error) | Erro de digitação no .htaccess ou caminho do AuthUserFile incorreto | Revise o conteúdo e confirme o caminho completo até o .htpasswd; se precisar, volte à cópia anterior do arquivo |
| Pede a senha, mas não aceita | Usuário ou senha diferentes dos gravados no .htpasswd | Confira o usuário e gere a linha de novo no PDC |
| Não vejo os arquivos no FTP | O programa de FTP oculta arquivos que começam com ponto | Ative a opção de exibir arquivos ocultos |
Quando usar esse recurso
Esse tipo de proteção é muito útil para:
- áreas administrativas
- ambientes de desenvolvimento
- páginas internas
- relatórios privados
- downloads restritos
- sistemas ainda em construção
Além disso, é uma camada extra de segurança bastante eficiente contra acessos indevidos.
Para quem é técnico: detalhes e boas práticas
- Vale para as subpastas: o
.htaccessse aplica à pasta onde está e a tudo que fica abaixo dela. - Use HTTPS: na autenticação Basic o navegador envia as credenciais codificadas, não protegidas. Em HTTPS o trajeto é cifrado (nos nossos servidores o HTTPS é obrigatório).
- Só um arquivo: dá para proteger um arquivo específico usando
<Files>, como no exemplo dowp-login.phpem Protegendo seu site em WordPress. - Pelo terminal: quem tem acesso ao utilitário
htpasswddo Apache também pode gerar a linha por lá. O formato do arquivo é o mesmo. - Não é para dados sensíveis: é uma camada simples de acesso. Dados realmente confidenciais devem ficar fora da pasta pública do site ou em um sistema com controle de acesso próprio.
Veja também
Ficou com dúvida? Fale com o nosso suporte.