Integrare Automox con Google SecOps

Questo documento descrive come integrare Automox con Google Security Operations (Google SecOps).

Versione integrazione: 5.0

Parametri di integrazione

Utilizza i seguenti parametri per configurare l'integrazione:

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Root API Stringa https://#123;#123;api_root#125;#125; Radice API dell'istanza di Automox.
Chiave API Password N/D No Chiave API dell'istanza di Automox.
Verifica SSL Casella di controllo Selezionata Se abilitata, verifica che il certificato SSL per la connessione ad Automox sia valido.

Per istruzioni su come configurare un'integrazione in Google SecOps, consulta Configurare le integrazioni.

Se necessario, potrai apportare modifiche in un secondo momento. Dopo aver configurato un'istanza di integrazione, puoi utilizzarla nei playbook. Per saperne di più su come configurare e supportare più istanze, consulta Supportare più istanze.

Come generare la chiave API

Per saperne di più su come generare una chiave API, consulta il passaggio Trova la tua chiave API nella console disponibile nella Guida per principianti per iniziare a utilizzare l'API Automox.

Azioni

Per ulteriori informazioni sulle azioni, vedi Rispondere alle azioni in attesa dalla tua scrivania e Eseguire un'azione manuale.

Arricchisci entità

Arricchisci le entità utilizzando le informazioni di Automox.

Parametri

Nome parametro Tipo Valore predefinito È obbligatorio Descrizione
Restituire patch Casella di controllo Selezionata No

Se attivata, l'azione restituisce un elenco di patch che devono essere aggiornate sulla macchina.

Nota: l'azione non restituisce le patch installate o quelle ignorate.

Numero massimo di patch da restituire Numero intero 50 No Specifica il numero di patch da restituire. Se non viene fornito nulla, l'azione restituisce 50 patch.

Pubblica su

Questa azione viene eseguita sulle seguenti entità:

  • Indirizzo IP
  • Nome host

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore Esempio
is_success Vero/Falso is_success=False
Risultato 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
        }
    ]
}
Arricchimento delle entità
Nome campo di arricchimento Logica - Quando applicarla
id Quando disponibile in formato JSON
agent_version Quando disponibile in formato JSON
conforme Quando disponibile in formato JSON
connessa Quando disponibile in formato JSON
create_time Quando disponibile in formato JSON
custom_name Quando disponibile in formato JSON
ip_addrs_private Quando disponibile in formato JSON
last_disconnect_time Quando disponibile in formato JSON
last_logged_in_user Quando disponibile in formato JSON
last_update_time Quando disponibile in formato JSON
os Quando disponibile in formato JSON
pending_patches Quando disponibile in formato JSON
Tag Quando disponibile in formato JSON
Bacheca casi
Tipo di risultato Valore / Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se i dati sono disponibili per un'entità (is_success=true): "Le seguenti entità sono state arricchite correttamente utilizzando le informazioni di Automox: {entity.identifier}".

Se i dati non sono disponibili per un'entità (is_success=true): "L'azione non è riuscita ad arricchire le seguenti entità utilizzando le informazioni di Automox: {entity.identifier}"

Se i dati non sono disponibili per tutte le entità (is_success=false): "Nessuna delle entità fornite è stata arricchita."

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se viene segnalato un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro: "Errore durante l'esecuzione dell'azione "Arricchisci entità". Motivo: {0}''.format(error.Stacktrace)

Generale
Tabella Bacheca casi

Titolo: {entity.identifier}

Colonne:

  • Chiave
  • Valore
Entità

Esegui comando dispositivo

Esegui un comando sull'endpoint in Automox.

Parametri

Nome parametro Tipo Valore predefinito È obbligatorio Descrizione
Comando DDL

Analizza dispositivo

Valori possibili:

  • Analizza dispositivo
  • Installare patch specifiche
  • Installa tutte le patch disponibili
  • Riavvia dispositivo
No

Specifica un comando da eseguire sul dispositivo.

Nota:se è selezionata l'opzione "Installa patch specifiche", il parametro "Nomi patch" è obbligatorio.

Nomi delle patch CSV N/D No Specifica un elenco separato da virgole delle patch da installare.

Pubblica su

Questa azione viene eseguita sulle seguenti entità:

  • Indirizzo IP
  • Nome host

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore Esempio
is_success Vero/Falso is_success=False
Risultato 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."
}
Bacheca casi
Tipo di risultato Valore / Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se il dispositivo viene trovato ed è connesso (is_success=true): "Successfully executed command "{Command}" on the following entities in Automox: {entity.identifier}. Controlla il risultato JSON per assicurarti che il comando sia stato eseguito correttamente."

Se il dispositivo non viene trovato o è connesso per un'entità (is_success=true): "L'azione non è riuscita a eseguire il comando "{Command}" sulle seguenti entità in Automox: {entity.identifier}. Controlla l'ortografia e la connettività."

Se il dispositivo non viene trovato o è connesso per tutte le entità (is_success=false): "Non sono stati eseguiti comandi sulle entità fornite. Controlla l'ortografia e la connettività."

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se viene segnalato un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro: "Errore durante l'esecuzione dell'azione "Esegui comando dispositivo". Motivo: {0}''.format(error.Stacktrace)

Generale

Esegui policy

Esegui una policy in Automox.

Parametri

Nome parametro Tipo Valore predefinito È obbligatorio Descrizione
Ambito della correzione DDL

Tutti i dispositivi

Valori possibili:

  • Solo entità
  • Tutti i dispositivi
No

Specifica l'ambito di correzione per l'azione.

Se è selezionata l'opzione "Solo entità", l'azione esegue i criteri solo sulle entità valide nell'ambito.

Se è selezionata l'opzione "Tutti i dispositivi", l'azione esegue il criterio su tutti i dispositivi dell'organizzazione.

Nome del criterio Stringa N/D No Specifica il nome della policy da eseguire.

Pubblica su

Questa azione viene eseguita sulle seguenti entità:

  • Indirizzo IP
  • Nome host

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore Esempio
is_success Vero/Falso is_success=False
Risultato JSON
{
"status": "done/failure if entity not found"
}
Bacheca casi
Tipo di risultato Valore / Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se il server è stato corretto e l'operazione è riuscita per un'entità (is_success=true): "Policy {Policy} eseguita correttamente sulle seguenti entità in Automox: {entity.identifier}."

Se il server è stato corretto e non viene trovato un server (is_success=true): "L'azione non è riuscita a eseguire il criterio {Policy} sulle seguenti entità in Automox: {entity.identifier}."

Se il server è stato corretto e tutti i server non vengono trovati (is_success=false): "Nessuna entità trovata. Policy {Policy} non eseguita."

Se correggi tutti i server (is_success=true): "Policy {Policy} eseguita correttamente in Automox."

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se viene segnalato un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro: "Errore durante l'esecuzione dell'azione "Esegui policy". Motivo: {0}''.format(error.Stacktrace)

Se il criterio non viene trovato: "Errore durante l'esecuzione dell'azione "Esegui criterio". Motivo: il criterio "{policy name}" non è stato trovato in Automox. Controlla l'ortografia.''

Generale

Elenco criteri

Elenca le policy disponibili in Automox.

Parametri

Nome parametro Tipo Valore predefinito È obbligatorio Descrizione
Chiave di filtro DDL

Selezionane uno

Valori possibili:

  • Nome
  • ID
  • Nome del tipo di policy
  • Stato
No Specifica la chiave da utilizzare per filtrare le norme.
Logica di filtro DDL

Non specificato

Valori possibili:

  • Non specificato
  • Uguale
  • Contiene
No

Specifica la logica del filtro da applicare.

La logica di filtraggio funziona in base al valore fornito nel parametro "Chiave filtro".

Valore filtro Stringa N/D No

Specifica il valore da utilizzare nel filtro.

Se è selezionato "Uguale", l'azione tenta di trovare la corrispondenza esatta tra i risultati. Se è selezionato "Contiene", l'azione tenta di trovare risultati che contengano quella sottostringa.

Se non viene fornito alcun valore in questo parametro, il filtro non viene applicato.

La logica di filtraggio funziona in base al valore fornito nel parametro "Chiave filtro".

Numero massimo di record da restituire Numero intero 50 No Specifica il numero di record da restituire. Se non viene fornito nulla, l'azione restituisce 50 record.

Pubblica su

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore Esempio
is_success Vero/Falso is_success=False
Risultato 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"
    }
]
Bacheca casi
Tipo di risultato Valore / Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se i dati sono disponibili (is_success=true): "Successfully found policies for the provided criteria in Automox".

Se i dati non sono disponibili (is_success=false): "Non sono state trovate norme per i criteri forniti in Automox".

Se il parametro "Valore filtro" è vuoto (is_success=true): "Il filtro non è stato applicato perché il parametro "Valore filtro" ha un valore vuoto."

Se il parametro "Logica di filtro" è impostato su "Non specificato" (is_success=true): "Il filtro non è stato applicato perché il parametro "Logica di filtro" non è specificato."

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se il parametro "Chiave filtro" è impostato su "Seleziona uno" e la "Logica di filtro" è impostata su "Uguale a" o "Contiene": "Errore durante l'esecuzione dell'azione "{nome azione}". Motivo: devi selezionare un campo dal parametro "Chiave filtro".

Se viene fornito un valore non valido per il parametro "Numero massimo di record da restituire": "Errore durante l'esecuzione dell'azione "{nome azione}". Motivo: "È stato fornito un valore non valido per "Numero massimo di record da restituire": . Deve essere fornito un numero positivo"."

Se viene segnalato un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro: "Errore durante l'esecuzione dell'azione "Elenca criteri". Motivo: {0}''.format(error.Stacktrace)

Generale
Tabella Bacheca casi

Nome tabella: Available Policies

Colonne della tabella:

  • Nome - nome
  • Tipo - policy_type_name
  • ID - id
  • Stato - stato
  • Note - note
Generale

Dindin

Testa la connettività ad Automox.

Parametri

N/D

Pubblica su

L'azione non viene eseguita sulle entità e non ha parametri di input obbligatori.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore Esempio
is_success Vero/Falso is_success=False
Bacheca casi
Tipo di risultato Valore / Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se l'operazione va a buon fine: "Connessione al server Automox riuscita con i parametri di connessione forniti."

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se l'operazione non va a buon fine: "Impossibile connettersi al server Automox. Error is {0}".format(exception.stacktrace)

Generale

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.