> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/pt/sonar/administration/devices/clients-and-sites.md).

# Clientes e sites

Crie, renomeie e exclua clientes e sites, mova dispositivos entre sites e veja como clientes e sites se ligam aos instaladores, às políticas e aos papéis.

## O que é e quando usar

Todo dispositivo no SONAR pertence a um **site**, e todo site pertence a um **cliente**. Um cliente costuma ser uma empresa atendida ou uma unidade de negócio; um site é um local, um departamento ou qualquer grupo de dispositivos dentro dele. O par decide onde o dispositivo aparece em **Dashboard › Sysadmin**, quais políticas de automação e qual modelo de alerta ele herda e quais usuários podem vê-lo, porque os papéis são limitados por cliente e por site.

Use esta página para montar a estrutura antes de instalar os agentes, e para mantê-la organizada depois: renomear, adicionar um site, mover dispositivos, excluir o que não é mais usado.

## Antes de começar

* Um papel com **List Clients** e **List Sites** para vê-los, **Manage Clients** para criar, renomear ou excluir clientes, e **Manage Sites** para os sites (**Admin Center › Roles**, grupo **Clients & Sites**).
* **Edit Agent** para mover um dispositivo para outro site, e também **Run Bulk Operations** para mover vários de uma vez.
* Os nomes que você quer usar. O nome de um cliente precisa ser único; o nome de um site precisa ser único dentro do cliente dele. Nenhum dos dois pode conter o caractere `|`.

## Passos

**Criar um cliente**

1. Abra o menu de cabeçalho **Management** e escolha **Create › Client**.
2. Preencha **Name** e **Default first site**. Um cliente sempre começa com um site.
3. Preencha os campos personalizados do cliente, se houver algum listado.
4. Clique em **Save**. O console confirma com `CLIENT-A was added`.

**Criar um site**

1. Escolha **Management › Create › Site**, ou clique com o botão direito no cliente, no grupo **Clients** da barra lateral de **Dashboard › Sysadmin**, e escolha **Add Site**.
2. Escolha o **Client** e preencha **Name**.
3. Preencha os campos personalizados do site, se houver algum listado.
4. Clique em **Save**. O console confirma com `Site SITE-01 was added!`.

**Renomear um cliente ou um site**

1. Clique nele com o botão direito no grupo **Clients** da barra lateral e escolha **Edit**, ou abra **Management › Clients** e dê um duplo clique no cliente. Para um site, clique em **View Sites** na linha do cliente e depois dê um duplo clique no site.
2. Altere **Name**, ou os valores dos campos personalizados.
3. Clique em **Save**.

Alterar **Client** no formulário de um site move o site, com todos os dispositivos dele, para o outro cliente.

**Excluir um cliente ou um site**

1. Clique nele com o botão direito na barra lateral, ou em **Management › Clients**, e escolha **Delete**.
2. Se ele não tiver dispositivos, confirme com **Delete**.
3. Se ele tiver dispositivos, escolha o **Site to move agents to**, clique em **Move** e depois confirme com **Delete**. Os dispositivos são movidos primeiro para esse site, e em seguida o cliente ou o site é excluído.

Excluir um cliente também exclui os sites dele e os links de implantação desses sites.

**Mover dispositivos para outro site**

* Um dispositivo: abra o formulário **Edit** dele, altere **Site** e clique em **Save**. Veja [A lista de dispositivos](https://wiki.datadike.com/pt/sonar/administration/devices/device-list.md#editar-um-dispositivo).
* Vários dispositivos: digite `Bulk Organize Agents` na caixa de busca do cabeçalho (**Search functionality...**) e abra o resultado. Escolha o **Origin Site**, escolha o destino em **Choose a destination site**, passe os dispositivos para o outro lado com **Add**, **Add all** ou arrastando-os, e clique em **Confirm Changes**. Nada é salvo até você confirmar.

## O que você deve ver

O cliente aparece no grupo **Clients** da barra lateral de **Dashboard › Sysadmin**, com os sites dele logo abaixo, e ganha um cartão próprio na **Clients overview**. Passe o mouse sobre um cliente ou um site na barra lateral para ver o ID e o **Agent Count** dele.

**Management › Clients** lista todos os clientes que você pode ver, com **Name**, **Total Agents** e **View Sites (N)**; **Add Client** cria um cliente a partir dali. **View Sites** abre **Sites for CLIENT-A**, com **New** para adicionar um site.

## Como verificar se funcionou

* **Criado, renomeado ou excluído**: **Reports & Audits › Audits** registra uma ação **Add Object**, **Modify Object** ou **Delete Object** com o objeto **Client** ou **Site**, o seu nome de usuário e os valores antes e depois.
* **Dispositivos movidos um a um**: a coluna **Site** do dispositivo mostra o novo site, e a trilha de auditoria tem uma ação **Modify** sobre o objeto **Agent**.
* **Dispositivos movidos em massa**: a trilha de auditoria tem uma entrada **Bulk Action** com o texto `jdoe moved N agent(s) to CLIENT-A - SITE-01`. Filtre a lista de dispositivos pelo site de destino para vê-los.
* **Excluído com dispositivos**: selecione o site de destino na barra lateral; os dispositivos movidos aparecem ali.

## Ações em um cliente ou site

Clique com o botão direito em um cliente ou em um site no grupo **Clients** da barra lateral de **Dashboard › Sysadmin**:

| Ação                                               | O que faz                                                                                                                                                                                                                                                            | Permissão                                                  |
| -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| Edit                                               | Abre o formulário do cliente ou do site                                                                                                                                                                                                                              | Manage Clients / Manage Sites                              |
| Delete                                             | Exclui o cliente ou o site, movendo antes os dispositivos dele, quando houver                                                                                                                                                                                        | Manage Clients / Manage Sites                              |
| Add Site                                           | Cria um site sob este cliente. Só para clientes                                                                                                                                                                                                                      | Manage Sites                                               |
| Enable Maintenance Mode / Disable Maintenance Mode | Coloca todos os dispositivos do cliente ou do site em modo de manutenção, ou os tira dele. O console informa quantos dispositivos mudaram. Veja [Modo de manutenção](https://wiki.datadike.com/pt/sonar/administration/devices/device-details.md#modo-de-manutencao) | Run Bulk Operations, Edit Agent                            |
| Install Agent                                      | Abre o instalador do agente. Só para sites                                                                                                                                                                                                                           | Install Agents                                             |
| Assign Automation Policy                           | Define a **Server Policy** e a **Workstation Policy** do cliente ou do site, e **Block policy inheritance**                                                                                                                                                          | Manage Policies, mais Manage Clients / Manage Sites        |
| Assign Alert Template                              | Define o modelo de alerta do cliente ou do site                                                                                                                                                                                                                      | Manage Alert Templates, mais Manage Clients / Manage Sites |
| Run URL Action                                     | Abre uma ação de URL configurada para o cliente ou o site. Veja [Ações de URL](https://wiki.datadike.com/pt/sonar/administration/settings/url-actions.md)                                                                                                            | Run URL Actions                                            |
| Run Checks                                         | Executa agora os checks de todos os dispositivos do cliente ou do site                                                                                                                                                                                               | Run Checks                                                 |

## Como clientes e sites se relacionam com o resto do SONAR

* **Instaladores**: o instalador do agente pede um **Client** e um **Site**, e o dispositivo se registra nesse site. Um link de implantação está ligado a um único site. Confira os dois campos antes de gerar um instalador. Veja [Implantar agentes em escala](https://wiki.datadike.com/pt/sonar/deploy-operate/mass-deployment.md).
* **Políticas de automação**: um cliente e um site têm, cada um, uma política para servidores e uma para estações de trabalho. Um dispositivo herda, do site e do cliente dele, a que corresponde ao **Type** dele, junto com qualquer política atribuída ao próprio dispositivo, a menos que a herança esteja bloqueada. A aba **Automation Policies** do formulário **Edit** do dispositivo lista o que se aplica. Veja [Políticas de automação](https://wiki.datadike.com/pt/sonar/administration/automation/automation-policies.md).
* **Modelos de alerta**: um cliente ou um site pode ter um modelo de alerta que os dispositivos dele herdam. Veja [Alertas e modelos de alerta](https://wiki.datadike.com/pt/sonar/administration/automation/alerts.md).
* **Papéis**: um papel pode ser limitado a alguns clientes e sites em **Admin Center › Roles**. Quando um usuário cujo papel é limitado dessa forma cria um cliente ou um site, o SONAR o adiciona a esse papel, para que o usuário continue vendo o que criou. Veja [Papéis e permissões](https://wiki.datadike.com/pt/sonar/administration/identities/roles.md).
* **Campos personalizados**: clientes e sites têm campos personalizados próprios, preenchidos nos formulários deles. Veja [Campos personalizados](https://wiki.datadike.com/pt/sonar/administration/settings/custom-fields.md).

## Erros comuns

| Sintoma                                                                                              | Causa                                                                        | Correção                                             |
| ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | ---------------------------------------------------- |
| `Client name cannot contain the \| character` ou `Site name cannot contain the \| character`         | O nome tem um `\|`                                                           | Remova o caractere                                   |
| O cliente não é salvo e o campo de nome informa que ele já existe                                    | Os nomes de cliente são únicos                                               | Escolha outro nome                                   |
| `A client must have at least 1 site.`                                                                | Você tentou excluir o único site de um cliente                               | Crie outro site antes, ou exclua o cliente           |
| `A client must have at least one site`                                                               | Você alterou o cliente do único site de um cliente                           | Crie antes outro site no cliente original            |
| `There are no valid sites to move agents to. Add another site and try again`                         | O cliente ou o site tem dispositivos e não há outro lugar para onde movê-los | Crie um site para recebê-los e tente excluir de novo |
| **Confirm Changes** continua desabilitado com `Origin site and destination site cannot be the same.` | O destino é o próprio site de origem                                         | Escolha outro destino                                |
| `No agents have been put in maintenance mode. You might not have permissions to the resources.`      | Nenhum dos dispositivos desse cliente ou site está no escopo do seu papel    | Confira os clientes e sites do papel                 |
| Um item de menu aparece esmaecido com `You don't have permission for this action`                    | O seu papel não tem a permissão indicada na tabela acima                     | Peça que a permissão seja adicionada ao seu papel    |

## Referência de campos

**Formulário de cliente** (**Create Client** / **Editing CLIENT-A**)

| Campo              | O que faz                                                            | Valores aceitos                     | Padrão            |
| ------------------ | -------------------------------------------------------------------- | ----------------------------------- | ----------------- |
| Name               | Nome do cliente, exibido na barra lateral, na lista e na visão geral | Até 255 caracteres, único, sem `\|` | -                 |
| Default first site | Nome do site criado junto com o cliente. Só na criação               | Até 255 caracteres, sem `\|`        | -                 |
| Custom Fields      | Uma entrada por campo personalizado de cliente                       | Depende do tipo do campo            | O padrão do campo |

**Formulário de site** (**Create Site** / **Editing SITE-01**)

| Campo         | O que faz                                                                     | Valores aceitos                                       | Padrão                                  |
| ------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------- | --------------------------------------- |
| Client        | Cliente ao qual o site pertence. Alterá-lo move o site e os dispositivos dele | Qualquer cliente que você possa ver                   | O cliente a partir do qual você começou |
| Name          | Nome do site                                                                  | Até 255 caracteres, único dentro do cliente, sem `\|` | -                                       |
| Custom Fields | Uma entrada por campo personalizado de site                                   | Depende do tipo do campo                              | O padrão do campo                       |

Os campos personalizados aparecem nos formulários para os papéis com **View Custom Fields**.

## Páginas relacionadas

* [A lista de dispositivos](https://wiki.datadike.com/pt/sonar/administration/devices/device-list.md)
* [Políticas de automação](https://wiki.datadike.com/pt/sonar/administration/automation/automation-policies.md)
* [Papéis e permissões](https://wiki.datadike.com/pt/sonar/administration/identities/roles.md)
* [Implantar agentes em escala](https://wiki.datadike.com/pt/sonar/deploy-operate/mass-deployment.md)
* [Campos personalizados](https://wiki.datadike.com/pt/sonar/administration/settings/custom-fields.md)
