# Restringir cPanel por IP no WHM (e por que SSH não entra)

Como restringir cPanel, WHM, webmail e e-mail por faixa de IP sem se trancar do lado de fora, e por que a regra de SSH nessa tela provavelmente não faz nada.

> o Host Access Control (WHM » Security Center) edita `/etc/hosts.allow` e restringe por IP os daemons que consultam libwrap: cpaneld, whostmgrd, webmaild, exim e dovecot. SSH, Apache e LiteSpeed não entram: o OpenSSH removeu o suporte a tcpwrappers na versão 6.7.

João Rizzon · 2026-10-19 · Servidores

---

## O que o Host Access Control escreve, de fato

A tela fica em **WHM » Home » Security Center » Host Access Control**. Ela não é um firewall: é um editor com validação para o arquivo `/etc/hosts.allow`, lido pela biblioteca libwrap (tcpwrappers). A [documentação do cPanel](https://docs.cpanel.net/whm/security-center/host-access-control/) descreve a interface com três campos por linha: **Daemon**, **Access List** e **Action**.

Três consequências práticas disso, e elas mudam o procedimento:

- Não existe reload de serviço. O arquivo é consultado no momento da conexão, por conexão. Salvou, valeu na próxima tentativa de handshake. Desfez, voltou na mesma hora. Isso é o que torna a reversão barata.
- A avaliação é por primeira correspondência. A primeira linha que casa daemon e cliente decide, e o resto do arquivo não é lido para aquela conexão.
- Só vale para daemons que consultam libwrap. Um serviço que não foi compilado contra a biblioteca ignora o arquivo inteiro, em silêncio, sem log e sem erro.

O campo Action aceita `allow` e `deny`. A sintaxe estendida do tcpd também aceita shell commands (`spawn`, `twist`), que a tela repassa para o arquivo. Em produção, use `allow` e `deny` e resolva alerta em outro lugar: comando disparado por conexão é superfície de ataque e ponto de lentidão no caminho do handshake.

## A rota de reversão vem antes da primeira regra

O motivo de a busca por isso ser alta e a execução ser baixa é um só: a chance de trancar o próprio acesso. Monte a rede de segurança primeiro.

### Backup do arquivo com timestamp no nome

```bash
B=/root/hosts.allow.$(date +%F-%H%M)
cp -a /etc/hosts.allow "$B"
echo "$B"
```

Guarde o caminho impresso: é ele que vai no job de restore do passo 3. Se preferir não depender da variável sobreviver à sessão, use um nome fixo (`/root/hosts.allow.BACKUP`) e mantenha a cópia com timestamp só como histórico.

### A segunda sessão SSH que não pode ser fechada

Abra um terminal root por SSH e deixe parado nele, sem sair. Conexão já estabelecida não é reavaliada pelo tcpwrappers: a checagem acontece no accept, não durante a sessão. Essa sessão é sua chave reserva.

### Restore agendado com at para o caso de você se trancar

```bash
echo "cp -a $B /etc/hosts.allow" | at now + 10 minutes
```

Aspas duplas, de propósito: a variável expande agora, na hora de criar o job, e o `at` guarda o caminho literal do backup que você acabou de fazer. Com aspas simples o job gravaria `$B`, que não existe no ambiente do `atd`, e o restore falharia em silêncio. Confira o que ficou agendado com `at -c <id>` antes de confiar.

Se em dez minutos você validou tudo, remova o job com `atq` e `atrm <id>`. Se você se trancou, não precisa fazer nada: o arquivo volta sozinho. Confira antes se o `atd` está ativo (`systemctl is-active atd`); se não estiver, use uma entrada de cron equivalente.

### Onde fica o seu acesso fora de banda e como testá-lo antes

Console KVM, VNC do painel do provedor, modo rescue. Descubra onde fica e teste o login **antes**, não durante o incidente. Esse caminho não passa por `/etc/hosts.allow`.

## Por que a regra de liberação tem que vir acima da negação

Como vale a primeira correspondência, a regra de liberação precisa estar acima da regra de bloqueio. Invertido, o deny casa primeiro e o allow nunca é lido.

Um conjunto mínimo, com faixas de exemplo (substitua pelas suas, estes valores são fictícios):

```
# /etc/hosts.allow
# 1. escape: localhost e a rede interna do servidor
ALL : 127.0.0.1 : allow
ALL : 10.0.0.0/255.255.255.0 : allow

# 2. faixas autorizadas da empresa (exemplos)
cpaneld, whostmgrd, webmaild : 203.0.113.0/255.255.255.0 : allow
cpaneld, whostmgrd, webmaild : 198.51.100.17 : allow

# 3. negação final, só para os daemons acima
cpaneld, whostmgrd, webmaild : ALL : deny
```

Pontos que costumam custar caro:

- O primeiro `ALL : 127.0.0.1 : allow` é o escape. Vários componentes do cPanel conversam com o próprio servidor por loopback. Negar localhost quebra tarefas internas antes de quebrar o seu login.
- Evite `ALL : ALL : deny` como última linha enquanto estiver aprendendo o comportamento da sua máquina. Negue por daemon nomeado. O bloqueio geral alcança serviços que você não mapeou.
- Máscara explícita (`/255.255.255.0`) e CIDR (`/24`) descrevem exatamente a mesma faixa: a diferença é de portabilidade, não de segurança. A máscara em notação completa é aceita por qualquer build do tcp_wrappers; o suporte a CIDR depende de patch da distribuição. Na dúvida, use a máscara explícita, e se usar CIDR valide com `tcpdmatch` antes de confiar.

## Os serviços que ignoram /etc/hosts.allow em silêncio

Esta é a parte que invalida a frase "restringi o painel inteiro por IP".

| Serviço | Entrada típica | Consulta libwrap | Observação |
|---|---|---|---||
| cPanel (2082/2083) | `cpaneld` | sim | serviço do cpsrvd |
| WHM (2086/2087) | `whostmgrd` | sim | serviço do cpsrvd |
| Webmail (2095/2096) | `webmaild` | sim | serviço do cpsrvd |
| Exim (25/465/587) | `exim` | depende da build (validar com `ldd`) | cuidado ao negar a porta 25 de fora |
| Dovecot (110/143/993/995) | `dovecot` | depende da build (validar com `ldd`) | o suporte é opção de compilação |
| Pure-FTPd / ProFTPD | `pure-ftpd`, `proftpd` | depende da build | validar com `ldd` |
| OpenSSH | `sshd` | **não**, nas versões atuais | suporte a tcpwrappers removido no OpenSSH 6.7 |
| Apache httpd (80/443) | nenhuma | **não** | não é linkado contra libwrap |
| LiteSpeed / OpenLiteSpeed | nenhuma | **não** | restrição é no vhost ou no firewall |
| MySQL / MariaDB | nenhuma | **não** em builds comuns | use `bind-address`, grants e firewall |

O caso do SSH é o que mais engana, porque a tela do WHM aceita `sshd` como daemon sem reclamar. O upstream do OpenSSH removeu o suporte a libwrap na versão 6.7, e as distribuições usadas hoje em servidores cPanel estão muito acima disso. Logo, uma regra `sshd : ALL : deny` pode não bloquear nada. Confirme na sua máquina, não no texto:

```bash
ldd $(which sshd) | grep -i libwrap
ldd $(which pure-ftpd) | grep -i libwrap
ldd /usr/sbin/exim | grep -i libwrap
ldd /usr/sbin/dovecot | grep -i libwrap
```

Sem saída, o daemon não lê `/etc/hosts.allow`, mesmo que a tela do WHM tenha aceitado a regra. Vale também para exim e dovecot: o link contra libwrap é opção de compilação do empacotador, então não assuma pelo nome do daemon. O que não aparece com `libwrap` precisa ser resolvido em firewall de pacotes.

O ponto de tráfego web (Apache, LiteSpeed) também não passa por ali. Se o objetivo é fechar o `/wp-admin` ou uma rota administrativa por IP, isso é regra de vhost ou `.htaccess`, não Host Access Control.

## Testar de uma rede autorizada e de uma bloqueada

Teste sintaxe e teste comportamento. São checagens diferentes.

### Checar a sintaxe com tcpdchk e simular com tcpdmatch

```bash
tcpdchk -v
tcpdmatch cpaneld 203.0.113.10
tcpdmatch cpaneld 192.0.2.50
```

O `tcpdchk` aponta daemons desconhecidos e regras inalcançáveis. O `tcpdmatch` responde `access: granted` ou `access: denied` para o par daemon/cliente, sem abrir conexão. Os binários vêm do pacote `tcp_wrappers` (em algumas distribuições, `tcp_wrappers-tools`).

### Como o bloqueio aparece na conexão real, dos dois lados

De um IP autorizado:

```bash
nc -vz servidor.exemplo.com 2083
```

De um IP que deve estar bloqueado (4G do celular, VPS externo, VPN de outra região):

```bash
nc -vz servidor.exemplo.com 2083
```

O comportamento esperado com tcpwrappers é característico: o TCP **conecta** e a conexão é fechada em seguida, porque a decisão acontece depois do accept, na camada de aplicação. Não é timeout silencioso como no `DROP` do iptables. Se você vê timeout, quem bloqueou foi outra coisa, provavelmente o firewall.

Acompanhe o log durante o teste:

```bash
tail -f /var/log/messages /var/log/secure
```

Só depois que as duas pontas do teste baterem com o esperado, cancele o job do `at`.

## Quando o link do escritório troca de IP

IP dinâmico é o calcanhar de aquiles desse desenho. Três caminhos, em ordem de robustez:

- **IP fixo onde dói**: um VPS pequeno ou uma VPN corporativa com saída estática. Você libera um endereço só, e todo mundo entra por ele. É a opção que menos quebra e a que menos exige manutenção no arquivo.
- **Hostname na Access List**: o tcpwrappers aceita nome e resolve por DNS reverso do cliente, com confirmação direta. Depende de o PTR da operadora existir e bater, o que raramente acontece em link residencial ou em 4G. Resolução no caminho do handshake também adiciona latência e um ponto de falha novo. Trate como recurso de exceção.
- **Atualização automatizada**: um script que resolve um host de DNS dinâmico e reescreve o bloco de allow. Se for por esse caminho, mantenha a geração idempotente (um bloco delimitado por marcadores, reescrito inteiro) e nunca remova a linha de loopback nem a sua faixa de administração.

E deixe escrito no runbook: quem tem o console fora de banda, onde está a credencial e qual é o comando de restore. Troca de link costuma acontecer em dia de pressa.

## CSF é camada complementar, não substituto

O Host Access Control resolve bem o que está dentro do seu alcance: os serviços do cpsrvd, e-mail e FTP quando a build suporta. Ele não resolve SSH nas versões atuais do OpenSSH, não resolve porta 80/443 e não resolve banco de dados.

A divisão que funciona:

- **Firewall de pacotes (CSF/iptables/nftables)**: fecha portas no nível de rede, inclusive SSH, MySQL e qualquer serviço que ignore libwrap. É a primeira barreira e a única que vale para tudo.
- **Host Access Control**: segunda barreira, por daemon, útil porque sobrevive a uma regra de firewall mal aplicada e porque é editável por quem administra o WHM sem acesso de shell.
- **Camada da aplicação**: restrição de rota administrativa no vhost, 2FA no WHM, chave em vez de senha no SSH.

Se você precisa escolher uma só e o objetivo é restringir SSH por IP, escolha o firewall. Restringir SSH apenas pelo `/etc/hosts.allow` é a falsa sensação de segurança mais comum nesse assunto, e a verificação com `ldd` leva cinco segundos.

