> ## 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.

# Acesso e Sessão

> Ajusta como o painel trata o login e a sessão: o tempo que uma sessão parada fica aberta, o freio contra tentativas repetidas de login, a trava da sessão no IP de quem entrou, e a…

**Caminho no painel:** menu da esquerda > Configuração > cartão **Segurança** >
**Acesso e Sessão**

![Tela Acesso e Sessão: força bruta, tempo ocioso, travar no IP, restrição de administrador e a nota do keyhelp-toolbox](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/seguranca-acesso-e-sessao.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=0f30b98fd722ceda684e91b8970b4c76)

As mudanças valem na hora. O painel responde *"As configurações foram atualizadas."*

## Proteção força bruta

O tempo **máximo**, em segundos, por que o painel segura as próximas tentativas de
login de uma faixa de IP quando ela erra muitas vezes. A tela fala em máximo: é o
teto da espera, e não a espera de cada tentativa.

O campo tem uma unidade ao lado, **Segundos**, **Minutos** ou **Horas**. **O painel
guarda o valor já convertido em segundos.** Medido: `2` em **Horas** foi gravado
como `7200`. A unidade serve para digitar, e o número volta à tela nela.

**Este é o freio do próprio painel, e não o Fail2Ban.** O Fail2Ban é outra tela,
no menu **SEGURANÇA**, e trabalha na camada do servidor.

## Tempo ocioso da sessão

Quanto tempo uma sessão parada fica aberta antes de o painel desconectar por
inatividade. Também tem a unidade ao lado, e também é guardado em segundos: `30` em
**Minutos** virou `1800`.

## Bloquear sessão no endereço IP

Marcado, o painel prende a sessão ao IP que estava no login: se o IP de quem entrou
mudar no meio, a sessão cai. A tela explica que é mais seguro, mas atrapalha quem
tem IP que muda sozinho, como algumas conexões domésticas e de celular.

**Conferido:** ligar a opção não derruba quem está com IP fixo, a sessão em curso
seguiu aberta.

## Restrição de acesso a contas de administrador

Aqui você limita **de quais IPs um administrador pode fazer login**. A tela é clara
em dois pontos: vale **só para contas de administrador**, não para as de cliente, e
aceita IP solto ou faixa de rede (máscara).

1. Em **Restrição de acesso a contas de administrador**, escreva um IP ou uma faixa por linha.
2. Em **Listar atividades como…**, escolha o modo:
   * **Lista Negra**: bloqueia o login dos IPs escritos.
   * **Lista Branca**: só deixa entrar os IPs escritos, e bloqueia todo o resto.
3. Clique em **Salvar**.

**Enquanto o campo está vazio, os dois modos ficam apagados**, com a **Lista Negra**
marcada e sem como trocar. A escolha só se abre depois que há ao menos um endereço
no campo.

> [!WARNING]
>
> **Lista Branca com o IP errado tranca o login de administrador**
>
> Na **Lista Branca**, quem entra de um IP que não está na lista não consegue mais
> fazer login como administrador. **A sessão já aberta continua**: medido, com uma
> Lista Branca de um IP que não era o do teste, o painel seguiu abrindo
> normalmente para a sessão em curso. O corte é no **próximo login**.
>
> Por isso, ao usar a Lista Branca, inclua o IP de onde você entra **antes** de
> salvar. Se você já está trancado, a saída é a que a própria tela mostra: rodar no
> console do servidor o programa **`keyhelp-toolbox`**, que desliga a restrição.

> [!NOTE]
>
> **A tela de login não diz que o problema é o seu IP**
>
> A restrição é conferida **depois** da senha. Medido: com uma Lista Branca ativa,
> uma tentativa de login vinda de um IP de fora dela, com senha errada, recebeu a
> **mesma resposta** de qualquer senha errada, tanto numa conta de administrador
> quanto numa de cliente. Quem erra a senha e quem está barrado pelo IP veem a mesma
> coisa, então o IP restrito não se descobre pela tela de login.

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **Não consigo mais fazer login como administrador** | uma Lista Branca sem o seu IP, ou uma Lista Negra com ele | no console do servidor, rodar `keyhelp-toolbox` e desligar a restrição de acesso |
| Minha sessão cai quando troco de rede | **Bloquear sessão no endereço IP** está ligado, e o seu IP muda | desligar a opção, ou usar uma conexão de IP fixo |
| O login fica preso por um tempo depois de eu errar a senha | é a **Proteção força bruta**, segurando as tentativas daquela faixa de IP | esperar. O tempo da tela é o máximo da espera |
| O valor de segundos ficou diferente do que digitei | o painel guarda em segundos, e a unidade só ajuda a digitar | conferir a unidade escolhida |
| O cliente reclama que a restrição de IP não o afeta | ela vale só para administrador | é o comportamento da tela |

## Ver também

* [Senha e acesso ao painel](/keyhelp-admin/senha-e-acesso-ao-painel), o login e a verificação em duas etapas de cada conta
* [Política de Senha](/keyhelp-admin/politica-de-senha), as regras da senha que o painel exige


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