> 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/remote-access/remote-control.md).

# Controle remoto

Assuma o controle da área de trabalho de um dispositivo pelo console: a janela remota, o que a pessoa no endpoint vê, vários monitores, a área de transferência e o registro de auditoria.

## O que é e quando usar

**Take Control** abre uma janela remota para um dispositivo. Em um dispositivo Windows, a janela começa na aba **Take Control**, que mostra a área de trabalho do dispositivo e permite usar o mouse e o teclado dele pelo navegador. A mesma janela reúne as outras ferramentas remotas: **Terminal**, **File Browser**, **Processes**, **Services** e **Logs**.

Use-a quando precisar ver o que o usuário vê, conduzir um instalador ou corrigir algo que exige a sessão gráfica.

As sessões de área de trabalho, de terminal e de arquivos passam pelo **serviço de acesso remoto**, que alcança o dispositivo por meio de um segundo agente, instalado ao lado do agente SONAR. O console mostra o estado desse agente separadamente, como o status remoto. O agente SONAR pode estar online enquanto o agente de acesso remoto está offline, e vice-versa.

No endpoint, o agente de acesso remoto aparece como:

| Plataforma | Serviço                                                            |
| ---------- | ------------------------------------------------------------------ |
| Windows    | O serviço **Mesh Agent**, instalado em `%ProgramFiles%\Mesh Agent` |
| Linux      | `meshagent.service`                                                |
| macOS      | O launch daemon `meshagent`                                        |

{% hint style="info" %}
A aba de área de trabalho existe apenas para dispositivos Windows. Em dispositivos Linux e macOS, a janela remota abre em **Terminal**, e as abas **Services** e **Logs** não são exibidas.
{% endhint %}

## Antes de começar

* Um papel com **List Agents** (seção **Agents**) e **Use Mesh** (seção **System**) em **Admin Center › Roles**. A API verifica **Use Mesh** antes de abrir uma sessão. Se o seu papel for limitado a alguns clientes ou sites, você só poderá abrir sessões em dispositivos desses clientes e sites.
* O status remoto do dispositivo é **Remote Online**. Ele aparece no cabeçalho do painel do dispositivo.

## Passos

1. Abra **Dashboard › Sysadmin**, abra o cartão de um cliente ou **All clients** e selecione o dispositivo. O painel do dispositivo abre sob a lista.
2. Confira os indicadores de status no cabeçalho do painel. **Remote Online** significa que você pode continuar.
3. Clique em **Take Control** no cabeçalho do painel. Você também pode escolher **Take Control** no menu **Other actions** (o botão ⋮ no cabeçalho do painel), ou clicar com o botão direito na linha do dispositivo na lista e escolher **Take Control**.
4. Na nova janela, aguarde até que **Loading remote session** desapareça.
5. Clique em **Connect** para iniciar a área de trabalho.
6. Trabalhe no dispositivo. Desmarque **Input** se quiser apenas observar, sem enviar entradas de mouse ou teclado.
7. Clique em **Disconnect** ao terminar e depois feche a janela.

## O que você deve ver

O título da janela é `WS-0001 - CLIENT-A - SITE-01 | Remote Background`: o dispositivo, o cliente e o site dele. No alto ficam as abas e, em seguida, dois indicadores de status: o status do agente SONAR e o status remoto, por exemplo **Online** e **Remote online**.

Depois de **Connect**, o status ao lado do botão deixa de mostrar **Disconnected** e a área de trabalho do dispositivo ocupa a janela.

### Controles na visualização da área de trabalho

| Controle                                   | O que faz                                                                                                                                                                                                                                                      |
| ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Connect** / **Disconnect**               | Inicia e encerra a sessão de área de trabalho                                                                                                                                                                                                                  |
| **Connect**, clique com o botão direito    | **Ask Consent** pede autorização à pessoa diante do dispositivo antes de a sessão começar, **Privacy Bar** mostra a ela a barra de conexão, e **Ask Consent + Bar** faz as duas coisas, sejam quais forem as configurações de consentimento da sua implantação |
| **Disconnect**, clique com o botão direito | **Disconnect and Lock** encerra a sessão e bloqueia a tela do dispositivo                                                                                                                                                                                      |
| **Input**                                  | Liga ou desliga a entrada de mouse e teclado. Desligado significa somente visualização                                                                                                                                                                         |
| Lista de teclas e **Send**                 | Envia uma combinação de teclas que o seu próprio computador reteria para si. A lista inclui Ctrl + Alt + Del, Win + L, Win + R, Alt + Tab e Alt + F4                                                                                                           |
| **Clipboard**                              | Abre a caixa de diálogo **Remote Clipboard**. **Get Clipboard** copia para a caixa o texto da área de transferência do endpoint. **Set Clipboard** coloca o texto da caixa na área de transferência do endpoint. Somente texto, até 65.535 caracteres          |
| Ícones de monitor                          | Aparecem quando o endpoint tem mais de um monitor. Cada ícone muda a visualização para um monitor, e **All Displays** mostra todos ao mesmo tempo                                                                                                              |
| Tempo de sessão                            | Mostra há quanto tempo a sessão de área de trabalho está aberta                                                                                                                                                                                                |

Quando a janela abre, o navegador pode perguntar se a página pode ler a área de transferência. Permita, se quiser que copiar e colar funcione entre o seu computador e o endpoint.

### O que a pessoa no endpoint vê

As configurações de consentimento do serviço de acesso remoto decidem o que vê a pessoa conectada ao dispositivo. Essas configurações fazem parte da sua implantação e são definidas com o suporte de implantação da DataDike. As opções são:

| Opção                                 | O que a pessoa no endpoint vê                                                                                                                                                                                                                                                                                    |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Pedido de consentimento               | Uma janela com a mensagem "*name* requesting remote desktop access. Grant access?" e os botões **Allow** e **Deny**. *name* é o usuário do SONAR que está se conectando. A sessão só começa depois de **Allow**. Enquanto o pedido está aberto, a sua janela remota mostra "Waiting for user to grant access..." |
| Aceitação automática, somente Windows | O pedido tem uma terceira opção, **Auto accept all connections for next 60 minutes**. Depois que ela é escolhida, novas sessões de área de trabalho, de terminal e de arquivos do mesmo usuário do SONAR começam sem pedido durante 60 minutos. O período termina antes se o agente de acesso remoto reiniciar   |
| Notificação                           | Uma notificação do sistema: "*name* started a remote desktop session."                                                                                                                                                                                                                                           |
| Barra de conexão                      | Uma barra na área de trabalho com o texto "Sharing desktop with: *name*" enquanto a sessão durar. Se a pessoa fechar a barra, a sessão de área de trabalho remota termina                                                                                                                                        |

Se nenhuma opção de consentimento estiver definida, a sessão começa sem pedido e sem notificação.

### Quando o status remoto não está online

Se o agente de acesso remoto estiver offline, o painel mostra **Remote Offline** e **Take Control** fica desabilitado. A dica exibida ao passar o mouse sobre o botão começa com "You cannot take control of this agent". Se o agente SONAR estiver online ao mesmo tempo, o painel também mostra **Restart Remote Service**, que pede ao agente SONAR que reinicie o agente de acesso remoto no dispositivo.

Se a janela remota for aberta enquanto o status remoto for qualquer coisa diferente de online, ela mostra **Remote access unavailable**, os dois indicadores de status e um botão **Close**. Nenhuma sessão começa e nenhum registro de auditoria é gravado.

## Como verificar se funcionou

1. Abra a sessão e clique em **Connect**. O status ao lado do botão precisa deixar de mostrar **Disconnected**, e a área de trabalho precisa acompanhar o seu mouse.
2. No painel do dispositivo, abra a aba **Audits**. Uma nova entrada com a ação **Remote Session** precisa aparecer no topo, com o seu nome de usuário, o dispositivo e o seu endereço IP em **Client IP**.
3. Para o ambiente inteiro, abra **Reports & Audits › Audits** e filtre pela ação **Remote Session**.

{% hint style="info" %}
O SONAR grava um registro **Remote Session** cada vez que a janela remota abre para um dispositivo, e outro cada vez que **Restart Mesh Agent** é concluído nessa janela. O registro diz quem abriu a janela, para qual dispositivo, quando e a partir de qual endereço IP. Um único registro cobre, em conjunto, as abas **Take Control**, **Terminal** e **File Browser** dessa janela. Ele não registra o que foi feito durante a sessão nem quando a sessão terminou.
{% endhint %}

## Erros comuns

| Sintoma                                                                                         | Causa                                                               | Correção                                                                                                                                                                                                                                                                  |
| ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Take Control** está desabilitado, com **Remote Offline** no painel                            | O agente de acesso remoto no dispositivo não está conectado         | Se o agente SONAR estiver online, clique em **Restart Remote Service**. Se não estiver, primeiro coloque o dispositivo online e depois confira se o serviço **Mesh Agent** (Windows), `meshagent.service` (Linux) ou o launch daemon `meshagent` (macOS) está em execução |
| **Take Control** aparece esmaecido no menu, com "You don't have permission for this action"     | O seu papel não tem **Use Mesh**                                    | Peça a um administrador que adicione essa permissão em **Admin Center › Roles**                                                                                                                                                                                           |
| A janela remota abre, mas nenhuma sessão carrega em nenhuma aba                                 | O seu papel não tem **Use Mesh**                                    | Peça a um administrador que adicione essa permissão em **Admin Center › Roles**                                                                                                                                                                                           |
| A janela mostra **Remote access unavailable**                                                   | O status remoto não estava online quando a janela abriu             | Feche a janela, atualize o painel do dispositivo e tente de novo quando ele mostrar **Remote Online**                                                                                                                                                                     |
| Nada abre depois que você clica em **Take Control**                                             | O navegador bloqueou a nova janela                                  | Permita pop-ups para o endereço do console                                                                                                                                                                                                                                |
| A janela remota mostra "Waiting for user to grant access..." e nenhuma área de trabalho aparece | A pessoa no endpoint não clicou em **Allow**, ou clicou em **Deny** | Entre em contato com o usuário e tente de novo                                                                                                                                                                                                                            |
| Não há aba **Take Control** na janela remota                                                    | O dispositivo executa Linux ou macOS                                | Use **Terminal** e **File Browser**                                                                                                                                                                                                                                       |
| "Unable to contact the agent" depois de **Restart Remote Service** ou **Restart Mesh Agent**    | O agente SONAR não respondeu                                        | Aguarde até que o dispositivo mostre **Online** e tente de novo                                                                                                                                                                                                           |

## Referência de campos

**Cabeçalho do painel do dispositivo**:

| Elemento                                                    | O que mostra ou faz                                                                                                                        |
| ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Online** / **Overdue** / **Offline**                      | Status do agente SONAR                                                                                                                     |
| **Remote Online** / **Remote Offline** / **Remote Unknown** | Status do agente de acesso remoto, lido quando o painel carrega. **Remote Unknown** significa que o console não conseguiu obter resposta   |
| **Take Control**                                            | Abre a janela remota. Fica desabilitado enquanto o status remoto é **Remote Offline**                                                      |
| **Restart Remote Service**                                  | Exibido apenas quando o status remoto é **Remote Offline** e o agente SONAR está online. Reinicia o agente de acesso remoto no dispositivo |
| **Other actions** (⋮)                                       | Abre o menu de ações do dispositivo. **Take Control** é a primeira entrada                                                                 |

**Janela remota, canto superior direito**:

| Elemento               | O que faz                                                                                                                                                                                         | Disponível em        |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- |
| Indicadores de status  | Status do agente SONAR e status remoto                                                                                                                                                            | Todas as plataformas |
| **Restart Connection** | Reinicia o serviço Windows **Mesh Agent** por meio do agente SONAR. Exige **Manage Windows Services** no seu papel. Confirma com "Mesh agent service was restarted"                               | Windows              |
| **Restart Mesh Agent** | Pede ao agente SONAR que pare e inicie o agente de acesso remoto e depois recarrega as abas remotas. Confirma com "Repaired mesh agent on *device*". Pode ser usado de novo depois de 10 segundos | Todas as plataformas |
| Logotipo do SONAR      | Alterna a janela entre os modos claro e escuro                                                                                                                                                    | Todas as plataformas |

**Abas da janela remota**:

| Aba              | O que abre                                                                                                                                                        | Disponível em        |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- |
| **Take Control** | Área de trabalho remota                                                                                                                                           | Windows              |
| **Terminal**     | Shell de comandos no dispositivo. Veja [Terminal remoto](https://wiki.datadike.com/pt/sonar/administration/remote-access/remote-terminal.md)                      | Todas as plataformas |
| **File Browser** | O sistema de arquivos do dispositivo. Veja [Transferir arquivos](https://wiki.datadike.com/pt/sonar/administration/remote-access/file-transfer.md)                | Todas as plataformas |
| **Processes**    | Processos em execução. Veja [Processos, serviços e logs de eventos](https://wiki.datadike.com/pt/sonar/administration/remote-access/processes-services-events.md) | Todas as plataformas |
| **Services**     | Serviços do Windows                                                                                                                                               | Windows              |
| **Logs**         | Logs de eventos do Windows                                                                                                                                        | Windows              |

A aba **Mesh Central** em **Admin Center › Settings** conecta o console ao serviço de acesso remoto. Ela é mantida com o suporte de implantação da DataDike.

## Páginas relacionadas

* [Terminal remoto](https://wiki.datadike.com/pt/sonar/administration/remote-access/remote-terminal.md): o shell de comandos na mesma janela
* [Transferir arquivos](https://wiki.datadike.com/pt/sonar/administration/remote-access/file-transfer.md): o navegador de arquivos na mesma janela
* [Detalhes do dispositivo](https://wiki.datadike.com/pt/sonar/administration/devices/device-details.md): o painel do dispositivo e os indicadores de status dele
* [Trilha de auditoria](https://wiki.datadike.com/pt/sonar/administration/audit/audit-trail.md): onde aparecem os registros **Remote Session**
* [Papéis e permissões](https://wiki.datadike.com/pt/sonar/administration/identities/roles.md): **Use Mesh** e as outras permissões de acesso remoto
