Integra Automox con Google SecOps

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

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; Sì Radice API dell'istanza Automox.
Chiave API Password N/D No Chiave API dell'istanza Automox.
Verifica SSL Casella di controllo Selezionata Sì 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 Configura le integrazioni.

Se necessario, puoi 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 Supporto di più istanze.

Come generare una chiave API

Per saperne di più su come generare una chiave API, consulta il passaggio Trova la chiave API nella console disponibile nel documento Newbie's Guide to Getting Started with Automox API.

Azioni

Per saperne di più sulle azioni, consulta Rispondi alle azioni in attesa dalla scrivania di lavoro ed Esegui un'azione manuale nel tuo caso.

Arricchisci le entità

Arricchisci le entità utilizzando le informazioni di Automox.

Parametri

Nome parametro Tipo Valore predefinito Obbligatorio Descrizione
Restituisci patch Casella di controllo Selezionata No

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

Nota: l'azione non restituisce le patch che sono state installate o quelle che sono state ignorate.
Numero massimo di patch da restituire Numero intero 50 No Specifica il numero di patch da restituire. Se non viene fornito alcun valore, 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 del campo di arricchimento Logica: quando applicarle
id Se disponibile in JSON
agent_version Se disponibile in JSON
conforme Se disponibile in JSON
connesso Se disponibile in JSON
create_time Se disponibile in JSON
custom_name Se disponibile in JSON
ip_addrs_private Se disponibile in JSON
last_disconnect_time Se disponibile in JSON
last_logged_in_user Se disponibile in JSON
last_update_time Se disponibile in JSON
os Se disponibile in JSON
pending_patches Se disponibile in JSON
Tag Se disponibile in JSON
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output*

L'azione non deve avere esito negativo 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 è stata in grado di 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 dovrebbe 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à". Reason: {0}''.format(error.Stacktrace)

 Generale
Tabella della 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 il dispositivo

Valori possibili:

  • Analizza il dispositivo
  • Installa 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 di 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 avere esito negativo né interrompere l'esecuzione di un playbook:

Se il dispositivo viene trovato ed è connesso (is_success=true): "Comando "{Command}" eseguito correttamente sulle seguenti entità 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 dovrebbe 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". Reason: {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 la policy 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 avere esito negativo né interrompere l'esecuzione di un playbook:

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

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

Se il server è stato corretto e non vengono trovati tutti i server (is_success=false): "Non sono state trovate entità. La policy {Policy} non è stata eseguita."

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

L'azione dovrebbe 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". Reason: {0}''.format(error.Stacktrace)

Se la policy non viene trovata: "Errore durante l'esecuzione dell'azione "Esegui policy". Motivo: la policy "{policy name}" non è stata trovata in Automox. Controlla l'ortografia."

Generale

Elenco criteri

Elenca le policy disponibili in Automox.

Parametri

Nome parametro Tipo Valore predefinito Obbligatorio Descrizione
Chiave filtro DDL

Selezionane uno

Valori possibili:

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

Non specificato

Valori possibili:

  • Non specificato
  • Uguale
  • Contiene
 No

Specifica la logica di filtro da applicare.

La logica di filtro funziona in base al valore fornito nel parametro "Filter Key".
Valore filtro Stringa N/D No

Specifica il valore da utilizzare nel filtro.

Se è selezionata l'opzione "Uguale", l'azione tenta di trovare la corrispondenza esatta tra i risultati, mentre se è selezionata l'opzione "Contiene", l'azione tenta di trovare i risultati che contengono la sottostringa.

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

La logica di filtro funziona in base al valore fornito nel parametro "Filter Key".
Numero massimo di record da restituire Numero intero 50 No Specifica il numero di record da restituire. Se non viene fornito alcun valore, 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 avere esito negativo 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 policy per i criteri forniti in Automox."

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

Se il parametro "Filter Logic" è impostato su "Not Specified" (is_success=true): "The filter was not applied, because parameter "Filter Logic" is not specified."

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

Se il parametro "Filter Key" è impostato su "Select One" e "Filter Logic" è impostato su "Equal" o "Contains": "Error executing action "{action name}". Motivo: devi selezionare un campo dal parametro "Chiave filtro".

Se viene fornito un valore non valido per il parametro "Max Records to Return" (Numero massimo di record da restituire): "Errore durante l'esecuzione dell'azione "{action name}". 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 policy". Reason: {0}''.format(error.Stacktrace)

 Generale
Tabella della bacheca casi

Nome tabella: Policy disponibili

Colonne della tabella:

  • Nome - nome
  • Tipo: policy_type_name
  • ID - id
  • Status - status
  • Notes - notes
 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 avere esito negativo né interrompere l'esecuzione di un playbook:

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

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

In caso contrario: "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.