blog
Painéis

Proteger pasta com senha no cPanel sem criar login

Como criar a pasta protegida e o usuário, o que cada navegador mostra na tela e os quatro cenários em que o recurso quebra mais do que protege.

JR · · 10 min de leitura · 2 tabelas · 2 blocos de código

Resposta curta: a proteção de diretório do cPanel liga a autenticação HTTP do servidor, então o visitante vê uma caixa cinza do próprio navegador, sem CSS do site e sem botão de sair. Serve para staging e pasta interna, e atrapalha em quatro casos previsíveis.

Neste artigo
  1. O que o visitante vê quando a pasta está protegida
  2. Como proteger uma pasta pelo Directory Privacy do cPanel
  3. Quatro casos em que ela atrapalha mais do que protege
  4. Três situações em que a caixa cinza é aceitável
  5. Como remover sem derrubar a pasta ou o site
  6. Checklist rápido de decisão

A proteção de diretório do cPanel não cria uma página de login. Ela liga a autenticação HTTP do servidor web naquela pasta, e quem decide o que aparece na tela é o navegador, não o seu site. Segundo a documentação do cPanel sobre Directory Privacy, o recurso restringe o acesso a um diretório exigindo nome de usuário e senha, e o painel grava essa configuração em arquivos de controle do servidor.

Isso muda tudo na hora de escolher onde usar. Ela é ótima para uma pasta de staging, um diretório de arquivos internos ou um painel improvisado que você não quer indexado. É ruim para qualquer coisa que o visitante precise entender, personalizar ou acessar por link direto.

O que o visitante vê quando a pasta está protegida

Ao abrir uma URL dentro da pasta protegida, o navegador recebe uma resposta HTTP 401 com um cabeçalho pedindo credenciais. O navegador então desenha uma caixa própria, fora do conteúdo da página, com dois campos. Nenhum CSS seu é aplicado ali. Nenhum logo aparece, a menos que você tenha configurado um texto de identificação, e mesmo esse texto entra como linha de aviso, não como identidade visual.

O comportamento muda de navegador para navegador:

Navegador Onde a caixa aparece O que costuma mostrar
Chrome / Edge Painel ancorado no topo da janela, abaixo da barra de endereço Domínio do site e os campos usuário e senha
Firefox Caixa modal centralizada sobre a aba Aviso de que o site está pedindo usuário e senha
Safari Folha modal presa à aba Domínio e os dois campos
App ou webhook Nenhuma caixa Apenas um erro 401, sem chance de digitar nada

Dois detalhes que geram chamado de "está pedindo senha de novo": o navegador costuma guardar a credencial enquanto a janela estiver aberta e reenviá-la automaticamente, e não existe botão de sair. Para encerrar a sessão, a pessoa fecha o navegador ou limpa os dados do site.

Como proteger uma pasta pelo Directory Privacy do cPanel

Antes de começar, decida qual pasta exatamente. Proteger public_html inteiro deixa o site todo atrás da caixa cinza, inclusive a home.

Onde fica o Directory Privacy no painel

No cPanel, procure a seção Files (ou Arquivos) e clique em Directory Privacy (ou Privacidade de Diretório). Se não achar, use a busca no topo do painel e digite privacy.

A tela mostra uma lista de pastas a partir da raiz da sua conta. Clique no nome da pasta para entrar nela, e use o ícone de edição ao lado para selecionar a pasta que vai proteger. Entrar na pasta e protegê-la são ações diferentes: clicar no nome navega, o botão de edição é o que abre as opções de proteção.

Caminho típico de uma pasta dentro do site principal: public_html depois o nome da pasta, por exemplo public_html/interno.

Marcar a proteção e escolher um nome que é público

Na tela de edição, marque a opção que protege o diretório com senha e preencha o campo de nome. Esse nome é o rótulo que pode aparecer na caixa do navegador. Trate-o como texto público: não escreva ali nada que você não queira que um visitante leia. Salve.

Neste ponto a pasta já responde 401, mas nenhum usuário existe ainda. Ou seja, ninguém entra, nem você.

Criar o usuário, sem o qual nem você entra

Ainda na mesma tela, há a área de criação de usuário. Informe um nome de usuário e uma senha. Use o gerador de senha do próprio painel se ele estiver disponível, e guarde a senha num gerenciador antes de clicar em salvar: o cPanel não mostra a senha de novo depois.

Você pode criar mais de um usuário para a mesma pasta. É o jeito razoável de dar acesso a um cliente sem compartilhar a sua credencial, porque remover um usuário depois não afeta os outros.

Testar em janela anônima, inclusive um arquivo direto

Abra uma janela anônima ou privativa e acesse a URL da pasta. Tem que aparecer a caixa do navegador. Digite o usuário e a senha e confirme que o conteúdo carrega. Testar na janela normal engana, porque o navegador pode já ter a credencial em memória.

Teste também um arquivo direto dentro da pasta, por exemplo https://seudominio.com.br/interno/relatorio.pdf. A proteção vale para o diretório e o que está dentro dele, então o PDF também deve pedir senha.

Proteger uma pasta pelo cPanel, passo a passoEscolher a pastaNunca public_html inteiroAbrir Directory PrivacySeção Files do cPanelMarcar proteçãoNome é texto públicoCriar usuárioSenha guardada no gerenciadorTestar anônimoPasta e arquivo direto
Sem o usuário criado, nem você entra na pasta.

Quatro casos em que ela atrapalha mais do que protege

Área de membros com marca, cadastro e recuperação de senha

Se a ideia é vender acesso, recuperar senha, mostrar o nome da pessoa logada ou ter níveis diferentes de permissão, a autenticação HTTP não entrega nada disso. Ela só sabe dizer sim ou não para um par usuário e senha. Não existe cadastro, não existe "esqueci minha senha", não existe tela com a sua marca. Para esse caso o caminho é um sistema de login dentro do site, como um plugin de associação no WordPress.

wp-admin protegido quebra o admin-ajax.php do site público

Proteger wp-admin com Directory Privacy funciona como camada extra, mas quebra coisas se feito sem cuidado. O arquivo wp-admin/admin-ajax.php é chamado pelo próprio site público, por plugins de carrinho, formulário e busca. Se ele passar a exigir senha, essas chamadas voltam 401 e o recurso para de funcionar para o visitante que nem deveria logar.

O mesmo vale para wp-cron.php e para chamadas da REST API em /wp-json/, que ficam fora de wp-admin mas são afetadas se você proteger a raiz do site.

Se for proteger wp-admin, a exceção para admin-ajax.php precisa ser escrita à mão no .htaccess. Faça o backup do arquivo antes, como descrito mais adiante em "Antes de mexer": uma linha errada aqui derruba o painel ou o site público.

No cPanel, abra o File Manager, entre em public_html/wp-admin, ative Settings e marque a opção de mostrar arquivos ocultos. Clique com o botão direito no .htaccess dessa pasta, escolha Edit e cole o bloco abaixo no fim do arquivo, depois das linhas AuthType, AuthName, AuthUserFile e Require valid-user que o painel criou:

<Files "admin-ajax.php">
  Require all granted
</Files>

Linha a linha: <Files "admin-ajax.php"> limita a regra a esse arquivo; Require all granted libera o acesso a ele mesmo com a proteção ativa no resto da pasta; </Files> fecha o bloco. Essa é a sintaxe do Apache 2.4, que é o padrão na maioria das hospedagens hoje. Salve.

Valide logo depois, numa janela anônima e deslogado do WordPress: abra a home, use a busca, envie o formulário de contato e adicione um produto ao carrinho. Os três precisam funcionar sem pedir senha. Acesse também /wp-admin/ na mesma janela: a caixa de senha do navegador tem que aparecer. Se o site público quebrar, apague o bloco ou restaure o backup do .htaccess.

Existe uma variante antiga dessa regra, do Apache 2.2 e do módulo de compatibilidade mod_access_compat, que usa Allow from all e Satisfy any no lugar de Require all granted. As duas sintaxes não se misturam, e o erro 500 pode acontecer nas duas direções: em um servidor 2.4 sem mod_access_compat, a linha Satisfy any gera "Invalid command" e derruba a pasta; em um servidor 2.2 ou em LiteSpeed em modo compatível antigo, quem não é reconhecido é o Require all granted. Comece pelo bloco acima, que é o da sintaxe atual. Se der 500 logo depois de salvar, troque o conteúdo interno do bloco pelas duas linhas antigas, Allow from all e Satisfy any, salve e teste de novo. Se o erro persistir, restaure o backup e remova a proteção. Para proteger só o login, costuma ser mais previsível usar um plugin de segurança que limita tentativas do que empilhar duas telas de senha.

Webhook, app e integração só recebem 401 e falham calados

Gateway de pagamento, serviço de e-mail transacional, integração de ERP e monitor de uptime não sabem preencher caixa de navegador. Eles recebem 401 e registram falha. Se a pasta protegida contém qualquer endpoint que alguém chama de fora, a integração morre em silêncio, e o sintoma aparece dias depois como "as notificações pararam".

Algumas ferramentas aceitam credencial HTTP na própria configuração da chamada. É possível, mas você passa a ter uma senha em texto dentro de um painel de terceiro. Pense duas vezes.

Mandar um link e o cliente cair numa caixa cinza pedindo usuário e senha é um convite para ele achar que o site foi invadido ou que o link quebrou. Pior: ele vai pedir a senha por WhatsApp, você vai mandar, e a senha vira pública. Para entrega de arquivo a cliente, um link com token ou uma pasta de nome difícil de adivinhar com listagem desativada costuma causar menos atrito do que a autenticação HTTP.

Três situações em que a caixa cinza é aceitável

Três situações em que o recurso resolve rápido e limpo:

Em todos, vale lembrar que a autenticação HTTP só protege se o site estiver em HTTPS. Sem TLS, usuário e senha viajam codificados em base64, que é leitura trivial para quem está no meio do caminho. Confirme que o domínio abre com cadeado antes de confiar na proteção.

Quando a caixa cinza ajuda e quando atrapalhaQuem vai abrir a URL?Pessoa, robô ou pluginPessoa avisada da equipeCaixa cinza serveCliente finalLink com token e prazoWebhook ou integraçãoRecebe 401 e falha caladoPlugin chamando admin-ajaxPrecisa exceção no .htaccess
Critério de decisão antes de ligar a proteção de diretório.

Como remover sem derrubar a pasta ou o site

A remoção é o momento de risco. Se algo foi configurado à mão nos arquivos de controle do servidor, um apagão parcial pode gerar erro 500 no diretório e, dependendo de onde o arquivo está, no site inteiro.

Copiar o .htaccess antes de qualquer alteração

Faça backup do arquivo .htaccess da pasta. No cPanel, abra o File Manager, entre na pasta, ative Settings e marque a opção de mostrar arquivos ocultos (dotfiles). Clique com o botão direito no .htaccess, escolha Copy e salve uma cópia com outro nome, por exemplo .htaccess.bkp. Com a cópia na mão, qualquer erro se desfaz renomeando o arquivo de volta.

Desmarcar a proteção e apagar os usuários órfãos

Volte em Directory Privacy, navegue até a mesma pasta, abra a edição e desmarque a opção de proteger o diretório. Salve. Depois remova também os usuários criados, para não deixar credencial órfã configurada.

Validar o acesso e resolver o erro 500 que pode sobrar

Abra uma janela anônima e acesse a URL. O conteúdo tem que carregar direto, sem caixa. Se aparecer 500 Internal Server Error, o problema quase certo é uma linha restante no .htaccess apontando para um arquivo de senha que não existe mais. Abra o .htaccess no File Manager e confira se sobraram linhas como estas:

AuthType Basic
AuthName "Area interna"
AuthUserFile /home/usuario/.htpasswds/public_html/interno/passwd
Require valid-user

O caminho acima é exemplo ilustrativo, o seu será diferente. Se o bloco sobrou, apague essas linhas, salve e recarregue a página. Se o erro continuar, restaure o .htaccess.bkp que você guardou e refaça a remoção pelo painel.

O que conferir agora que a pasta ficou pública

Se a pasta era um staging que ficou protegido por meses, lembre que agora ela está pública. Verifique se não há dado real de cliente ali, e se o conteúdo não deve ser indexado, trate isso de outra forma antes de deixar aberto.

Checklist rápido de decisão

Situação Directory Privacy resolve Alternativa melhor
Staging fora do Google Sim Bloqueio por IP, se a equipe tem IP fixo
Pasta de arquivos da equipe Sim Armazenamento em nuvem com conta por pessoa
Script antigo sem login Sim Reescrever com autenticação, quando der
Área de membros com marca Não Plugin de associação no WordPress
Proteger wp-admin inteiro Com ressalva Plugin de segurança com limite de tentativas
Endpoint de webhook Não Token secreto na URL ou validação de assinatura
Link de arquivo para cliente Não Link com token e prazo de validade

A regra que dá para levar: se quem vai abrir a URL é uma pessoa avisada, a caixa cinza serve. Se quem vai abrir é um cliente, um robô ou um plugin, ela atrapalha.

Referências

  1. Documentação oficial (cpanel) — Directory Privacy (cPanel). Consultado em 2026-09-18.
Leia também