> ## 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 (configuração)

> Decide se o servidor oferece webmail aos clientes, qual programa é esse, o que acontece no endereço webmail. de cada domínio, e a aparência do Roundcube: nome, logos e plugins.

**Caminho no painel:** menu da esquerda > Configuração > cartão **Ferramentas** >
**Webmail**

![Tela Webmail: a caixa Sim, o seletor Cliente webmail e o campo URL de acesso customizada](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/ferramentas-webmail.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=8988198116e44f1638a7dae5c2105231)

1. Ajuste os campos, explicados abaixo.
2. Clique em **Salvar**.

## Ligar, desligar e escolher o programa

| Campo | Vem com | O que faz |
| - | - | - |
| **Cliente webmail está ativado** | marcado | liga ou desliga o webmail do servidor inteiro |
| **Cliente webmail** | **Roundcube 1.7.3** | o programa de webmail. A outra opção é **SnappyMail 2.38.2 \| Desatualizado** |
| **URL de acesso customizada** | vazio | um endereço de webmail que não é o deste servidor, para os links do painel |

### Desligado, o que muda

**Conferido, desmarcando e salvando.** Vale na hora, sem esperar o minuto
seguinte, e o painel responde *"As configurações foram atualizadas."*

* o item **Webmail** some do menu do administrador e do menu do cliente
* o endereço `/webmail/` do servidor passa a responder **403**, acesso proibido
* o endereço `webmail.` dos domínios continua redirecionando para lá, e cai no mesmo 403

Marcar de novo e salvar devolve tudo, também na hora.

> [!WARNING]
>
> **Desligado, o ícone de envelope continua na tela do cliente**
>
> Em **Endereços de E-mail**, cada conta tem um ícone de envelope que abre o
> webmail. Medido: com o webmail desligado, **o ícone continua lá**, e leva à
> página de acesso proibido. O cliente vê um erro, e não um aviso de que o webmail
> foi desligado.

### SnappyMail

Escolher **SnappyMail** no seletor esconde oito campos da tela: **URL de suporte**,
**Tema da interface**, **Favicon**, os quatro campos de logo e **Plugins**. Fica só
**Nome do produto**. A aparência explicada mais abaixo, portanto, vale só para o
Roundcube.

**Conferido, trocando e voltando.** A troca é aplicada pela tarefa de fundo do
minuto seguinte, e o painel responde *"As configurações foram atualizadas. As
alterações terão efeito em alguns instantes."* Vale para **todos os clientes ao
mesmo tempo**: o endereço `/webmail/` passa a abrir o SnappyMail.

| O quê | Com o SnappyMail |
| - | - |
| Tela de entrada | com o **Nome do produto** no alto e no título da aba, no tema escuro do próprio SnappyMail, **sem logo** |
| Idioma da tela de entrada | **português de Portugal**: o campo de senha diz *"Palavra-passe"* |
| Ícone de envelope de cada conta, na área do cliente | abre `/webmail/` sem a conta no endereço, que é coisa do Roundcube |
| Painel de administração do próprio SnappyMail | **fechado**: o endereço dele responde *"Access Denied"* |

**A caixa de e-mail funciona igual.** Medido entrando com uma conta de teste: a
mesma senha abriu as mesmas mensagens. Na primeira entrada, o SnappyMail abre
sozinho a janela **Atualizar identidade**, pedindo um nome para a conta.

**Voltar para o Roundcube devolveu tudo**, conferido contra uma leitura feita
antes: os campos de aparência e os plugins do Roundcube ficam guardados enquanto o
SnappyMail está em uso, e voltam valendo.

### URL de acesso customizada

**Conferido com um endereço inventado.** A mudança vale na hora e troca três
links:

| Onde | Passa a abrir |
| - | - |
| **Webmail**, no menu do administrador | o endereço novo |
| **Webmail**, no menu do cliente | o endereço novo |
| o ícone de envelope de cada conta, em **Endereços de E-mail** | o endereço novo, com a conta no fim (`?_user=`) |

**O painel não confere se o endereço existe.** Ele aceitou um endereço que não
existe, e os links passaram a levar a lugar nenhum. **O webmail do próprio
servidor continua no ar** em `/webmail/`: só os links do painel mudam.

Para voltar, apague o campo e clique em **Salvar**.

## O endereço `webmail.` de cada domínio

![Opções do Comportamento do subdomínio do webmail: Redirecionamento, Mantenha o nome do domínio e a versão Inseguro](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/ferramentas-webmail-subdominio.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=9cc9c93eaa2bba1af513fadbaf23ff1d)

Todo domínio do servidor tem também um endereço `webmail.` na frente do nome. Ele
existe sem ninguém criar: **a zona de DNS que o painel monta para cada domínio
tem um registro curinga**, que responde por qualquer nome dentro dele. Se o DNS
do domínio estiver em outro lugar, o nome `webmail.` precisa ser criado lá.

**Medido nos três modos**, em http e em https:

| Opção | `http://webmail.` do domínio | `https://webmail.` do domínio |
| - | - | - |
| **Redirecionamento**, o padrão | vai para o webmail no endereço do painel | vai para o webmail no endereço do painel |
| **Mantenha o nome do domínio** | vai para a versão https do mesmo nome | **abre o webmail ali mesmo** |
| **Mantenha o nome do domínio \| Inseguro** | **abre o webmail ali mesmo, sem https** | abre o webmail ali mesmo |

Esta mudança é aplicada pela tarefa de fundo do minuto seguinte, e o painel
responde *"As configurações foram atualizadas. As alterações terão efeito em
alguns instantes."*

> [!WARNING]
>
> **Em `https://webmail.` o navegador acusa conexão não segura, nos três modos**
>
> Medido: nesse endereço o servidor apresenta o certificado do serviço de webmail,
> que neste servidor é o **autoassinado do painel**, feito para o nome do
> servidor. Um certificado só vale para os nomes escritos nele, e cada domínio de
> cliente é um nome diferente. No modo **Redirecionamento** o aviso aparece antes
> do redirecionamento; nos outros dois, o webmail inteiro fica atrás dele.
>
> O certificado se escolhe em **SEGURANÇA** > **Certificados SSL/TLS** > botão
> **Serviços de servidor seguro**, na linha **Subdomínio do Webmail**. Ali só
> aparecem o `default`, que é o autoassinado, e os certificados já cadastrados no
> painel, inclusive os de clientes. **O Let's Encrypt não é oferecido para essa
> linha**, ao contrário das linhas do painel, do e-mail e do FTP.
>
> **Medido trocando e voltando:** a troca vale no minuto seguinte, e **todos os
> endereços `webmail.` passam a apresentar o mesmo certificado**, de qualquer
> domínio. Um certificado só não carrega o nome de todos os clientes, então o
> aviso continua para quem não estiver no certificado escolhido.

> [!WARNING]
>
> **No modo Inseguro, a senha do e-mail pode passar sem criptografia**
>
> O próprio texto da tela avisa: com essa opção, o acesso por `http://` é
> possível. Quem entrar por esse endereço digita a senha numa página sem https, e
> ela trafega aberta pela rede.

## A aparência do Roundcube

![Campos de aparência do Roundcube: nome do produto, URL de suporte, tema, favicon, logos e plugins](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/ferramentas-webmail-roundcube.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=f8dd2af05546332622fe0e9085bcc9bd)

| Campo | O que faz |
| - | - |
| **Nome do produto** | o nome que o webmail mostra. Conferido: com **Webmail SAN**, o título da aba da tela de entrada ficou *"Webmail SAN :: Bem-vindo ao Webmail SAN"* |
| **URL de suporte** | o endereço do link **Obter suporte**, na tela de entrada do Roundcube |
| **Tema da interface** | só existe **Elastic** |
| **Favicon** | endereço do ícone da aba do navegador |
| **Logo** e **Modo escuro** | endereço do logo de dentro do webmail, e a versão para o modo escuro |
| **Logo para a área de login** e **Modo escuro** | o mesmo, para a tela de entrada |
| **Plugins** | os complementos do Roundcube, separados por vírgula. A lista de fábrica está escrita na própria tela. Nesta instalação ela tem também `san_webmail`, um plugin próprio que muda a tela de entrada |

**Os campos de imagem pedem endereço, e não arquivo.** A imagem precisa abrir
**sem login**, porque o webmail mostra o logo na tela de entrada, antes de alguém
entrar. As imagens já enviadas no [White Label](/keyhelp-admin/white-label) do
painel servem, e é o que a tela acima usa: elas ficam num endereço do próprio
servidor que abre sem login.

**O webmail segue o modo escuro do navegador**, e não o do painel. Com o navegador
em modo escuro, ele troca sozinho para os logos dos campos **Modo escuro**.

### O que cada plugin da lista de fábrica faz

**Medido dentro do Roundcube**, com uma conta de teste logada:

| Plugin | O que ele acrescenta |
| - | - |
| `managesieve` | as seções **Filtros** e **Fora do Escritório**, em **Configurações** |
| `password` | a seção **Senha**, em **Configurações**, para a pessoa trocar a senha da conta |
| `markasjunk` | o botão **Spam**, na barra da caixa de entrada |
| `keyhelp_sync_identities` | mantém as **identidades** do webmail iguais aos endereços da conta no painel, e trava o campo de e-mail de identidade nova |

**A sincronização acontece no login.** Medido: um alias criado na conta de e-mail,
pelo painel, apareceu como identidade no login seguinte; removido o alias, a
identidade sumiu no login seguinte. Em **Configurações** > **Identidades**, o botão
**Criar** abre o formulário com o campo **E-mail** travado no endereço da conta.

> [!WARNING]
>
> **Todo Salvar desta tela regrava a configuração do Roundcube e troca duas chaves internas**
>
> Medido em sete salvamentos: o arquivo de configuração do Roundcube foi gravado
> de novo a cada um, **mesmo quando só o modo do subdomínio mudou**. Conferido
> linha a linha em três deles, **sempre as mesmas duas linhas mudaram**: a senha
> que o Roundcube usa para falar com o próprio banco de dados e a chave com que
> ele cifra a senha guardada na sessão de quem está logado. O webmail continuou
> abrindo depois de todos.
>
> Duas consequências. Uma edição feita à mão nesse arquivo não sobrevive ao
> próximo **Salvar**. E **quem estiver com o webmail aberto perde o acesso à caixa**.
> Medido com uma conta logada no Roundcube e um **Salvar** sem nenhuma mudança: a
> tela continuou aberta, mas as pastas e as mensagens sumiram, com os avisos
> *"Falha na conexão com o servidor. Verifique se informou os dados
> corretamente."* e *"Erro no Servidor: Empty password"*. Para voltar, a pessoa
> precisa clicar em **Sair** e entrar de novo.

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **O cliente clica no envelope e recebe acesso proibido** | o webmail foi desligado aqui, e o ícone continua na tela dele | marcar **Cliente webmail está ativado** e salvar |
| **O navegador acusa certificado inválido em `https://webmail.` do domínio** | o endereço usa o certificado do serviço de webmail, que não traz o nome do domínio do cliente | usar o webmail pelo endereço do painel, ou ver o certificado em **Serviços de servidor seguro** |
| O link de webmail do painel não abre nada | a **URL de acesso customizada** aponta para um endereço que não responde | apagar o campo e salvar |
| `webmail.` do domínio não abre | o DNS do domínio está fora deste servidor e não tem esse nome | criar o nome `webmail.` no DNS de onde o domínio está |
| O logo não aparece na tela de entrada do webmail | a imagem do endereço informado pede login, ou o endereço está errado | abrir o endereço da imagem numa janela anônima do navegador |
| A tela de entrada do webmail ficou escura, sem logo e em português de Portugal | o **Cliente webmail** está no SnappyMail, que não usa os campos de aparência | voltar para **Roundcube** e salvar; os campos de aparência voltam valendo |
| Mudei o arquivo de configuração do Roundcube à mão e a mudança sumiu | o painel regrava o arquivo inteiro a cada **Salvar** desta tela | fazer a mudança pelos campos desta tela |
| **Os clientes logados no webmail recebem *"Erro no Servidor: Empty password"*** | alguém salvou esta tela, e a chave que abre a senha guardada na sessão mudou | cada um clica em **Sair** e entra de novo |

## Ver também

* [Webmail](/keyhelp-admin/webmail), o item do menu que abre o webmail, e o bloqueio por senha errada
* [White Label](/keyhelp-admin/white-label), onde ficam as imagens que o webmail pode usar
* [Certificados SSL/TLS (configuração)](/keyhelp-admin/config-certificados-ssl-tls), que aponta para a escolha do certificado de cada serviço
* [Editor de DNS](/keyhelp-admin/editor-de-dns), a zona de cada domínio, onde está o registro curinga
* [Modo de Manutenção](/keyhelp-admin/modo-de-manutencao), que fecha o painel e deixa o webmail no ar


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