Protegendo pastas no site com senhas

Em resumo

  1. Crie o arquivo .htaccess dentro da pasta que você quer proteger.
  2. Crie o arquivo .htpasswd com os usuários e as senhas criptografadas.
  3. Envie os dois arquivos via FTP para a mesma pasta.
  4. 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.

Fluxo de uma pasta protegida: o visitante abre a pasta, o servidor pede usuário e senha, compara com o .htpasswd e libera ou nega o acesso1O visitante abrewww.seusite.com.br/pasta-protegida/2O servidor (Apache)encontra o arquivo.htaccess na pasta3O navegador mostraa janela de usuárioe senha4O servidor comparacom o arquivo.htpasswdUsuário ou senha incorretosAcesso negado: o conteúdonão é carregadoUsuário e senha corretosConteúdo liberadopara o visitante
O que acontece quando alguém tenta abrir uma pasta protegida.

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.

Mapa de pastas: a pasta protegida contém .htaccess e .htpasswd, e o caminho completo do .htpasswd é usado no AuthUserFileEstrutura de pastas no sitepublic_html/└─ interno/└─ conf/└─ prot/└─ .htaccess└─ .htpasswd← pasta a protegerCaminho completo no AuthUserFilePasta protegida no site:www.seusite.com.br/interno/conf/protO caminho no servidor precisa ser completo:/DADOS/sites-dominio/www.seusite.com.br/public_html/interno/conf/prot/.htpasswdSempre o caminho completo dentro doservidor, terminando no arquivo .htpasswd.
Como a pasta protegida se traduz no caminho completo usado no AuthUserFile.

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âmetroPara que serve
AuthUserFileCaminho completo do arquivo .htpasswd com os usuários e senhas
AuthGroupFile /dev/nullIndica que não há arquivo de grupos; apenas usuários individuais
AuthNameTexto exibido na janela de login do navegador
AuthType BasicTipo de autenticação: a janela padrão de usuário e senha do navegador
Require valid-userLibera 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ávelO que fazer
A pasta abre sem pedir senhaO arquivo está com outro nome (como .htaccess.txt) ou na pasta erradaRenomeie 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 incorretoRevise 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 aceitaUsuário ou senha diferentes dos gravados no .htpasswdConfira o usuário e gere a linha de novo no PDC
Não vejo os arquivos no FTPO programa de FTP oculta arquivos que começam com pontoAtive 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 .htaccess se 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 do wp-login.php em Protegendo seu site em WordPress.
  • Pelo terminal: quem tem acesso ao utilitário htpasswd do 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.

Compartilhe isso: