Skip to Content

Acciones remotas

Aísle un dispositivo, cambie su registro de MFA, fije su usuario y ejecute comandos de dispositivo mediante la API de gestión.

RequiresDevice Identity (DIAM)

Complemento necesario: Las acciones remotas requieren el complemento DIAM (Device Identity) con la función deviceTrust.

Sobre un dispositivo conectado se puede actuar desde la consola. Las acciones siguientes constituyen la parte de respuesta a incidentes del inventario de dispositivos: contener una máquina, cambiar lo que exige al iniciar sesión o corregir a quién pertenece, sin tocarla físicamente.

Acciones en la consola

Abra un dispositivo en el inventario de dispositivos y utilice su menú Acciones.

AcciónQué hace
AislarDesconecta el dispositivo de la red para contener un incidente. Consulte qué bloquea el aislamiento.
Revertir el aislamientoElimina las reglas de aislamiento y restablece el acceso normal a la red.
Configurar MFA para el dispositivoEstablece el registro de MFA del dispositivo en Obligatorio, Opcional o Desactivado, verificado en el dispositivo. Bloqueado mientras una política de cumplimiento de dispositivos establezca el modo para este dispositivo. Consulte MFA en el inicio de sesión de Windows.
Fijar usuario / Fijar grupoVincula una cuenta del sistema operativo del dispositivo con una cuenta de empleado que usted elija, o permite que todos los miembros de un grupo utilicen el dispositivo. La cuenta del sistema operativo se rellena previamente con la que inició sesión por última vez y también puede escribirse, de modo que un dispositivo puede fijarse antes de que su usuario inicie sesión por primera vez: el nombre de usuario sin el dominio, y el nombre corto del dominio (DEV, no dev.example.com) o, para una cuenta local, el nombre del equipo. En Windows el dominio es obligatorio. Se sugieren las cuentas cuyo nombre de usuario coincide. Un dispositivo puede tener varias cuentas fijadas (una por cuenta del sistema operativo) y grupos; la lista Cuentas ancladas de la pestaña Resumen los muestra y es donde se elimina una fijación. Un dispositivo cuyo usuario activo no es uno de sus usuarios fijados se marca en la lista; así se hace visible un dispositivo que ha cambiado de manos.
Instalar actualizacionesInstala las actualizaciones del sistema operativo que el dispositivo ha notificado como faltantes. Consulte instalar las actualizaciones faltantes.
Recopilar diagnósticoSolicita al agente de endpoint sus registros y su estado de las últimas 24, 48 o 72 horas, seudonimizados en el dispositivo. Consulte paquetes de diagnóstico.
Eliminar dispositivoElimina el registro del inventario. No desinstala nada en la máquina.

Cada acción se escribe en el registro de auditoría, incluido quién la desencadenó.

Qué bloquea realmente el aislamiento

El aislamiento instala reglas de firewall locales en el endpoint. Es una medida de contención, no un interruptor de apagado: se mantiene deliberadamente la conectividad suficiente para que la máquina siga siendo gestionable y para que pueda levantar el aislamiento de nuevo.

Bloqueado: todo el resto del tráfico entrante y saliente, IPv4 e IPv6.

Permitido deliberadamente:

  • La conexión del dispositivo con la plataforma, para que pueda revertir el aislamiento de forma remota.
  • DNS, DHCP y la configuración automática del proxy, para que la máquina conserve la resolución de nombres y el direccionamiento básicos.
  • La autenticación de dominio de Windows, para que el inicio de sesión en el dominio siga funcionando.
  • La sincronización horaria, para que el reloj siga siendo correcto (agente de endpoint).
  • El tráfico de loopback en la propia máquina.

Dos propiedades importan en la práctica. Las reglas son persistentes y se aplican al arrancar, de modo que un reinicio no levanta el aislamiento, y el aislamiento surte efecto antes de que se inicie el servicio del cliente. Además, las reglas solo se eliminan al revertir el aislamiento, o al desinstalar el agente de endpoint, que primero levanta el aislamiento. Desinstalar el cliente heredado de una máquina aislada la deja aislada, así que en ese caso revierta primero. Si el aislamiento deja a un dispositivo sin conexión con la plataforma, dts-agent revert-isolation en el dispositivo lo levanta localmente.

El aislamiento está disponible en Windows, macOS y Linux con el agente de endpoint, y en Windows con el cliente anterior. En una máquina Linux que aloja contenedores, el aislamiento también corta la red de los contenedores, y un firewall propio del host puede seguir bloqueando lo que el aislamiento permite.

Aislamiento parcial

Un dispositivo puede notificar Parcialmente aislado. Se trata de un estado, no de un modo que pueda elegirse: el cliente compara las reglas de aislamiento realmente presentes con el conjunto completo esperado y notifica un aislamiento parcial cuando hay algunas, pero no todas. Normalmente significa que un aislamiento o una reversión solo se completó en parte. Trátelo como "no contenido" y vuelva a emitir la acción.

Instalar las actualizaciones faltantes

Nota: La instalación de actualizaciones forma parte de la gestión de parches, que requiere el plan Pro con el complemento DIAM. En los demás planes, la pestaña de parches sigue mostrando las actualizaciones faltantes, pero no muestra botones de instalación.

La pestaña Parches faltantes de un dispositivo muestra las actualizaciones del sistema operativo que la máquina ha notificado como faltantes. Con el agente de endpoint actual puede instalarlas desde allí. En un dispositivo con el cliente DTS anterior, y en Linux, los botones de instalación aparecen atenuados.

Cada actualización tiene su propio botón Instalar, e Instalar todas las actualizaciones pendientes, sobre la sección Actualizaciones del sistema, las inicia todas en una sola ejecución. La acción masiva solicita confirmación primero; una actualización individual se inicia de inmediato, salvo que esté marcada como Reinicio necesario, en cuyo caso también se solicita confirmación. Las actualizaciones que proceden del catálogo de vulnerabilidades y no de la propia máquina no tienen botón: son actualizaciones de aplicaciones, y esta acción solo controla el mecanismo de actualización propio del sistema operativo.

Qué ocurre después del clic:

  • El dispositivo confirma que la instalación se ha iniciado, no que ha finalizado. Una instalación se ejecuta en segundo plano durante minutos u horas, por lo que la consola nunca notifica una actualización como instalada.
  • El parche mantiene una marca Instalación solicitada hasta que el dispositivo vuelve a notificar su estado, y todos los botones de instalación del dispositivo quedan bloqueados mientras se mantiene. Una máquina instala un conjunto de actualizaciones cada vez, por lo que esto es también lo que impide que dos administradores acumulen instalaciones. La marca caduca al cabo de dos horas, por si una instalación nunca llega a informar.
  • Una instalación fallida lo indica en la actualización. El dispositivo transmite lo que ha dicho su propio mecanismo de actualización, con sus palabras, y los botones quedan libres de inmediato en lugar de al cabo de las dos horas. El mensaje permanece en la actualización hasta que se instala o hasta que usted inicia otro intento.
  • Cada ejecución finalizada figura en el registro de auditoría, como DEVICE_UPDATES_INSTALLED o DEVICE_UPDATES_FAILED con el mensaje del dispositivo, de modo que el resultado sigue siendo legible cuando la marca ha desaparecido, y una alarma puede notificar las instalaciones fallidas.
  • La lista se corrige cuando el dispositivo envía su siguiente informe de estado. Actualizar estado del dispositivo, en el encabezado del dispositivo, solicita ese informe de inmediato en lugar de esperar al diario, y el aviso sobre la instalación en curso repite el botón.
  • El dispositivo nunca se reinicia. Una actualización marcada como Reinicio necesario surte efecto tras el siguiente reinicio, que queda en manos del usuario o de su mantenimiento habitual.

Requisitos y límites:

  • El dispositivo debe estar conectado. Las instalaciones no se ponen en cola para dispositivos sin conexión: una instalación diferida se ejecutaría días después, en un momento arbitrario, con una lista que estaba vigente cuando se puso en cola.
  • La acción requiere el agente de endpoint actual. No se ofrece para dispositivos que ejecutan el cliente anterior, ni en Linux, donde el agente no controla ningún mecanismo de actualización.
  • En Windows solo se ejecuta una sesión de instalación a la vez. La consola bloquea los botones mientras hay una instalación abierta, por lo que esto rara vez se manifiesta; una solicitud que aun así llega se rechaza con un mensaje en lugar de descartarse sin aviso.

Actualizaciones de aplicaciones

En los dispositivos Windows con el agente de endpoint actual, la pestaña de parches también muestra actualizaciones de aplicaciones del catálogo de paquetes, y una actualización confirmada tiene su propio botón Descargar e instalar. El dispositivo descarga el instalador por sí mismo desde la dirección del fabricante, lo comprueba con la suma de comprobación del catálogo y la firma del fabricante, y lo ejecuta de forma silenciosa; la consola nunca maneja el archivo. Todo lo anterior se aplica: el dispositivo confirma el inicio, los botones permanecen bloqueados mientras se ejecuta, un error se muestra en la actualización y el dispositivo nunca se reinicia. Una actualización que solo finaliza con un reinicio se notifica como instalada.

Una actualización de aplicación sin botón indica debajo el motivo, por ejemplo:

  • el paquete no está confirmado (encajan varios paquetes o el instalador difiere del instalado): elíjalo con Elegir paquete junto a la actualización;
  • la aplicación está instalada en un perfil de usuario, o su instalador instala por usuario;
  • varias aplicaciones del dispositivo son el mismo paquete, como dos entornos de ejecución en paralelo;
  • el instalador no tiene modo silencioso, elimina primero la versión instalada o está empaquetado en un archivo comprimido;
  • la información de actualización no está actualizada: las instalaciones usan datos del catálogo de siete días como máximo;
  • el dispositivo ejecuta macOS: allí las actualizaciones de aplicaciones se muestran, pero no se instalan.

La instalación de actualizaciones de aplicaciones también funciona en un dispositivo aislado: el aislamiento deja pasar al propio agente de endpoint, y el agente descarga el instalador. No se ofrece a través de la API.

Paquetes de diagnóstico

Cuando un dispositivo no funciona bien y nadie puede acceder a la máquina, Recopilar diagnóstico en el menú Acciones solicita al agente de endpoint sus registros y su estado de las últimas 24, 48 o 72 horas. El dispositivo tiene que estar conectado. En un dispositivo que todavía ejecuta el cliente DTS anterior, la opción del menú aparece atenuada. El paquete llega en aproximadamente medio minuto y se muestra en la pestaña Diagnóstico del dispositivo, desde donde se descarga como archivo JSON.

  • Seudonimizado en el dispositivo. Antes de que el paquete salga de la máquina, el agente sustituye los nombres de usuario, las direcciones de correo electrónico, los nombres de dominio y de host, los SID, las direcciones IP y MAC, los números de serie y las rutas de perfil por marcadores como user-1 o host-2. El mismo valor recibe el mismo marcador en todo el paquete, de modo que las relaciones siguen siendo legibles. La correspondencia nunca sale del dispositivo. Los códigos de error, las marcas de tiempo, las versiones y los estados se mantienen tal cual.
  • Nunca se incluyen: claves, tokens, contraseñas, códigos, registros de eventos de Windows ni los datos de postura sin procesar.
  • Tamaño. El agente mantiene un paquete por debajo de 1 MB y, si es necesario, descarta las líneas de registro más antiguas. Un paquete así se marca como truncado.
  • Conservación. Un paquete se elimina 14 días después de su recopilación.
  • Auditoría. La recopilación se registra como DEVICE_COMMAND_SENT y cada descarga como DEVICE_DIAGNOSTICS_DOWNLOADED, cada una con el administrador que la realizó.

Un paquete seudonimizado sigue siendo un dato personal. Entréguelo al soporte solo en el marco del contrato de encargo del tratamiento que cubre su instancia.

Dispositivos sin conexión y comandos en cola

Un dispositivo se considera sin conexión unos diez segundos después de su último contacto.

Tres acciones pueden ponerse en cola para la reconexión: Aislar, Revertir el aislamiento y Configurar MFA para el dispositivo. Si el dispositivo está sin conexión, la consola ofrece poner el comando en cola y este se entrega automáticamente en cuanto el dispositivo vuelve. Cualquier otra acción falla de inmediato en un dispositivo sin conexión en lugar de almacenarse.

Reglas de la cola:

  • Un comando pendiente por asunto. El aislamiento y el registro de MFA se ponen en cola por separado, pero un comando de aislamiento más reciente sustituye a uno anterior pendiente, de modo que un dispositivo no puede acumular instrucciones contradictorias.
  • Los comandos en cola caducan a los siete días si el dispositivo no vuelve.
  • Las acciones pendientes son visibles en la página del dispositivo y pueden cancelarse antes de la entrega.
  • La entrega también se registra en el registro de auditoría, de modo que puede ver tanto cuándo se puso en cola un comando como cuándo llegó realmente al dispositivo.

A través de la API

Nota: Requiere la función deviceTrust.

Los mismos comandos están disponibles de forma programática, que es lo que se utiliza para integrar la contención en un playbook de SOAR o en sus propias herramientas.

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

La llamada requiere el scope devices.query. Establezca queueIfOffline en true para obtener el comportamiento de cola descrito anteriormente; su valor predeterminado es false, de modo que una llamada simple contra un dispositivo sin conexión falla rápidamente en lugar de aplazarse.

Comandos disponibles

ComandoParámetrosFinalidad
IsolateningunoDesconectar el dispositivo de la red.
RevertIsolationningunoRestablecer el acceso a la red.
SetMfaEnrollmentenrollment: Required, Optional, DisabledEstablecer el registro de MFA para el inicio de sesión de Windows.
RequestFullUpdateningunoPedir al dispositivo que vuelva a enviar su postura completa. No cambia nada en el endpoint.
GetProcessListningunoDevolver los procesos en ejecución.
TerminateProcessespids (agente de endpoint) o signature (cliente anterior)Detener los procesos con estos identificadores, leídos de GetProcessList del mismo dispositivo, o los de un producto detectado. El agente de endpoint nunca se detiene a sí mismo ni detiene un proceso crítico del sistema.
RunsignatureIniciar un producto detectado. Solo cliente anterior.
Scansignature, scanType: full, default o path, path, cleanLanzar un análisis de malware del producto de seguridad indicado.
UpdateDefinitionssignatureActualizar las definiciones de malware del producto indicado.
EnableRTPsignatureVolver a activar la protección en tiempo real.
SetFirewallStatesignature, operation: enable o disable, passwordActivar o desactivar un producto de firewall.
SetAgentStatesignature, operation: enable o disableActivar o desactivar un agente de gestión de parches. Solo cliente anterior.
GetProductInfoproductListLeer los detalles de los productos indicados. Solo cliente anterior.
GetRunningStatesignatureListComprobar si los productos indicados se están ejecutando. Solo cliente anterior.
BlockEndpointDestinationsdestinationsBloquear direcciones IPv4 o redes concretas en el endpoint. Solo cliente anterior.
UnblockEndpointDestinationsfilterKeysEliminar bloqueos de destino establecidos anteriormente. Solo cliente anterior.
GetEndpointBlockedDestinationsListningunoEnumerar los bloqueos de destino vigentes. Solo cliente anterior.
DownloadMissingPatchespatchesDescargar las actualizaciones del sistema operativo que el dispositivo ha notificado como faltantes. Sin la lista, todas las que se le ofrecen.
InstallMissingPatchespatchesInstalar esas actualizaciones. El dispositivo nunca se reinicia para ello.
CollectDiagnosticshours (de 1 a 72, 24 de forma predeterminada)Devolver los registros y el estado del agente en esa ventana, seudonimizados en el dispositivo. A través de la API, el paquete va al llamante y no se almacena.

El parámetro patches contiene los identificadores que el propio dispositivo ha notificado en missingPatches: un número KB en Windows, el identificador propio de la actualización cuando no tiene número KB, una etiqueta de actualización en macOS. Léalos primero de los datos de parches del dispositivo. Estos dos comandos requieren el agente de endpoint actual; actúan sobre el mecanismo de actualización propio del sistema operativo y en Linux se responden como no compatibles.

El parámetro signature identifica un producto de seguridad tal como lo notifica ese dispositivo. Léalo primero de los datos de producto del propio dispositivo, con GetProductInfo, en lugar de suponer un identificador estable entre máquinas.

En un dispositivo con el agente de endpoint, Scan, UpdateDefinitions y EnableRTP actúan sobre Microsoft Defender (Windows) y SetFirewallState sobre el firewall del sistema operativo (Windows y macOS); signature sigue siendo obligatorio allí, pero no se evalúa. Un comando marcado como solo cliente anterior se rechaza para un dispositivo así. En el cliente anterior, los comandos a nivel de producto actúan sobre software de seguridad de terceros instalado en el endpoint y solo funcionan cuando ese producto admite la operación. Interprete un fallo como "el producto lo ha rechazado", no como "el dispositivo no es accesible"; ambos casos se notifican de forma diferente.

El bloqueo de destinos se aplica solo a IPv4.

Solución de problemas

  • Se agotó el tiempo de espera del comando. El dispositivo era accesible, pero no respondió a tiempo. Confirme que sigue conectado y vuelva a intentarlo. Solo las tres acciones que pueden ponerse en cola sobreviven a una reconexión; todo lo demás debe volver a emitirse.
  • La acción se puso en cola aunque el dispositivo parece en línea. La lista muestra el último estado conocido. Si el dispositivo dejó de comunicarse hace unos segundos, ya se considera sin conexión.
  • Un dispositivo sigue aislado después de eliminar el cliente. Con el cliente anterior, las reglas de firewall son locales y sobreviven al cliente. Vuelva a instalar un cliente, revierta el aislamiento y, a continuación, desinstálelo correctamente. El agente de endpoint levanta el aislamiento al desinstalarse.
  • El dispositivo notifica un aislamiento parcial. Vuelva a emitir Aislar o Revertir el aislamiento para llevarlo a un estado definido.

Véase también

En esta página