blog
Servidores

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.

JR · · 8 min de leitura · 1 tabela · 2 blocos de código

Resposta curta: 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.

Neste artigo
  1. Não existe login de técnico no WHM: o que existe é conta de revenda com ACLs
  2. Quando esse meio-termo resolve e quando não resolve
  3. Por que as contas antigas não aparecem para o técnico
  4. Passo a passo para criar o usuário do técnico
  5. Valide entrando com o usuário
  6. Checklist para padronizar em vários servidores
  7. O que dizer ao cliente sobre quem acessa o servidor

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.

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:

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 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:

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.

Criar o usuário do técnico em cinco etapasConta base com revendaConta que pertence a si mesmaLimite de contasDefinido, nunca ilimitadoACLs mínimasSó o que a tarefa exigeLista tecnico-minimoSalva com nome reutilizávelTeste em janela anônimaTelas anotadas antes de liberar
Ordem de criação do usuário do técnico, do mais amplo ao mais restrito.

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:

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:

  1. Usuário com nome da pessoa, não da função.
  2. Conta própria do técnico pertencendo a si mesma.
  3. Limite de contas definido, nunca ilimitado.
  4. Lista tecnico-minimo aplicada, sem acesso total.
  5. Autenticação em dois fatores ativada na conta do técnico.
  6. Login de teste feito em janela anônima, telas anotadas.
  7. Linha de /var/cpanel/resellers registrada.
  8. 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.

Revogar o acesso do técnico sem perder contasListar contas com OWNER do técnicogrep -l com OWNER=usuárioDevolver cada conta para rootMudança de propriedade no WHMRepetir o grepDeve sobrar só a conta do técnicoRemover privilégios de revendaAntes de mexer na contaSuspender ou remover a contaSó depois dos passos anteriores
Revogação na ordem que evita apagar sites de clientes.

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:

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

Referências

  1. Documentação oficial (cpanel) — ACLs. Consultado em 2026-11-15.
Leia também