# Usuário WHM para técnico sem entregar a senha de root

O WHM só aceita login não-root por meio de privilégios de revenda, mas dá para usar esse mecanismo como acesso de técnico, com ACLs mínimas, validação por login e revogação limpa.

> crie no WHM uma conta com privilégio de revenda, limite de contas definido e só as ACLs de criar conta, usar os pacotes que você criar para ela e reiniciar serviço, sem acesso total.

João Rizzon · 2026-11-16 · Servidores

---

## Não existe login de técnico no WHM: o que existe é conta de revenda com ACLs

No WHM não existe um tipo de login chamado "técnico". O único jeito de alguém entrar na interface do WHM sem a senha de root é ser uma conta com **privilégios de revenda**, e o que essa conta enxerga é definido por uma lista de ACLs (Access Control Lists). A documentação oficial do cPanel reúne essas permissões na página de [ACLs](https://docs.cpanel.net/tags/acls/).

Tecnicamente, o usuário do técnico será um revendedor; na prática, não precisa agir como um: sem vender contas, só com os pacotes que root criar para ele, com limite de contas definido, sem domínio de cliente, só com as permissões que o trabalho exige. O que separa um revendedor de um técnico restrito é a lista de ACLs que você marca, não o mecanismo.

A outra ponta também precisa ficar clara. Há uma permissão que equivale a root dentro do WHM (na interface aparece como acesso total, "Everything" ou "Root Access", conforme a versão). Marcou essa, o técnico tem o mesmo poder que você. O objetivo deste guia é nunca chegar perto dela.

## Quando esse meio-termo resolve e quando não resolve

Antes de criar o usuário, vale conferir se ele é a ferramenta certa. Para agência com servidor próprio, os cenários costumam ser estes:

| Situação | Ferramenta adequada | Por quê |
|---|---|---||
| Técnico precisa mexer só em e-mail ou arquivos de um site | Subconta no cPanel do cliente | Não precisa de WHM |
| Técnico cria contas novas e reinicia serviço travado | Conta com privilégio de revenda e ACLs mínimas | Caso deste guia |
| Script ou integração que cria contas automaticamente | Token de API no WHM com ACLs restritas | Sem login interativo, revogável sozinho |
| Técnico precisa editar configuração global, PHP, Apache, firewall | Root, com chave SSH individual | ACL nenhuma cobre isso com segurança |

Se a tarefa do técnico cai na última linha com frequência, criar um usuário restrito só adia a conversa. Melhor dar acesso root com chave SSH própria, registrar e revogar quando ele sair.

## Por que as contas antigas não aparecem para o técnico

Uma conta com privilégio de revenda só administra as contas que **pertencem a ela**. As contas dos seus clientes, criadas por root, pertencem a root. O técnico entra no WHM, procura o site do cliente e não encontra.

Há duas saídas, e as duas têm custo:

- **Transferir a propriedade** das contas para o usuário do técnico, em *Resellers » Change Ownership of an Account*. Funciona, mas as contas passam a ser do técnico. Se ele sair, você precisa devolver tudo para root antes de remover o usuário.
- **Limitar o técnico a contas novas.** Ele cria e cuida das contas que ele mesmo abriu; as antigas continuam com root. Só que as contas que ele cria também pertencem a ele e precisam voltar para root quando ele sair.

Para a maioria das agências, a segunda opção mexe menos no que já existe, mas não elimina o custo da revogação, só o adia: cada site novo que o técnico abrir vira mais uma conta para devolver a root na saída. Nas duas opções, mantenha por escrito a lista de contas que pertencem ao técnico, transferidas ou criadas por ele, porque a reversão é manual.

## Passo a passo para criar o usuário do técnico

Os caminhos abaixo são os da interface do WHM. Os rótulos exatos das permissões mudam entre versões; confira a lista atual na [documentação de ACLs](https://docs.cpanel.net/tags/acls/) antes de marcar.

### Crie a conta base

Em *Account Functions » Create a New Account*, crie uma conta com um domínio interno seu (por exemplo, `tecnico.suaagencia.com.br`, um exemplo fictício). Use um nome de usuário que identifique a pessoa, não a função: `joao` é melhor que `suporte`, porque o log mostra quem fez o quê.

Marque **Make this account a reseller** e, se aparecer a opção, **Make the account own itself**. A segunda faz a conta pertencer a si mesma em vez de a root.

### Defina o limite de contas

Em *Resellers » Edit Reseller Nameservers and Privileges*, selecione o usuário. Se a função do técnico não for criar contas, deixe o limite de contas em zero. Se for, coloque o limite que a operação justifica e não deixe ilimitado.

### Desmarque tudo e marque só o necessário

Na mesma tela, desmarque todas as permissões e marque apenas as que correspondem às tarefas. Para o perfil "cria conta e reinicia serviço", procure por:

- criação de conta (*Account Creation* ou equivalente);
- uso dos pacotes disponíveis para ele, sem permissão de criar ou editar pacotes;
- reinício de serviços (*Restart Services* ou equivalente);
- como extra opcional, fora do perfil padrão: restauração de backup, se a sua versão oferecer essa permissão para revenda.

Atenção aos pacotes: o revendedor normalmente não enxerga os pacotes criados por root. Sem pacote próprio e sem permissão de criar pacotes, a tela de criação de conta fica sem opção utilizável. A saída é root criar, em *Packages » Add a Package*, os pacotes que o técnico deve usar com o nome do usuário como prefixo (por exemplo, `joao_basico`), convenção que o WHM usa para disponibilizar o pacote àquele revendedor. Confira essa regra na documentação da sua versão e valide no login de teste.

Não marque nada da categoria de acesso total nem permissões identificadas na documentação como privilégios que afetam todos os usuários do servidor. Quando houver dúvida sobre o alcance de uma ACL, deixe desmarcada e teste: é mais barato liberar depois do que descobrir o estrago.

### Salve como lista reutilizável

A mesma tela permite salvar o conjunto como uma **ACL list** com nome. Chame de `tecnico-minimo` e aplique a lista em cada técnico novo. Em vários servidores, recrie a lista com o mesmo nome e as mesmas marcações para que "técnico" signifique a mesma coisa em todos.

## Valide entrando com o usuário

Configurar ACL e não testar é configurar no escuro. A validação tem duas partes.

### Pela interface

Abra uma janela anônima e entre em `https://seu-servidor:2087` com o usuário do técnico. Anote o que aparece no menu lateral. O esperado:

- aparece a criação de conta, se você liberou, com os pacotes do técnico listados no campo de pacote (se a lista vier vazia, falta o pacote com o prefixo dele);
- aparece a tela de reinício de serviços, se liberou;
- **não** aparecem configurações de servidor, edição de pacotes, gerenciamento de root nem acesso a contas que pertencem a root.

Se a restauração de backup não aparecer mesmo com a permissão marcada, a interface de restauração da sua versão é exclusiva de root. Nesse caso, a alternativa é o técnico restaurar pela ferramenta de backup do próprio cPanel da conta, ou a restauração continuar com você.

### Pelo terminal, como root

O WHM grava os revendedores e suas ACLs em um arquivo de texto. Para conferir o que ficou salvo:

```
grep '^joao:' /var/cpanel/resellers
```

A linha deve listar só as permissões que você marcou. Se aparecer algo que você não lembra de ter marcado, volte à tela de privilégios. Guarde a saída no registro de acessos da agência: é a prova do que o técnico podia fazer em determinada data.

## Checklist para padronizar em vários servidores

Use esta lista a cada técnico novo e a cada servidor:

- Usuário com nome da pessoa, não da função.
- Conta própria do técnico pertencendo a si mesma.
- Limite de contas definido, nunca ilimitado.
- Lista `tecnico-minimo` aplicada, sem acesso total.
- Autenticação em dois fatores ativada na conta do técnico.
- Login de teste feito em janela anônima, telas anotadas.
- Linha de `/var/cpanel/resellers` registrada.
- Contas que pertencem ao técnico, transferidas ou criadas por ele, listadas por escrito.

Para revogar, faça o caminho inverso: devolva a root toda conta com `OWNER=joao`, transferida ou criada por ele, remova os privilégios de revenda e só então suspenda ou remova a conta. Não inverta a ordem: ao remover ou encerrar a conta de um revendedor, o WHM pode oferecer encerrar também as contas que pertencem a ele, e isso apaga sites de clientes (confira o comportamento na documentação da sua versão). Antes de remover, confirme como root que nada mais pertence ao técnico:

```
grep -l '^OWNER=joao$' /var/cpanel/users/*
```

O resultado deve trazer só o arquivo da própria conta do técnico. Se aparecer qualquer outra conta, devolva a propriedade a root e rode de novo.

## O que dizer ao cliente sobre quem acessa o servidor

Cliente que tem servidor dedicado gerido pela agência às vezes pergunta quem tem acesso. Uma frase que funciona:

> **** "Nossos técnicos entram no painel do servidor com usuário individual e permissão só para criar contas com os planos que nós definimos e reiniciar serviços. A senha principal do servidor fica restrita, e cada login fica registrado com o usuário individual de quem entrou."

É verdade e verificável em duas fontes diferentes. A linha de `/var/cpanel/resellers` mostra o que o técnico pode fazer, não o que ele fez. O registro de uso fica no log de login do cPanel/WHM (em geral `/usr/local/cpanel/logs/login_log`; confira o caminho na documentação da sua versão), que mostra quando cada usuário entrou. Juntas, respondem à preocupação real do cliente, que é saber se qualquer pessoa da agência pode apagar o servidor dele.

