# Ações remotas

Isolar um dispositivo, alterar o seu registo MFA, fixar o seu utilizador e executar comandos de dispositivo através da API de gestão.

Requires: Device Identity (DIAM)

> **Add-on necessário:** As ações remotas requerem o add-on **DIAM** (Device Identity) com a funcionalidade **deviceTrust**.

É possível atuar sobre um dispositivo ligado a partir da consola. As ações abaixo constituem a vertente de resposta a incidentes do inventário de dispositivos: contém uma máquina, altera o que esta exige no início de sessão ou corrige a quem pertence, sem lhe tocar fisicamente.

## Ações na consola

Abra um dispositivo no [inventário de dispositivos](https://dts-identity.com/pt/docs/endpoints/device-inventory.md) e utilize o respetivo menu **Ações**.

| Ação | O que faz |
|---|---|
| **Isolar** | Corta o acesso do dispositivo à rede para conter um incidente. Consulte [o que o isolamento bloqueia](#what-isolation-actually-blocks). |
| **Reverter isolamento** | Remove as regras de isolamento e restaura o acesso normal à rede. |
| **Configurar MFA para o dispositivo** | Define o registo MFA do dispositivo como **Obrigatório**, **Opcional** ou **Desativado**, verificado no dispositivo. Fica bloqueado enquanto uma [política de conformidade de dispositivos](https://dts-identity.com/pt/docs/security/conditional-access/device-compliance-policies.md#windows-logon) define o modo para este dispositivo. Consulte [MFA no início de sessão do Windows](https://dts-identity.com/pt/docs/endpoints/windows-logon-mfa.md). |
| **Fixar utilizador** / **Fixar grupo** | Associa uma conta do sistema operativo do dispositivo a uma conta de colaborador à sua escolha, ou permite que todos os membros de um grupo utilizem o dispositivo. A conta do sistema operativo vem pré-preenchida com a que iniciou sessão por último e pode, em alternativa, ser escrita, pelo que um dispositivo pode ser fixado antes de o seu utilizador iniciar sessão pela primeira vez: o nome de utilizador sem o domínio e o nome curto do domínio (`DEV`, não `dev.example.com`) ou, para uma conta local, o nome do computador. No Windows, o domínio é obrigatório. São sugeridas as contas cujo nome de utilizador corresponde. Um dispositivo pode ter várias contas fixadas (uma por conta do sistema operativo) e grupos; a lista **Contas fixadas** no separador Visão geral mostra-os e é aí que se remove uma fixação. Um dispositivo cujo utilizador ativo não é um dos seus utilizadores fixados é assinalado na lista, o que torna visível um dispositivo que mudou de mãos. |
| **Install updates** | Instala as atualizações do sistema operativo que o dispositivo comunicou como em falta. Consulte [instalar atualizações em falta](#installing-missing-updates). |
| **Recolher diagnóstico** | Pede ao agente de endpoint os seus registos e o seu estado das últimas 24, 48 ou 72 horas, pseudonimizados no dispositivo. Consulte [pacotes de diagnóstico](#diagnostics-packages). |
| **Eliminar dispositivo** | Remove o registo do inventário. Não desinstala nada na máquina. |

Todas as ações são escritas no [registo de auditoria](https://dts-identity.com/pt/docs/monitoring/audit-logs.md), incluindo quem as desencadeou.

### O que o isolamento realmente bloqueia [#what-isolation-actually-blocks]

O isolamento instala regras de firewall locais no endpoint. É uma medida de contenção, não um interruptor: é deliberadamente preservada conectividade suficiente para manter a máquina gerível e para que possa levantar o isolamento novamente.

**Bloqueado:** todo o restante tráfego de entrada e de saída, IPv4 e IPv6.

**Deliberadamente ainda permitido:**

- A ligação do dispositivo de volta à plataforma, para que possa reverter o isolamento remotamente.
- DNS, DHCP e a configuração automática de proxy, para que a máquina mantenha a resolução de nomes e o endereçamento básicos.
- A autenticação de domínio do Windows, para que o início de sessão no domínio continue a funcionar.
- A sincronização da hora, para que o relógio se mantenha certo (agente de endpoint).
- O tráfego de loopback na própria máquina.

Duas propriedades são importantes do ponto de vista operacional. As regras são **persistentes e aplicadas no arranque**, pelo que um reinício não levanta o isolamento, e o isolamento entra em vigor antes de o serviço do cliente arrancar. E as regras **só são removidas revertendo o isolamento**, ou desinstalando o [agente de endpoint](https://dts-identity.com/pt/docs/endpoints/device-client.md#uninstall), que levanta primeiro o isolamento. Desinstalar o [legacy client](https://dts-identity.com/pt/docs/endpoints/legacy-client.md) de uma máquina isolada deixa-a isolada, pelo que aí deve reverter primeiro. Se o isolamento cortar a ligação de um dispositivo à plataforma, `dts-agent revert-isolation` no dispositivo levanta-o localmente.

O isolamento está disponível em Windows, macOS e Linux com o agente de endpoint, e em Windows com o legacy client. Numa máquina Linux que aloja contentores, o isolamento corta também a rede dos contentores, e uma firewall própria do anfitrião pode ainda bloquear o que o isolamento permite.

### Isolamento parcial

Um dispositivo pode comunicar **Parcialmente isolado**. Trata-se de um estado, não de um modo que possa escolher: o cliente compara as regras de isolamento efetivamente presentes com o conjunto completo esperado e comunica isolamento parcial quando algumas, mas não todas, estão aplicadas. Normalmente, significa que um isolamento ou uma reversão só foi parcialmente concluído. Trate-o como "não contido" e volte a emitir a ação.

## Instalar atualizações em falta [#installing-missing-updates]

> **Nota:** A instalação de atualizações faz parte da gestão de patches, que requer o plano **Pro** com o add-on **DIAM**. Nos outros planos, o separador Patches em falta continua a listar as atualizações em falta, mas não apresenta botões de instalação.

O separador **Patches em falta** de um dispositivo lista as atualizações do sistema operativo que a máquina comunicou como em falta.
Com o agente de endpoint atual, pode instalá-las a partir daí. Num dispositivo com o cliente DTS anterior, e no Linux, os botões de instalação ficam desativados.

Cada atualização tem o seu próprio botão **Instalar**, e **Instalar todas as atualizações pendentes**, acima da secção **Atualizações do sistema**,
inicia todas elas numa única execução. A ação em massa pede primeiro confirmação; uma atualização individual
começa de imediato, a menos que esteja marcada como *Reinício necessário*, caso em que também pede confirmação. As atualizações que provêm
do catálogo de vulnerabilidades e não da própria máquina não têm botão: são
atualizações de aplicações, e esta ação apenas aciona o mecanismo de atualização do próprio sistema operativo.

O que acontece após o clique:

- O dispositivo confirma que a instalação **começou**, não que terminou. Uma instalação decorre entre minutos e
  horas em segundo plano, pelo que a consola nunca comunica uma atualização como instalada.
- O patch mantém um marcador **Installation requested** até o dispositivo comunicar novamente o seu estado, e
  **todos os botões de instalação do dispositivo ficam bloqueados** enquanto este se mantiver. Uma máquina instala um conjunto de atualizações
  de cada vez, pelo que é também isto que impede dois administradores de sobrepor instalações. O marcador caduca
  ao fim de duas horas, caso uma instalação nunca dê resposta.
- **Uma instalação que falhou indica-o na atualização.** O dispositivo transmite o que o seu próprio mecanismo
  de atualização comunicou, nas palavras deste, e os botões ficam imediatamente livres, em vez de só após as duas
  horas. Uma mensagem permanece na atualização até esta ser instalada ou até iniciar outra tentativa.
- **Cada execução concluída fica no registo de auditoria**, como `DEVICE_UPDATES_INSTALLED` ou
  `DEVICE_UPDATES_FAILED` com a mensagem do dispositivo, para que o resultado continue legível depois de o marcador
  desaparecer, e um [alarme](https://dts-identity.com/pt/docs/monitoring/alarms.md) pode comunicar instalações falhadas.
- A lista é corrigida quando o dispositivo envia o seu próximo relatório de estado. **Atualizar estado do dispositivo**, no
  cabeçalho do dispositivo, pede esse relatório de imediato em vez de aguardar o relatório diário, e o alerta
  sobre a instalação em curso repete o botão.
- **O dispositivo nunca é reiniciado.** Uma atualização marcada como *Reinício necessário* entra em vigor após o próximo
  reinício, que fica a cargo do utilizador ou da sua manutenção regular.

Requisitos e limites:

- O dispositivo tem de estar **ligado**. As instalações não são colocadas em fila de espera para dispositivos offline: uma
  instalação diferida seria executada dias mais tarde, num momento arbitrário, com base numa lista que estava atualizada quando foi
  colocada em fila.
- A ação requer o **agente de endpoint atual**. Não é disponibilizada para dispositivos com o cliente
  anterior, nem no Linux, onde o agente não aciona nenhum mecanismo de atualização.
- No Windows, só é executada uma sessão de instalação de cada vez. A consola bloqueia os botões enquanto uma
  instalação estiver em aberto, pelo que isto raramente se manifesta; um pedido que ainda assim chegue é recusado com uma
  mensagem, em vez de ser descartado silenciosamente.

### Atualizações de aplicações [#application-updates]

Em dispositivos Windows com o agente de endpoint atual, o separador Patches em falta lista também **atualizações de aplicações**
do catálogo de pacotes, e uma atualização confirmada tem o seu próprio botão **Transferir e instalar**. O dispositivo transfere o
instalador por si próprio a partir do endereço do fabricante, verifica-o em relação à soma de verificação do catálogo e à
assinatura do fabricante e executa-o de forma silenciosa; a consola nunca manipula o ficheiro. Tudo o que foi dito acima se aplica: o
dispositivo confirma o início, os botões permanecem bloqueados durante a execução, uma falha é apresentada na atualização e
o dispositivo nunca é reiniciado. Uma atualização que só termina com um reinício é comunicada como instalada.

Uma atualização de aplicação sem botão indica o motivo por baixo, por exemplo:

- o pacote **não está confirmado** (vários pacotes correspondem, ou o instalador difere do
  instalado): escolha-o com **Escolher pacote** junto à atualização;
- a aplicação está **instalada num perfil de utilizador**, ou o seu instalador **instala por utilizador**;
- várias aplicações no dispositivo correspondem ao mesmo pacote, como dois runtimes lado a lado;
- o instalador **não tem modo silencioso**, remove primeiro a versão instalada ou está compactado num
  arquivo;
- as informações de atualização **não estão atualizadas**: as instalações utilizam dados do catálogo com, no máximo, sete dias;
- o dispositivo executa macOS: as atualizações de aplicações são aí listadas, mas não instaladas.

A instalação de atualizações de aplicações também funciona num dispositivo isolado: o isolamento deixa passar o próprio
agente de endpoint, e o agente transfere o instalador. Não é disponibilizada através da API.

## Pacotes de diagnóstico [#diagnostics-packages]

Quando um dispositivo se comporta de forma anómala e ninguém consegue aceder à máquina, **Recolher diagnóstico** no menu Ações pede ao agente de endpoint os seus registos e o seu estado das últimas 24, 48 ou 72 horas. O dispositivo tem de estar ligado. Num dispositivo que ainda executa o cliente DTS anterior, a opção do menu fica desativada. O pacote chega em cerca de meio minuto e é listado no separador **Diagnóstico** do dispositivo, onde é transferido como ficheiro JSON.

- **Pseudonimizado no dispositivo.** Antes de o pacote sair da máquina, o agente substitui nomes de utilizador, endereços de e-mail, nomes de domínio e de anfitrião, SIDs, endereços IP e MAC, números de série e caminhos de perfil por marcadores como `user-1` ou `host-2`. O mesmo valor recebe o mesmo marcador em todo o pacote, pelo que as relações continuam legíveis. A correspondência nunca sai do dispositivo. Os códigos de erro, carimbos de data/hora, versões e estados mantêm-se inalterados.
- **Nunca incluídos:** chaves, tokens, palavras-passe, códigos, registos de eventos do Windows e os dados de postura em bruto.
- **Tamanho.** O agente mantém um pacote abaixo de 1 MB e, se necessário, descarta as linhas de registo mais antigas. Um pacote assim é marcado como truncado.
- **Retenção.** Um pacote é eliminado 14 dias após ter sido recolhido.
- **Auditoria.** A recolha é registada como `DEVICE_COMMAND_SENT` e cada transferência como `DEVICE_DIAGNOSTICS_DOWNLOADED`, ambas com o administrador que a efetuou.

Um pacote pseudonimizado continua a ser um dado pessoal. Entregue-o ao suporte apenas no âmbito do acordo de tratamento de dados que abrange a sua instância.

## Dispositivos offline e comandos em fila de espera

Um dispositivo é considerado offline cerca de dez segundos após o seu último check-in.

Três ações podem ser **colocadas em fila de espera até à nova ligação**: **Isolar**, **Reverter isolamento** e **Configurar MFA para o dispositivo**. Se o dispositivo estiver offline, a consola propõe colocar o comando em fila de espera, e este é entregue automaticamente no momento em que o dispositivo volta. Todas as outras ações falham de imediato num dispositivo offline, em vez de serem armazenadas.

Regras da fila de espera:

- **Um comando pendente por assunto.** O isolamento e o registo MFA são colocados em fila separadamente, mas um comando de isolamento mais recente substitui um comando mais antigo pendente, para que um dispositivo não possa acumular instruções contraditórias.
- **Os comandos em fila de espera expiram ao fim de sete dias** se o dispositivo nunca voltar.
- **As ações pendentes são visíveis na página do dispositivo** e podem ser canceladas antes da entrega.
- A entrega também é registada no registo de auditoria, para que possa ver tanto quando um comando foi colocado em fila como quando chegou efetivamente ao dispositivo.

## Através da API [#through-the-api]

> **Nota:** Requer a funcionalidade **deviceTrust**.

Os mesmos comandos estão disponíveis de forma programática, que é o que utiliza para integrar a contenção num playbook SOAR ou nas suas próprias ferramentas.

```bash
curl -X POST https://<your-instance>/api/v1/devices/<deviceUid>/query/Isolate \
  -H "Authorization: Bearer <access token>" \
  -H "Content-Type: application/json" \
  -d '{"queueIfOffline": true}'
```

A chamada requer o scope `devices.query`. Defina `queueIfOffline` como `true` para obter o comportamento de fila de espera descrito acima; a predefinição é `false`, pelo que uma chamada simples a um dispositivo offline falha de imediato em vez de ser diferida.

### Comandos disponíveis

| Comando | Parâmetros | Finalidade |
|---|---|---|
| `Isolate` | nenhum | Cortar o acesso do dispositivo à rede. |
| `RevertIsolation` | nenhum | Restaurar o acesso à rede. |
| `SetMfaEnrollment` | `enrollment`: `Required`, `Optional`, `Disabled` | Definir o registo MFA para o início de sessão no Windows. |
| `RequestFullUpdate` | nenhum | Pedir ao dispositivo que volte a enviar a sua postura completa. Não altera nada no endpoint. |
| `GetProcessList` | nenhum | Devolver os processos em execução. |
| `TerminateProcesses` | `pids` (agente de endpoint) ou `signature` (legacy client) | Parar os processos com estes ids, lidos a partir de `GetProcessList` do mesmo dispositivo, ou os de um produto detetado. O agente de endpoint nunca para a si próprio nem um processo crítico do sistema. |
| `Run` | `signature` | Iniciar um produto detetado. Apenas legacy client. |
| `Scan` | `signature`, `scanType`: `full`, `default` ou `path`, `path`, `clean` | Desencadear uma análise de malware do produto de segurança indicado. |
| `UpdateDefinitions` | `signature` | Atualizar as definições de malware do produto indicado. |
| `EnableRTP` | `signature` | Voltar a ativar a proteção em tempo real. |
| `SetFirewallState` | `signature`, `operation`: `enable` ou `disable`, `password` | Ativar ou desativar um produto de firewall. |
| `SetAgentState` | `signature`, `operation`: `enable` ou `disable` | Ativar ou desativar um agente de gestão de patches. Apenas legacy client. |
| `GetProductInfo` | `productList` | Ler os detalhes dos produtos indicados. Apenas legacy client. |
| `GetRunningState` | `signatureList` | Verificar se os produtos indicados estão em execução. Apenas legacy client. |
| `BlockEndpointDestinations` | `destinations` | Bloquear endereços ou redes IPv4 específicos no endpoint. Apenas legacy client. |
| `UnblockEndpointDestinations` | `filterKeys` | Remover bloqueios de destino definidos anteriormente. Apenas legacy client. |
| `GetEndpointBlockedDestinationsList` | nenhum | Listar os bloqueios de destino atualmente aplicados. Apenas legacy client. |
| `DownloadMissingPatches` | `patches` | Transferir as atualizações do sistema operativo que o dispositivo comunicou como em falta. Sem a lista, tudo o que lhe é disponibilizado. |
| `InstallMissingPatches` | `patches` | Instalar essas atualizações. O dispositivo nunca é reiniciado para esse efeito. |
| `CollectDiagnostics` | `hours` (1 a 72, predefinição 24) | Devolver os registos e o estado do agente nesse intervalo, pseudonimizados no dispositivo. Através da API, o pacote vai para o autor da chamada e não é armazenado. |

O parâmetro `patches` contém os identificadores que o próprio dispositivo comunicou em `missingPatches`: um número KB no Windows, o identificador da própria atualização quando esta não tem número KB, uma etiqueta de atualização no macOS. Leia-os primeiro a partir dos dados de patches do dispositivo. Estes dois comandos requerem o agente de endpoint atual; atuam sobre o mecanismo de atualização do próprio sistema operativo e são respondidos como não suportados no Linux.

O parâmetro `signature` identifica um produto de segurança **tal como é comunicado por esse dispositivo**. Leia-o primeiro a partir dos dados de produtos do próprio dispositivo, com `GetProductInfo`, em vez de assumir um identificador que seja estável entre máquinas.

Num dispositivo com o agente de endpoint, `Scan`, `UpdateDefinitions` e `EnableRTP` atuam sobre o Microsoft Defender (Windows) e `SetFirewallState` sobre a firewall do sistema operativo (Windows e macOS); `signature` continua a ser obrigatório, mas não é avaliado. Um comando marcado como *apenas legacy client* é recusado para esse dispositivo. No legacy client, os comandos ao nível do produto atuam sobre software de segurança de terceiros instalado no endpoint e só funcionam quando esse produto suporta a operação. Trate uma falha como "o produto recusou", não como "o dispositivo está inacessível"; as duas situações são comunicadas de forma diferente.

O bloqueio de destinos aplica-se apenas a IPv4.

## Resolução de problemas

- **O comando excedeu o tempo limite.** O dispositivo estava acessível, mas não respondeu a tempo. Confirme que ainda está ligado e tente novamente. Apenas as três ações que podem ser colocadas em fila sobrevivem a uma nova ligação; tudo o resto tem de ser emitido novamente.
- **A ação foi colocada em fila de espera, embora o dispositivo pareça online.** A lista mostra o último estado conhecido. Se o dispositivo deixou de fazer check-in há segundos, já é tratado como offline.
- **Um dispositivo continua isolado depois de o cliente ter sido removido.** Com o legacy client, as regras de firewall são locais e sobrevivem ao cliente. Reinstale um cliente, reverta o isolamento e, em seguida, desinstale corretamente. O agente de endpoint levanta o isolamento ao ser desinstalado.
- **O dispositivo comunica isolamento parcial.** Volte a emitir **Isolar** ou **Reverter isolamento** para o levar a um estado definido.

## Consultar também

- [Inventário de dispositivos](https://dts-identity.com/pt/docs/endpoints/device-inventory.md) para a lista de dispositivos e as páginas de detalhes.
- [MFA no início de sessão do Windows](https://dts-identity.com/pt/docs/endpoints/windows-logon-mfa.md) para o que a definição de registo MFA faz no endpoint.
- [Agente de endpoint](https://dts-identity.com/pt/docs/endpoints/device-client.md) para o que é executado na máquina.
- [Registos de auditoria](https://dts-identity.com/pt/docs/monitoring/audit-logs.md), onde cada comando e a respetiva entrega são registados.
