Skip to Content

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.

RequiresDevice 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 e utilize o respetivo menu Ações.

AçãoO que faz
IsolarCorta o acesso do dispositivo à rede para conter um incidente. Consulte o que o isolamento bloqueia.
Reverter isolamentoRemove as regras de isolamento e restaura o acesso normal à rede.
Configurar MFA para o dispositivoDefine o registo MFA do dispositivo como Obrigatório, Opcional ou Desativado, verificado no dispositivo. Fica bloqueado enquanto uma política de conformidade de dispositivos define o modo para este dispositivo. Consulte MFA no início de sessão do Windows.
Fixar utilizador / Fixar grupoAssocia 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 updatesInstala as atualizações do sistema operativo que o dispositivo comunicou como em falta. Consulte instalar atualizações em falta.
Recolher diagnósticoPede 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.
Eliminar dispositivoRemove o registo do inventário. Não desinstala nada na máquina.

Todas as ações são escritas no registo de auditoria, incluindo quem as desencadeou.

O que o isolamento realmente bloqueia

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, que levanta primeiro o isolamento. Desinstalar o legacy client 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

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

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

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

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.

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

ComandoParâmetrosFinalidade
IsolatenenhumCortar o acesso do dispositivo à rede.
RevertIsolationnenhumRestaurar o acesso à rede.
SetMfaEnrollmentenrollment: Required, Optional, DisabledDefinir o registo MFA para o início de sessão no Windows.
RequestFullUpdatenenhumPedir ao dispositivo que volte a enviar a sua postura completa. Não altera nada no endpoint.
GetProcessListnenhumDevolver os processos em execução.
TerminateProcessespids (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.
RunsignatureIniciar um produto detetado. Apenas legacy client.
Scansignature, scanType: full, default ou path, path, cleanDesencadear uma análise de malware do produto de segurança indicado.
UpdateDefinitionssignatureAtualizar as definições de malware do produto indicado.
EnableRTPsignatureVoltar a ativar a proteção em tempo real.
SetFirewallStatesignature, operation: enable ou disable, passwordAtivar ou desativar um produto de firewall.
SetAgentStatesignature, operation: enable ou disableAtivar ou desativar um agente de gestão de patches. Apenas legacy client.
GetProductInfoproductListLer os detalhes dos produtos indicados. Apenas legacy client.
GetRunningStatesignatureListVerificar se os produtos indicados estão em execução. Apenas legacy client.
BlockEndpointDestinationsdestinationsBloquear endereços ou redes IPv4 específicos no endpoint. Apenas legacy client.
UnblockEndpointDestinationsfilterKeysRemover bloqueios de destino definidos anteriormente. Apenas legacy client.
GetEndpointBlockedDestinationsListnenhumListar os bloqueios de destino atualmente aplicados. Apenas legacy client.
DownloadMissingPatchespatchesTransferir as atualizações do sistema operativo que o dispositivo comunicou como em falta. Sem a lista, tudo o que lhe é disponibilizado.
InstallMissingPatchespatchesInstalar essas atualizações. O dispositivo nunca é reiniciado para esse efeito.
CollectDiagnosticshours (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

Nesta página