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

# Webmail

> Abre o webmail, o programa de ler e mandar e-mail pelo navegador, com a conta de e-mail de qualquer domínio deste servidor.

**Caminho no painel:** menu da esquerda > **FERRAMENTAS** > **Webmail**

![Tela de entrada do webmail: o logo, o campo Endereço de e-mail com o exemplo nome@seudominio.com.br, o campo Senha, o botão Entrar e o link Obter suporte](https://mintcdn.com/san-internet/gD6hsj0ABwoHZHWu/keyhelp-admin/imagens/webmail-entrada.png?fit=max\&auto=format\&n=gD6hsj0ABwoHZHWu\&q=85\&s=8f4b6b544ddbb47504cc4ef2465d4780)

1. No menu da esquerda, clique em **Webmail**. A tela de entrada abre numa aba nova.
2. Em **Endereço de e-mail**, digite o endereço completo, como `contato@seudominio.com.br`.
3. Em **Senha**, digite a senha dessa conta de e-mail.
4. Clique em **Entrar**.

**O endereço e a senha são os da conta de e-mail, e não os do painel.** O webmail
confere o endereço e a senha na lista de contas de e-mail do servidor, onde o
usuário do painel não existe.

> [!WARNING]
>
> **O navegador pode preencher esta tela com o login do painel**
>
> O webmail fica no mesmo endereço do painel. Medido: o navegador que guardou o
> usuário e a senha do painel preencheu os dois campos desta tela com eles, sem
> ninguém pedir. Apague e digite os dados da conta de e-mail: tentar com os dados do
> painel conta como senha errada.

## Senha errada, e o bloqueio que ela pode causar

Com endereço ou senha errados, a tela continua na entrada e mostra *"Falha no
login"*. Medido: a tentativa contou como um erro na regra do webmail, descrita
abaixo.

> [!WARNING]
>
> **Quatro senhas erradas em 10 minutos tiram o seu endereço do servidor inteiro**
>
> O servidor tem um vigia de tentativas erradas, o Fail2Ban, com uma regra própria
> para o webmail: **4 senhas erradas em 10 minutos, vindas do mesmo endereço IP,
> bloqueiam esse endereço por 10 minutos**. A configuração do servidor aumenta o
> tempo a cada novo bloqueio do mesmo endereço, até duas semanas: na lista de
> bloqueios do servidor havia endereços com 20 minutos, 40 minutos e 14 dias.
>
> Medido com um endereço de teste: o bloqueio da regra do webmail fecha as portas
> 80 e 443 do servidor, que são as do painel e as dos sites. **Quem é bloqueado
> fica sem o webmail, sem o painel e sem os sites**, e todos os computadores que
> saem para a internet pelo mesmo endereço, como os de um escritório, vão junto.

Cada erro fica contado por 10 minutos. Depois disso, ele deixa de contar.

### Desbloquear antes do tempo

O administrador desbloqueia pelo painel, na tela
[Gerenciamento do Fail2Ban](/keyhelp-admin/gerenciamento-do-fail2ban),
entrando de uma conexão que não foi bloqueada, como os dados móveis do celular:

1. No menu da esquerda, clique em **SEGURANÇA** > **Gerenciamento do Fail2Ban**.
2. Na lista, marque a caixa da linha do endereço bloqueado. Na coluna **BANIDO PELA PRISÃO**, o bloqueio do webmail aparece como `kh-roundcube`.
3. Em **Ações em massa**, escolha **Desbloquear os IPs selecionados** e clique em **Aplicar**.
4. Na janela *"Tem certeza de que deseja cancelar o bloqueio dos itens selecionados?"*, clique em **Sim**.

O painel responde *"Os IPs selecionados foram desbloqueados."* Medido com o
endereço de teste: o bloqueio saiu do servidor na hora. **Marque só a linha certa:**
a lista traz também os endereços bloqueados pelas outras regras, como os que
tentaram entrar por SSH.

## O que o administrador controla

O programa, o nome, os logos e o que acontece com o endereço `webmail.` de cada
domínio se ajustam em [Webmail (configuração)](/keyhelp-admin/config-webmail).
Com o webmail desligado lá, este item some do menu.

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **O painel, os sites e o webmail pararam de abrir de um computador, e de outros continuam** | o endereço desse computador errou a senha do webmail 4 vezes em 10 minutos e foi bloqueado | esperar o bloqueio acabar, ou desbloquear de outra conexão, como explicado acima |
| *"Falha no login"* | endereço ou senha errados | conferir o endereço completo e a senha da conta de e-mail |
| A senha do painel não abre o webmail | o webmail pede a conta de e-mail | usar o endereço de e-mail e a senha dele |
| O item **Webmail** sumiu do menu | o webmail foi desligado em [Webmail (configuração)](/keyhelp-admin/config-webmail) | ligar lá |
| O link abre um endereço que não responde | a configuração tem uma **URL de acesso customizada** | conferir o campo em [Webmail (configuração)](/keyhelp-admin/config-webmail) |

## Ver também

* [Webmail (configuração)](/keyhelp-admin/config-webmail), onde se escolhe o programa e a aparência
* [Interface Web do Banco de Dados](/keyhelp-admin/interface-web-do-banco-de-dados), a outra ferramenta de navegador deste grupo, com o mesmo bloqueio
* [Gerenciamento do Fail2Ban](/keyhelp-admin/gerenciamento-do-fail2ban), onde se desbloqueia um endereço e se isenta um endereço dos bloqueios
* [Firewall](/keyhelp-admin/firewall), as regras fixas do servidor, que o bloqueio do Fail2Ban não muda


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