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.
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ção | O que faz |
|---|---|
| Isolar | Corta o acesso do dispositivo à rede para conter um incidente. Consulte o que o isolamento bloqueia. |
| 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 define o modo para este dispositivo. Consulte MFA no início de sessão do Windows. |
| 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. |
| 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. |
| 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, 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_INSTALLEDouDEVICE_UPDATES_FAILEDcom 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-1ouhost-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_SENTe cada transferência comoDEVICE_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
| 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 para a lista de dispositivos e as páginas de detalhes.
- MFA no início de sessão do Windows para o que a definição de registo MFA faz no endpoint.
- Agente de endpoint para o que é executado na máquina.
- Registos de auditoria, onde cada comando e a respetiva entrega são registados.