Integra Automox en Google SecOps

En este documento, se describe cómo integrar Automox en Google Security Operations (Google SecOps).

Parámetros de integración

Usa los siguientes parámetros para configurar la integración:

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Raíz de la API String https://#123;#123;api_root#125;#125; Sí Es la raíz de la API de la instancia de Automox.
Clave de API Contraseña N/A No Es la clave de API de la instancia de Automox.
Verificar SSL Casilla de verificación Marcado Sí Si se habilita, verifica que el certificado SSL para la conexión a Automox sea válido.

Para obtener instrucciones sobre cómo configurar una integración en Google SecOps, consulta Configura integraciones.

Si es necesario, puedes realizar cambios más adelante. Después de configurar una instancia de integración, puedes usarla en las guías. Para obtener más información sobre cómo configurar y admitir varias instancias, consulta Cómo admitir varias instancias.

Cómo generar una clave de API

Para obtener más información sobre cómo generar una clave de API, consulta el paso Encuentra tu clave de API en la consola disponible en el documento Guía para principiantes sobre cómo comenzar a usar la API de Automox.

Acciones

Para obtener más información sobre las acciones, consulta Responde a las acciones pendientes desde tu escritorio y Ejecuta una acción manual en tu caso.

Enriquece entidades

Enriquece entidades con información de Automox.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Parches de retorno Casilla de verificación Marcado No

Si está habilitada, la acción devuelve una lista de parches que deben actualizarse en la máquina.

Nota: La acción no devuelve los parches que se instalaron ni los que se ignoraron.

Cantidad máxima de parches que se devolverán Número entero 50 No Especifica la cantidad de parches que se mostrarán. Si no se proporciona nada, la acción devuelve 50 parches.

Fecha de ejecución

Esta acción se ejecuta en las siguientes entidades:

  • Dirección IP
  • Nombre de host

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero o falso is_success=False
Resultado de JSON
{
    "id": 2263017,
    "agent_version": "1.41.125",
    "commands": [],
    "compatibility_checks": {
        "missing_wmi_integrity_check": false,
        "missing_powershell": false,
        "low_diskspace": false
    },
    "compliant": true,
    "connected": false,
    "create_time": "2022-10-24T09:14:12+0000",
    "custom_name": "",
    "deleted": false,
    "detail": {
        "IPS": [
            "192.0.2.176",
            "2001:db8:1:1:1:1:1:1"
        ],
        "UPDATE_SOURCE_CHECK": {
            "CONNECTED": "True",
            "ERROR": "Succeeded"
        },
        "MDM_SERVER": null,
        "FQDNS": [
            "DESKTOP-65M05SE.WORKGROUP"
        ],
        "RAM": "8589934592",
        "SECURE_TOKEN_ACCOUNT": null,
        "LAST_USER_LOGON": {
            "SRC": "DESKTOP-65M05SE",
            "USER": "DESKTOP-65M05SE\\Admin",
            "TIME": "10/24/2022 2:59:45 AM"
        },
        "VOLUME": [
            {
                "IS_SYSTEM_DISK": "True",
                "VOLUME": "C:",
                "FSTYPE": "NTFS",
                "LABEL": "Local Disk",
                "AVAIL": "63766056960",
                "FREE": "39201988608"
            }
        ],
        "DISTINGUISHED_NAME": "",
        "MODEL": "VMware7,1",
        "CPU": "Intel(R) Xeon(R) CPU E5-2698 v3 @ 2.30GHz",
        "MDM_PROFILE_INSTALLED": null,
        "VENDOR": "VMware, Inc.",
        "AUTO_UPDATE_OPTIONS": {
            "OPTIONS": "off",
            "ENABLED": "1"
        },
        "SERVICETAG": "No Asset Tag",
        "PS_VERSION": "5",
        "WSUS_CONFIG": {
            "WSUS_REACHABLE": "1",
            "WSUS_MANAGED": "0",
            "WSUS_SERVER": ""
        },
        "SERIAL": "VMware",
        "NICS": [
            {
                "VENDOR": "Intel(R) 82574L Gigabit Network Connection",
                "DEVICE": "Ethernet0",
                "TYPE": "enet",
                "MAC": "01:23:45:AB:CD:EF",
                "IPS": [
                    "172.30.201.176",
                    "2001:db8:1:1:1:1:1:1"
                ],
                "CONNECTED": true
            },
            {
                "IPS": [],
                "CONNECTED": false,
                "VENDOR": "WAN Miniport (IP)",
                "DEVICE": "",
                "TYPE": "enet",
                "MAC": "01:23:45:AB:CD:EF"
            },
            {
                "VENDOR": "WAN Miniport (IPv6)",
                "DEVICE": "",
                "TYPE": "enet",
                "MAC": "01:23:45:AB:CD:EF",
                "IPS": [],
                "CONNECTED": false
            },
            {
                "CONNECTED": false,
                "VENDOR": "WAN Miniport (Network Monitor)",
                "DEVICE": "",
                "TYPE": "enet",
                "MAC": "01:23:45:AB:CD:EF",
                "IPS": []
            }
        ],
        "WMI_INTEGRITY_CHECK": "True",
        "VERSION": "440BX Desktop Reference Platform",
        "DISKS": [
            {
                "TYPE": "VMware Virtual disk SCSI Disk Device",
                "SIZE": "64420392960"
            }
        ]
    },
    "display_name": "DESKTOP-65M05SE",
    "exception": false,
    "instance_id": "",
    "ip_addrs": [
        "192.0.2.139"
    ],
    "ip_addrs_private": [
        "192.0.2.176",
        "2001:db8:1:1:1:1:1:1"
    ],
    "is_compatible": true,
    "is_delayed_by_notification": false,
    "is_delayed_by_user": false,
    "last_disconnect_time": "2022-10-25T09:19:29+0000",
    "last_logged_in_user": "DESKTOP-65M05SE\\Admin",
    "last_process_time": "2022-10-25T08:19:24+0000",
    "last_refresh_time": "2022-10-25T08:23:48+0000",
    "last_scan_failed": false,
    "last_update_time": "2022-10-25T08:22:14+0000",
    "mdm": null,
    "name": "DESKTOP-65M05SE",
    "needs_attention": false,
    "needs_reboot": false,
    "next_patch_time": null,
    "notification_count": 0,
    "organization_id": 104513,
    "organizational_unit": "",
    "os_family": "Windows",
    "os_name": "10 Enterprise Evaluation",
    "os_version": "10.0.19043",
    "os_version_id": 4876,
    "patch_deferral_count": 0,
    "patches": 1,
    "pending": false,
    "pending_patches": 0,
    "policy_status": [
        {
            "id": 316123693,
            "organization_id": 104513,
            "policy_id": 245687,
            "server_id": 2263017,
            "policy_name": "Apply All Patches",
            "policy_type_name": "patch",
            "status": 1,
            "result": "{}",
            "create_time": "2022-10-25T08:23:48+0000",
            "will_reboot": false,
            "pending_count": 0,
            "next_remediation": null
        }
    ],
    "reboot_deferral_count": 0,
    "reboot_is_delayed_by_notification": false,
    "reboot_is_delayed_by_user": false,
    "reboot_notification_count": 0,
    "refresh_interval": 1440,
    "serial_number": "VMware",
    "server_group_id": 145150,
    "server_policies": [],
    "status": {
        "device_status": "not-ready",
        "agent_status": "disconnected",
        "policy_status": "compliant",
        "policy_statuses": [
            {
                "id": 245687,
                "compliant": true
            },
            {
                "id": 245688,
                "compliant": true
            }
        ]
    },
    "tags": [
        "Recently Added"
    ],
    "timezone": "UTC-0700",
    "total_count": 1,
    "uptime": "1872",
    "uuid": "UUID",
    "list_of_patches": [
        {
            "id": 2077952013,
            "server_id": 2263017,
            "package_id": 227229243,
            "software_id": 167943,
            "installed": true,
            "ignored": false,
            "group_ignored": false,
            "deferred_until": null,
            "group_deferred_until": null,
            "name": "example",
            "display_name": "MSXML 6.0 RTM Security Update  (925673)",
            "version": "103",
            "repo": "WindowsUpdate",
            "cves": [],
            "cve_score": "9.0",
            "agent_severity": "9.0",
            "severity": "critical",
            "package_version_id": 233355423,
            "os_name": "10 Enterprise Evaluation",
            "os_version": "10.0.19043",
            "os_version_id": 4876,
            "create_time": "2021-06-28T15:45:57+0000",
            "requires_reboot": true,
            "patch_classification_category_id": 8,
            "patch_scope": "important",
            "is_uninstallable": false,
            "secondary_id": null,
            "is_managed": true,
            "impact": 0,
            "organization_id": 104513
        }
    ]
}
Enriquecimiento de entidades
Nombre del campo de enriquecimiento Lógica: Cuándo aplicarla
id Cuando está disponible en JSON
agent_version Cuando está disponible en JSON
conforme Cuando está disponible en JSON
conectado Cuando está disponible en JSON
create_time Cuando está disponible en JSON
custom_name Cuando está disponible en JSON
ip_addrs_private Cuando está disponible en JSON
last_disconnect_time Cuando está disponible en JSON
last_logged_in_user Cuando está disponible en JSON
last_update_time Cuando está disponible en JSON
os Cuando está disponible en JSON
pending_patches Cuando está disponible en JSON
tags Cuando está disponible en JSON
Muro de casos
Tipo de resultado Valor/Descripción Tipo
Mensaje de salida*

La acción no debería fallar ni detener la ejecución de una guía:

Si hay datos disponibles para una entidad (is_success=true): "Successfully enriched the following entities using information from Automox: {entity.identifier}".

Si no hay datos disponibles para una entidad (is_success=true): "La acción no pudo enriquecer las siguientes entidades con información de Automox: {entity.identifier}"

Si no hay datos disponibles para todas las entidades (is_success=false): "None of the provided entities were enriched."

La acción debería fallar y detener la ejecución de una guía:

Si se informa un error fatal, como credenciales incorrectas, falta de conexión con el servidor, entre otros: "Error executing action "Enrich Entities". Reason: {0}''.format(error.Stacktrace)

General
Tabla del muro de casos

Título: {entity.identifier}

Columnas:

  • Clave
  • Valor
Entidad

Ejecuta el comando del dispositivo

Ejecuta un comando en el extremo en Automox.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Comando DDL

Analizar dispositivo

Valores posibles:

  • Analizar dispositivo
  • Instala parches específicos
  • Instala todos los parches disponibles
  • Reiniciar el dispositivo
No

Especifica un comando que se deba ejecutar en el dispositivo.

Nota: Si se selecciona "Instalar parches específicos", el parámetro "Nombres de parches" es obligatorio.

Nombres de los parches CSV N/A No Especifica una lista separada por comas de los parches que se deben instalar.

Fecha de ejecución

Esta acción se ejecuta en las siguientes entidades:

  • Dirección IP
  • Nombre de host

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero o falso is_success=False
Resultado de JSON
{
    "id": 8527028217,
    "server_id": 2263017,
    "command_id": 164850699,
    "organization_id": 104513,
    "args": "ASD",
    "reboot": 0,
    "exec_time": "2022-10-25T08:02:43+0000",
    "response": [
        "0",
        "Installing MS updates: ASD\\r\\nCouldn't find update for ASD, skipping.\\r\\nNothing left to do",
        null
    ],
    "response_time": "2022-10-25T08:22:14+0000",
    "policy_id": null,
    "agent_command_type": 0,
    "command_type_name": "InstallUpdate"
}
{
    "reason": "Device is offline. Please check the connectivity."
}
Muro de casos
Tipo de resultado Valor/Descripción Tipo
Mensaje de salida*

La acción no debería fallar ni detener la ejecución de una guía:

Si se encuentra el dispositivo y está conectado (is_success=true): "Successfully executed command "{Command}" on the following entities in Automox: {entity.identifier}. Verifica el resultado de JSON para asegurarte de que el comando se haya ejecutado correctamente".

Si no se encuentra el dispositivo o está conectado para una entidad (is_success=true): "Action wasn't able to execute command "{Command}" on the following entities in Automox: {entity.identifier}. Verifica la ortografía y la conectividad".

Si no se encuentra el dispositivo o está conectado para todas las entidades (is_success=false): "No se ejecutaron comandos en las entidades proporcionadas. Verifica la ortografía y la conectividad".

La acción debería fallar y detener la ejecución de una guía:

Si se informa un error fatal, como credenciales incorrectas, falta de conexión con el servidor, etcétera: "Error executing action "Execute Device Command". Reason: {0}''.format(error.Stacktrace)

General

Ejecutar política

Ejecuta una política en Automox.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Alcance de la corrección DDL

Todos los dispositivos

Valores posibles:

  • Solo entidades
  • Todos los dispositivos
No

Especifica el alcance de la corrección para la acción.

Si se selecciona "Solo entidades", la acción ejecuta políticas solo en las entidades válidas del permiso.

Si se selecciona "Todos los dispositivos", la acción ejecuta la política en todos los dispositivos de la organización.

Nombre de la política String N/A No Especifica el nombre de la política que se debe ejecutar.

Fecha de ejecución

Esta acción se ejecuta en las siguientes entidades:

  • Dirección IP
  • Nombre de host

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero o falso is_success=False
Resultado de JSON
{
"status": "done/failure if entity not found"
}
Muro de casos
Tipo de resultado Valor/Descripción Tipo
Mensaje de salida*

La acción no debería fallar ni detener la ejecución de una guía:

Si se corrigió el servidor y se realizó correctamente para una entidad (is_success=true): "Se ejecutó correctamente la política {Policy} en las siguientes entidades de Automox: {entity.identifier}".

Si se corrigió el servidor y no se encuentra un servidor (is_success=true): "Action wasn't able to execute policy {Policy} on the following entities in Automox: {entity.identifier}."

Si se corrigió el servidor y no se encuentran todos los servidores (is_success=false): "No se encontraron entidades. No se ejecutó la política {Policy}".

Si se corrigen todos los servidores (is_success=true): "Se ejecutó correctamente la política {Policy} en Automox".

La acción debería fallar y detener la ejecución de una guía:

Si se informa un error fatal, como credenciales incorrectas, falta de conexión con el servidor, etcétera: "Error executing action "Execute Policy". Reason: {0}''.format(error.Stacktrace)

Si no se encuentra la política: "Error al ejecutar la acción "Ejecutar política". Motivo: No se encontró la política "{policy name}" en Automox. Verifica la ortografía”.''

General

Enumerar políticas

Enumera las políticas disponibles en Automox.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Clave de filtro DDL

Selecciona una opción

Valores posibles:

  • Nombre
  • ID
  • Nombre del tipo de política
  • Estado
No Especifica la clave que se debe usar para filtrar la política.
Lógica de filtrado DDL

No especificado

Valores posibles:

  • No especificado
  • Igual
  • Contiene
No

Especifica la lógica de filtro que se debe aplicar.

La lógica de filtrado funciona según el valor proporcionado en el parámetro "Clave de filtro".

Valor del filtro String N/A No

Especifica el valor que se debe usar en el filtro.

Si se selecciona "Igual", la acción intenta encontrar la coincidencia exacta entre los resultados y, si se selecciona "Contiene", la acción intenta encontrar resultados que contengan esa subcadena.

Si no se proporciona nada en este parámetro, no se aplica el filtro.

La lógica de filtrado funciona según el valor proporcionado en el parámetro "Clave de filtro".

Cantidad máxima de registros que se devolverán Número entero 50 No Especifica la cantidad de registros que se devolverán. Si no se proporciona nada, la acción devuelve 50 registros.

Fecha de ejecución

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero o falso is_success=False
Resultado de JSON
[
    {
        "id": 245687,
        "name": "Apply All Patches",
        "policy_type_name": "patch",
        "organization_id": 104513,
        "configuration": {
            "auto_patch": false,
            "patch_rule": "all",
            "auto_reboot": false,
            "notify_user": false,
            "include_optional": true,
            "notify_reboot_user": true,
            "missed_patch_window": true,
            "custom_notification_max_delays": 3,
            "custom_notification_deferment_periods": [
                1,
                2,
                4
            ]
        },
        "schedule_days": 254,
        "schedule_weeks_of_month": 62,
        "schedule_months": 8190,
        "schedule_time": "17:00",
        "notes": "",
        "create_time": "2022-10-24T08:44:37+0000",
        "server_groups": [
            145150
        ],
        "server_count": 1,
        "status": "inactive"
    }
]
Muro de casos
Tipo de resultado Valor/Descripción Tipo
Mensaje de salida*

La acción no debería fallar ni detener la ejecución de una guía:

Si hay datos disponibles (is_success=true): "Successfully found policies for the provided criteria in Automox".

Si los datos no están disponibles (is_success=false): "No se encontraron políticas para los criterios proporcionados en Automox".

Si el parámetro "Filter Value" está vacío (is_success=true): "The filter was not applied, because parameter "Filter Value" has an empty value."

Si el parámetro "Filter Logic" se establece en "Not Specified" (is_success=true): "The filter was not applied, because parameter "Filter Logic" is not specified."

La acción debería fallar y detener la ejecución de una guía:

Si el parámetro "Filter Key" se establece en "Select One" y el parámetro "Filter Logic" se establece en "Equal" o "Contains": "Error executing action "{action name}". Motivo: Debes seleccionar un campo del parámetro "Clave de filtro".

Si se proporciona un valor no válido para el parámetro "Cantidad máxima de registros que se mostrarán": "Error al ejecutar la acción "{action name}". Motivo: "Se proporcionó un valor no válido para "Cantidad máxima de registros que se mostrarán": . Se debe proporcionar un número positivo"."

Si se informa un error grave, como credenciales incorrectas, falta de conexión con el servidor, etcétera: "Error executing action "List Policies". Reason: {0}''.format(error.Stacktrace)

General
Tabla del muro de casos

Nombre de la tabla: Available Policies

Columnas de la tabla:

  • Nombre - nombre
  • Tipo: policy_type_name
  • ID - id
  • Status - status
  • Notes - notes
General

Ping

Prueba la conectividad con Automox.

Parámetros

N/A

Fecha de ejecución

La acción no se ejecuta en entidades ni tiene parámetros de entrada obligatorios.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero o falso is_success=False
Muro de casos
Tipo de resultado Valor/Descripción Tipo
Mensaje de salida*

La acción no debería fallar ni detener la ejecución de una guía:

Si se realiza correctamente: "Successfully connected to the Automox server with the provided connection parameters!"

La acción debería fallar y detener la ejecución de una guía:

Si no se realiza correctamente, aparecerá el mensaje "Failed to connect to the Automox server! Error is {0}".format(exception.stacktrace)

General

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.