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; | Sì | Radice API dell'istanza di Automox. |
Chiave API | Password | N/D | No | Chiave API dell'istanza di 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 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:
|
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:
|
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:
|
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:
|
No | Specifica la chiave da utilizzare per filtrare le norme. |
Logica di filtro | DDL | Non specificato Valori possibili:
|
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:
|
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.