> ## Documentation Index
> Fetch the complete documentation index at: https://docs.saninternet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Proteção de Diretório

> Põe um nome de usuário e uma senha numa pasta do seu site. Quem abre um endereço dentro dela vê o navegador pedir os dois, e só passa quem acertar. A tela sugere o uso para 'áreas…

**Caminho no painel:** menu da esquerda > **SEGURANÇA** > **Proteção de Diretório**

A tela trabalha com as pastas *"dentro do seu diretório /www/"*, a pasta onde ficam
os sites.

## A lista

![Lista de proteções com uma linha: o quadrado verde da situação, o nome de usuário, a pasta protegida com o ícone de pasta e o triângulo de exceções, o título da área e os ícones de editar e excluir](https://mintcdn.com/san-internet/ROiLhCzBw6wgVslN/keyhelp/imagens/protecao-lista.png?fit=max\&auto=format\&n=ROiLhCzBw6wgVslN\&q=85\&s=857575e7b70ab27bbf07b67f79c2bd03)

| Coluna | O que é |
| - | - |
| **S** | a situação: um quadrado verde, *"Tudo certo"*. Logo depois de salvar, aparece uma chave inglesa, *"Processando"* |
| **NOME DE USUÁRIO** | o usuário que entra na pasta |
| **DIRETÓRIO** | a pasta protegida. O ícone de pasta a abre no **Gerenciador de Arquivos**. Um triângulo ao lado avisa *"Exceções foram definidas para este diretório."* |
| **TÍTULO DA ÁREA PROTEGIDA** | o nome dado à área |
| **AÇÕES** | o lápis edita, a lixeira exclui |

## Proteger uma pasta

![Formulário Adicionar proteção de diretório: Diretório com a parte /www fixa e o Navegar, as Exceções abertas, Título da área protegida, Nome de usuário, Senha, Confirme a senha e Sugestão de senha com Gerar](https://mintcdn.com/san-internet/ROiLhCzBw6wgVslN/keyhelp/imagens/protecao-adicionar.png?fit=max\&auto=format\&n=ROiLhCzBw6wgVslN\&q=85\&s=2c939d8962d99d671eb41eff7a50f331)

1. Clique em **Adicionar proteção de diretório**.
2. Em **Diretório**, escreva o caminho da pasta depois de `/www`, ou clique em **Navegar...** e escolha a pasta.
3. Em **Título da área protegida**, escreva um nome para a área. É opcional.
4. Em **Nome de usuário**, escreva o nome com que a pessoa vai entrar.
5. Em **Senha** e **Confirme a senha**, digite a senha, ou clique em **Gerar**.
6. Clique em **Salvar**.

A tela responde *"A proteção de diretório para o diretório `<pasta>` foi criado com
sucesso e está disponível em alguns instantes."*

**A pasta é criada sozinha, se não existir.** A tela avisa *"Se o diretório
especificado não existir, ele será criado automaticamente."* Medido: uma pasta que
não existia apareceu vazia no Gerenciador de Arquivos, e o endereço dela passou a
pedir senha. O painel guarda o caminho com uma barra no fim: `/kb-protegido` virou
`/kb-protegido/`.

**A proteção vale para tudo o que está dentro da pasta.** Medido: a página de dentro
da pasta e os endereços abaixo dela também pediram senha.

**Navegar...** abre a lista das pastas logo abaixo do campo. Clicar numa pasta põe
o caminho dela no campo e mostra as pastas de dentro.

**Título da área protegida** é o nome que o servidor envia ao navegador junto com o
pedido de senha. O Chrome não o mostra: medido, a janela de login traz o endereço do
site, e não o título.

### A senha

**Enquanto você digita, a tela lista embaixo da Senha as regras que ainda faltam**,
com uma barra que mostra a força da senha. Medido com uma senha de três letras
minúsculas: faltavam *"Comprimento mínimo de 12 caracteres"*, *"Mínimo de uma letra
maiúscula \[A-Z]"* e *"Mínimo de um dígito \[0-9]"*.

**O painel também recusa senha conhecida.** Medido: ao salvar uma senha comum, a tela
respondeu *"A senha que você digitou é listada em um banco de dados das credenciais
usadas com mais frequência. Por favor, escolha uma senha mais segura."* Ela manteve
os outros campos e apagou os dois de senha.

**Guarde a senha antes de salvar.** O painel não a mostra depois: na edição, os
campos de senha vêm em branco.

## Entrar na pasta protegida

Quem abre um endereço da pasta vê o navegador pedir **nome de usuário** e **senha**.
Com os dois certos, a página abre. Medido: sem senha, e com a senha errada, o
servidor recusou da mesma forma, e com o usuário e a senha certos a página abriu.

No domínio do teste, com **Forçar conexão segura** ligada, o endereço com `http://`
mudou para `https://` antes de pedir a senha. Assim a senha viaja pela conexão
segura. A opção fica na edição do domínio: ver
[Editar um domínio](/keyhelp/editar-dominio).

## Mais de um usuário na mesma pasta

Cada proteção tem um nome de usuário só. **Para dar acesso a outra pessoa, crie outra
proteção para a mesma pasta**, com outro **Nome de usuário**. Medido com dois
usuários na mesma pasta: o painel aceitou a segunda proteção, a lista mostrou uma
linha para cada um, e os dois entraram, cada um com o próprio nome de usuário.

**Excluir a proteção de um usuário tira só o acesso dele.** Medido: depois de excluir
a linha de um dos dois, a pasta continuou pedindo senha, o usuário excluído foi
recusado e o outro continuou entrando. A pasta só abriu para todo mundo quando a
última proteção saiu.

## Liberar uma parte da pasta: exceções

* No formulário, clique em **Definir exceções** e escreva o caminho no campo **Exceções**.

O caminho é o do **endereço do site**, e não o da pasta no disco. A tela explica:
*"Insira os caminhos conforme aparecem na URL do domínio. Devido a possíveis regras
de reescrita, elas podem não refletir os caminhos reais em seu diretório inicial."*

**A exceção libera todo endereço que começa com o que você escreveu.** Por isso a
barra no fim muda o resultado. Medido numa pasta `/kb-protegido/` com uma pasta
`livre` dentro:

| Exceção escrita | Abriu sem senha | Continuou pedindo senha |
| - | - | - |
| `/kb-protegido/livre/` | `/kb-protegido/livre/` e o que está dentro dela | `/kb-protegido/livre`, sem a barra no fim, e o resto da pasta |
| `/kb-protegido/livre` | `/kb-protegido/livre/`, e também qualquer endereço que comece igual, como `/kb-protegido/livre-outra/` | o resto da pasta |

Com a exceção sem a barra, o endereço `/kb-protegido/livre` levou para
`/kb-protegido/livre/`, que abriu.

## Editar

* Na linha da proteção, clique no **lápis**.

Dá para trocar tudo: **Diretório**, **Exceções**, **Título da área protegida**,
**Nome de usuário** e **Senha**. Os campos de senha avisam *"Deixe em branco para
manter a senha atual."* A tela responde *"A proteção de diretório para o diretório
`<pasta>` foi atualizada com sucesso. As alterações entram em vigor em alguns
instantes."*

**A mudança vale quando a situação volta ao quadrado verde.** Medido: enquanto a lista
mostrava *"Processando"*, o site ainda seguia a regra antiga.

## Excluir

![Página Excluir confirmação: o diretório, o título da área protegida e o nome de usuário, com a caixa Confirmação](https://mintcdn.com/san-internet/ROiLhCzBw6wgVslN/keyhelp/imagens/protecao-excluir.png?fit=max\&auto=format\&n=ROiLhCzBw6wgVslN\&q=85\&s=fee26409bd157ec6432866958aa44da1)

1. Na linha da proteção, clique na **lixeira**.
2. Na página **Excluir confirmação**, confira o diretório e o usuário.
3. Marque **Confirmação** e clique em **Excluir**.

A tela responde *"Os seguintes itens foram excluídos."*, com a pasta e o usuário.

> [!WARNING]
>
> **Excluir a última proteção da pasta não apaga a pasta, e o que está nela fica aberto para qualquer pessoa**
>
> Medido: menos de um minuto depois de excluir a última proteção, a pasta e a página de dentro abriram
> sem senha, e as duas continuavam no Gerenciador de Arquivos. Para tirar os arquivos
> do ar, apague ou mova a pasta pelo
> [Gerenciador de Arquivos](/keyhelp/gerenciador-de-arquivos).

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| *"A senha que você digitou é listada em um banco de dados das credenciais usadas com mais frequência."* | a senha está numa lista de senhas comuns | escolher outra senha, ou usar o **Gerar** |
| **Regras em vermelho embaixo da Senha** | a senha ainda não cumpre alguma regra | completar o que a lista pede |
| **A pasta ainda segue a regra antiga logo depois de salvar** | a mudança leva alguns instantes, e a lista mostra *"Processando"* | esperar o quadrado verde e recarregar a página |
| **O navegador pede a senha de novo depois de digitar** | o usuário ou a senha não conferem | conferir os dois, ou trocar a senha no **lápis** |
| **Um endereço liberado pela exceção pede senha** | a exceção termina com barra, e o endereço foi aberto sem ela | abrir o endereço com a barra no fim |
| **Uma pasta com nome parecido ficou sem senha** | a exceção não termina com barra | pôr a barra no fim da exceção |
| **Quero dar acesso a mais uma pessoa** | cada proteção tem um nome de usuário só | criar outra proteção para a mesma pasta, com outro **Nome de usuário** |
| **Depois de excluir a proteção, a pasta abre para qualquer pessoa** | excluir a última proteção da pasta não apaga a pasta | apagar ou mover a pasta pelo Gerenciador de Arquivos |

## Ver também

* [Gerenciador de Arquivos](/keyhelp/gerenciador-de-arquivos), para ver, apagar ou mover o que está na pasta
* [Editar um domínio](/keyhelp/editar-dominio), com a **Forçar conexão segura**
* [Banco de dados](/keyhelp/banco-de-dados), outra tela que confere a senha contra regras


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.