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

# Administração do Usuário

> É a lista de todas as contas do servidor. Daqui se cria um cliente, se entra na conta dele, se muda o que ele pode fazer e se apaga a conta.

**Caminho no painel:** **Geral** > **Administração do Usuário**

## As três abas

| Aba | O que tem | Onde está documentada |
| - | - | - |
| **Contas de administrador** | quem administra o servidor | [Contas de administrador](/keyhelp-admin/contas-de-administrador) |
| **Contas de clientes** | as contas de hospedagem. É a que abre primeiro | aqui |
| **Grupos de clientes** | **não abre nesta edição** | ver abaixo |

**Grupos de clientes tem o selo *Recurso Pro* e não é uma tela.** Clicar nela
devolve você para Contas de clientes, com o aviso *"Este recurso está disponível
exclusivamente na edição profissional do KeyHelp"*.

## A lista de clientes

![Lista de contas de clientes, com a coluna S, o ícone de informação e as ações](https://mintcdn.com/san-internet/gD6hsj0ABwoHZHWu/keyhelp-admin/imagens/usuarios-lista-clientes.png?fit=max\&auto=format\&n=gD6hsj0ABwoHZHWu\&q=85\&s=5dbf6d98517020d7c5ae39dfa1bcf1ee)

| # | O que é |
| - | - |
| **1** | **S**, o estado da conta |
| **2** | o **ℹ**, que mostra a conta inteira sem abrir nada |
| **3** | as três ações da linha |

### A coluna S não diz se a conta está ativa

Ela responde outra pergunta: **o painel conseguiu deixar esta conta como você
pediu?**

| Ícone | Dica | O que significa |
| - | - | - |
| **quadrado verde** | *Tudo certo* | o servidor está em dia com o que foi configurado |
| **chave inglesa azul** | *Processando* | há uma mudança sendo aplicada agora |
| **triângulo vermelho** | *Ocorreu um erro* | o painel tentou aplicar uma mudança no servidor e falhou. O motivo não aparece aqui, e sim no **Registro de Eventos**. Ver abaixo |

O modelo de tela do painel prevê mais dois estados para esta coluna, uma
**lixeira cinza** para conta que vai ser apagada e uma **interrogação cinza**
para estado desconhecido. Nenhuma conta apareceu assim nos testes, então as
dicas deles não foram lidas.

**Uma conta suspensa continua com o quadrado verde**, porque ela está suspensa
exatamente como foi pedido, e para o painel isso é estar em dia. Quem procura a
suspensão aqui não acha: o sinal dela é o **cadeado**, na coluna seguinte.

O mesmo desenho vale na tela de **Domínios**: um domínio desativado também fica
com o quadrado verde e ganha um cadeado ao lado.

**O *Processando* dura cerca de um minuto.** Suspender não vale na hora: o painel
responde *"As alterações terão efeito em alguns instantes"* e uma tarefa de fundo
aplica.

### Quando aparece o triângulo vermelho

**Medido numa conta de cliente recém-criada**, na máquina de teste:

| Quando | O que aconteceu |
| - | - |
| no clique em **Salvar** | o painel registrou a conta, e ela entrou na lista |
| 14 segundos depois | a tarefa de fundo criou o usuário da conta no servidor, com pasta e grupos, **e mesmo assim registrou erro**. O **S** virou triângulo vermelho |
| logo em seguida | **a conta abria normalmente**: um administrador entrou nela, e o próprio cliente também. O erro não bloqueia nada |
| três dias depois | **o triângulo continuava lá.** O painel não tentou de novo sozinho |

### Onde está o motivo

**Na tela:** menu da esquerda > **Status do Sistema** > [Registro de Eventos](/keyhelp-admin/registro-de-eventos).
Na busca, escolha **Mensagem** e procure pelo nome da conta. A linha do erro tem o
nível **Erro**, o canal **Maintenance (update)**, que é a tarefa de fundo, e a
mensagem *"Error occurred while adding system user"* seguida do nome da conta.
**Ela não diz qual passo falhou.**

**No servidor:** a tarefa de fundo escreve o passo a passo em
`/var/log/keyhelp/cronjob/update.log`. Numa conta criada de novo para o teste, o
arquivo mostrou:

| Passo da criação | Resultado |
| - | - |
| criar o usuário no sistema | okay |
| grupos do usuário | okay |
| pasta da conta | okay |
| conteúdo de `/www/` e página inicial | okay |
| **aplicar a cota de disco** | **erro:** *setquota: Cannot stat() mounted device /dev/root* |

**O último passo é a cota, e é ele que falha.** O resto da conta fica pronto, e
por isso ela abre normalmente com o triângulo vermelho.

**A causa é o servidor, não a conta.** Na máquina de teste, a cota de disco não
funcionava desde a instalação, e **as nove contas de cliente criadas até então
nasceram com esse erro**, com limites e sem limites. Ver o motivo e o conserto do
servidor em [Quota](/keyhelp-admin/quota).

**Com a cota do servidor consertada, medido na mesma máquina:** a conta criada em
seguida nasceu com *Tudo certo*, o histórico registrou *"System user ... added"*
em vez do erro, e **o limite de disco já estava aplicado** no sistema.

### Como tirar do erro uma conta que já nasceu assim

Consertar a cota do servidor **não conserta as contas que já existem**. Cada uma
continua com o triângulo, e **sem o limite de disco aplicado**, até o painel
gravar a cota dela de novo. E ele só grava quando o **valor do espaço em disco
muda**.

Medido, mudança por mudança, numa conta nessa situação:

| Mudança salva na ficha | Tira o triângulo? | Aplica o limite de disco? |
| - | - | - |
| **mudar o espaço em disco para outro valor e depois voltar** | **sim** | **sim** |
| ligar ou desligar a permissão de SSH | sim | **não** |
| salvar com o mesmo espaço em disco | não | não |
| mudar o idioma ou um limite de e-mail | não | não |

**Conferido numa conta que estava com o triângulo havia três dias:** o espaço em
disco foi de 1 MB para 2 MB, e no minuto seguinte a conta estava com *Tudo certo*
e com o limite gravado no sistema. Voltando para 1 MB, o limite acompanhou.

1. Na ficha da conta, troque o **Espaço de Disco** por outro valor e clique em
   **Salvar**.
2. Espere um minuto. O **Registro de Eventos** mostra *"System user ...
   updated"*.
3. Volte o **Espaço de Disco** para o valor certo e salve de novo.

> [!WARNING]
>
> **Ligar e desligar o SSH deixa o S verde e o limite de fora**
>
> O SSH faz o painel atualizar o usuário da conta, e isso tira o triângulo. Mas
> essa atualização **não passa pela cota**. A conta fica com *Tudo certo* e sem
> limite de disco nenhum, e a tela não tem como mostrar a diferença. Use a troca do
> espaço em disco.

> [!WARNING]
>
> **Olhe o S depois de criar uma conta**
>
> O formulário de [criação](/keyhelp-admin/criar-conta-de-cliente) responde *"O usuário
> `<nome>` foi criado com sucesso"* no clique, antes de a tarefa de fundo rodar.
> A falha aparece segundos depois, e só neste ícone. Quem cria a conta e vai
> embora não vê.

### A coluna dos sinais

![Sinais ao lado do nome do cliente: cadeado, comentário e informação](https://mintcdn.com/san-internet/gD6hsj0ABwoHZHWu/keyhelp-admin/imagens/usuarios-sinais.png?fit=max\&auto=format\&n=gD6hsj0ABwoHZHWu\&q=85\&s=cbe4518783b076e445bf918209f5fbeb)

O **1** é a coluna S. O **2** é a coluna dos sinais, onde cabem **quatro**, e três
deles só aparecem quando há motivo. A conta de cima está suspensa e tem uma nota;
a de baixo não tem nenhum dos dois.

| Sinal | Cor | O que quer dizer |
| - | - | - |
| **cadeado** | vermelho | a conta **está suspensa agora** |
| **cadeado** | cinza | está **marcada para suspender**, e a dica traz a data |
| **lixeira** | cinza | está **marcada para excluir**, e a dica traz a data |
| **balão** | cinza | há uma **nota** na conta, e a dica mostra o texto |
| **ℹ** | cinza | aparece sempre |

**Passe o mouse em qualquer um deles para ler.** É onde a data e o texto da nota
aparecem.

### O ℹ mostra a conta inteira sem sair da lista

Parando o mouse sobre ele aparece um cartão com a **data de configuração**, cada
recurso no formato *usado / limite* (domínios, subdomínios, contas e endereços de
e-mail, encaminhamentos, bancos de dados, usuários de FTP e tarefas agendadas), a
**lista de domínios** e as **permissões** ligadas.

É a resposta mais rápida para *"o que esse cliente tem?"*.

### Escolher quais colunas aparecem

![Menu Visualização personalizada, com as colunas que podem ser mostradas](https://mintcdn.com/san-internet/gD6hsj0ABwoHZHWu/keyhelp-admin/imagens/usuarios-colunas.png?fit=max\&auto=format\&n=gD6hsj0ABwoHZHWu\&q=85\&s=649ce7d3d4c14de7bd983862d4ea31c9)

**Visualização personalizada** abre a lista de colunas opcionais. São sete, e
**quatro vêm ligadas**:

| Coluna | Vem ligada? |
| - | - |
| Nome de contato | sim |
| ID do cliente | não |
| Espaço de Disco | sim |
| Alocação de espaço em disco | não |
| Quantidade de arquivos | não |
| Tráfego | sim |
| Último acesso | sim |

Marque as que quiser e clique em **Salvar**. **A escolha fica guardada** e vale
nas próximas visitas.

### Procurar uma conta

![Campo de busca com a escolha do campo pesquisado](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/usuarios-busca.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=643abf7200f36fe3b246ca8113548d2c)

O seletor ao lado do campo decide **onde** procurar: *Todos os campos*, *Nome de
usuário*, *Nome de contato*, *ID do cliente* ou *Domínio*.

> [!WARNING]
>
> **A busca continua valendo depois que você sai da tela**
>
> O filtro fica guardado na sessão. Se você buscar, for para outra tela e voltar,
> **a lista ainda vem filtrada** e o termo continua no campo. Para ver tudo de
> novo, apague o campo e clique em **Busca**.

### O rodapé soma

A última linha mostra o total de contas e a **soma** do disco e do tráfego de
todas elas.

## Entrar na conta de um cliente

Há **duas formas, e as duas fazem a mesma coisa**: clicar no **nome de usuário**,
que é link, ou clicar na **seta** na coluna Ações.

Você cai no **Painel de Controle do cliente**, vendo o painel como ele vê. O
cabeçalho ganha **Voltar ao administrador**, e é por ali que se volta.

> [!WARNING]
>
> **O painel guarda uma sessão por navegador**
>
> Entrar como cliente numa segunda aba **derruba a sessão de administrador** na
> primeira. Não dá para deixar os dois lados abertos lado a lado no mesmo
> navegador, e é para isso que a seta e o **Voltar ao administrador** existem.

## Criar, editar e excluir

1. **Adicionar cliente**, no alto à direita, abre o formulário de conta nova. Ver
   [Criar uma conta de cliente](/keyhelp-admin/criar-conta-de-cliente).
2. O **lápis** abre a mesma tela para uma conta que já existe. É lá que ficam as
   **Notas**, na aba Geral, e **Suspender conta** com as datas de suspensão e de
   exclusão, na aba **Configurações avançadas**.
3. A **lixeira** abre a tela de exclusão.

Em **Ações em massa** existe uma operação só, **Excluir seleção**, e ela vale para
as contas marcadas na caixa da esquerda.

**Excluir pede confirmação, pela linha e pelo lote.** Nos dois caminhos o painel
abre a mesma tela, que lista **os domínios e as permissões da conta** antes de
apagar, e exige marcar a caixa **Confirmação**.

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **Sumiram contas da lista** | uma busca anterior continua aplicada | apagar o campo de busca e clicar em **Busca** |
| **Suspendi e nada mudou** | a mudança é aplicada por tarefa de fundo | esperar cerca de um minuto e recarregar. O **S** fica em *Processando* enquanto isso |
| Suspendi e o **S** continua verde | o **S** não mostra suspensão | o sinal dela é o **cadeado vermelho**, na coluna ao lado |
| **O S de uma conta virou triângulo vermelho** | a tarefa de fundo falhou ao aplicar algo no servidor, como criar o usuário da conta | procurar o nome da conta em **Status do Sistema** > **Registro de Eventos**, buscando por **Mensagem** |
| A conta tem triângulo vermelho há dias | o painel não tenta de novo sozinho | depois de consertar a cota do servidor, trocar o **Espaço de Disco** da conta por outro valor e voltar |
| **Toda conta nova nasce com triângulo vermelho** | a cota de disco do servidor não funciona, e a criação para no último passo, o da cota | consertar a cota do servidor, ver [Quota](/keyhelp-admin/quota). O `update.log` do servidor mostra o erro do `setquota` |
| **O S está verde, e o cliente passa do limite de disco** | o triângulo saiu pelo SSH, ou a cota do servidor foi ligada depois de a conta existir, e o limite nunca foi gravado | trocar o **Espaço de Disco** da conta por outro valor e voltar |
| **A tabela corta para o lado** | ela tem largura mínima maior que a janela estreita | alargar a janela, ou desligar colunas em **Visualização personalizada** |
| Cliquei em **Grupos de clientes** e voltei para a lista | é recurso da edição profissional | nada a fazer nesta edição |
| Entrei na conta do cliente e não acho como sair | o menu da esquerda virou o do cliente | **Voltar ao administrador**, no topo |
| Não acho a coluna **ID do cliente** | ela não vem ligada | **Visualização personalizada** > marcar > **Salvar** |

## Ver também

* [Criar uma conta de cliente](/keyhelp-admin/criar-conta-de-cliente), o formulário e as sete abas dele
* [Limites e permissões do cliente](/keyhelp-admin/limites-e-permissoes-do-cliente), o que o cliente pode e quanto
* [Contas de administrador](/keyhelp-admin/contas-de-administrador), a outra aba desta tela


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