Automox in Google SecOps einbinden

In diesem Dokument wird beschrieben, wie Sie Automox in Google Security Operations (Google SecOps) einbinden.

Integrationsparameter

Verwenden Sie die folgenden Parameter, um die Integration zu konfigurieren:

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
API-Stamm String https://#123;#123;api_root#125;#125; Ja API-Stamm der Automox-Instanz.
API-Schlüssel Passwort – Nein API-Schlüssel der Automox-Instanz.
SSL überprüfen Kästchen Aktiviert Ja Wenn diese Option aktiviert ist, wird geprüft, ob das SSL-Zertifikat für die Verbindung zu Automox gültig ist.

Eine Anleitung zum Konfigurieren einer Integration in Google SecOps finden Sie unter Integrationen konfigurieren.

Sie können später bei Bedarf Änderungen vornehmen. Nachdem Sie eine Integrationsinstanz konfiguriert haben, können Sie sie in Playbooks verwenden. Weitere Informationen zum Konfigurieren und Unterstützen mehrerer Instanzen finden Sie unter Mehrere Instanzen unterstützen.

API-Schlüssel generieren

Weitere Informationen zum Generieren eines API-Schlüssels finden Sie im Dokument „Newbie's Guide to Getting Started with Automox API“ im Schritt Find your API key in the console.

Aktionen

Weitere Informationen zu Aktionen finden Sie unter Auf ausstehende Aktionen im Workdesk reagieren und Manuelle Aktion in einem Fall ausführen.

Entitäten anreichern

Entitäten mit Informationen von Automox anreichern.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Patches zurückgeben Kästchen Aktiviert Nein

Wenn diese Option aktiviert ist, gibt die Aktion eine Liste der Patches zurück, die auf dem Computer aktualisiert werden müssen.

Hinweis: Die Aktion gibt keine Patches zurück, die installiert oder ignoriert wurden.
Maximale Anzahl zurückzugebender Patches Ganzzahl 50 Nein Geben Sie die Anzahl der Patches an, die zurückgegeben werden sollen. Wenn nichts angegeben ist, gibt die Aktion 50 Patches zurück.

Ausführen am

Diese Aktion wird für die folgenden Entitäten ausgeführt:

  • IP-Adresse
  • Hostname

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success=False
JSON-Ergebnis
{
    "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
        }
    ]
}
Entitätsanreicherung
Name des Anreicherungsfelds Logik – Wann anwenden
id Wenn in JSON verfügbar
agent_version Wenn in JSON verfügbar
konform Wenn in JSON verfügbar
verbunden Wenn in JSON verfügbar
create_time Wenn in JSON verfügbar
custom_name Wenn in JSON verfügbar
ip_addrs_private Wenn in JSON verfügbar
last_disconnect_time Wenn in JSON verfügbar
last_logged_in_user Wenn in JSON verfügbar
last_update_time Wenn in JSON verfügbar
os Wenn in JSON verfügbar
pending_patches Wenn in JSON verfügbar
Tags Wenn in JSON verfügbar
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn Daten für eine Entität verfügbar sind (is_success=true): „Die folgenden Entitäten wurden erfolgreich mit Informationen von Automox angereichert: {entity.identifier}“.

Wenn für eine Entität keine Daten verfügbar sind (is_success=true): „Die Aktion konnte die folgenden Entitäten nicht mit Informationen von Automox anreichern: {entity.identifier}“

Wenn für alle Entitäten keine Daten verfügbar sind (is_success=false): „Keine der bereitgestellten Entitäten wurde angereichert.“

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Wenn ein schwerwiegender Fehler gemeldet wird, z. B. falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler: „Fehler beim Ausführen der Aktion ‚Entitäten anreichern‘. Reason: {0}''.format(error.Stacktrace)

 Allgemein
Tabelle mit Fall-Repository

Titel: {entity.identifier}

Spalten:

  • Schlüssel
  • Wert
 Entität

Gerätebefehl ausführen

Führen Sie in Automox einen Befehl auf dem Endpunkt aus.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Befehl DDL

Gerät prüfen

Mögliche Werte:

  • Gerät prüfen
  • Bestimmte Patches installieren
  • Alle verfügbaren Patches installieren
  • Gerät neu starten
 Nein

Geben Sie einen Befehl an, der auf dem Gerät ausgeführt werden soll.

Hinweis: Wenn „Bestimmte Patches installieren“ ausgewählt ist, ist der Parameter „Patchnamen“ erforderlich.
Patchnamen CSV – Nein Geben Sie eine durch Kommas getrennte Liste der Patches an, die installiert werden müssen.

Ausführen am

Diese Aktion wird für die folgenden Entitäten ausgeführt:

  • IP-Adresse
  • Hostname

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success=False
JSON-Ergebnis
{
    "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."
}
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn das Gerät gefunden wird und verbunden ist (is_success=true): „Der Befehl ‚{Command}‘ wurde auf den folgenden Entitäten in Automox erfolgreich ausgeführt: {entity.identifier}. Prüfen Sie das JSON-Ergebnis, um sicherzugehen, dass der Befehl korrekt ausgeführt wurde.“

Wenn das Gerät nicht gefunden wird oder für eine Entität verbunden ist (is_success=true): „Die Aktion konnte den Befehl ‚{Command}‘ für die folgenden Entitäten in Automox nicht ausführen: {entity.identifier}. Bitte überprüfe die Schreibweise und die Verbindung.“

Wenn das Gerät nicht gefunden wird oder für alle Entitäten verbunden ist (is_success=false): „Für die angegebenen Entitäten wurden keine Befehle ausgeführt. Bitte überprüfe die Schreibweise und die Verbindung.“

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Wenn ein schwerwiegender Fehler wie falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Gerätebefehl ausführen‘. Reason: {0}''.format(error.Stacktrace)

 Allgemein

Richtlinie ausführen

Führen Sie eine Richtlinie in Automox aus.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Umfang der Abhilfe DDL

Alle Geräte

Mögliche Werte:

  • Nur Entitäten
  • Alle Geräte
 Nein

Geben Sie den Bereich für die Abhilfemaßnahme an.

Wenn „Nur Entitäten“ ausgewählt ist, werden die Richtlinien nur auf die gültigen Entitäten im Geltungsbereich angewendet.

Wenn „Alle Geräte“ ausgewählt ist, wird die Richtlinie auf allen Geräten in der Organisation ausgeführt.
Richtlinienname String – Nein Geben Sie den Namen der Richtlinie an, die ausgeführt werden soll.

Ausführen am

Diese Aktion wird für die folgenden Entitäten ausgeführt:

  • IP-Adresse
  • Hostname

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success=False
JSON-Ergebnis
{
"status": "done/failure if entity not found"
}
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn der Server korrigiert wurde und die Korrektur für eine Entität erfolgreich war (is_success=true): „Die Richtlinie {Policy} wurde für die folgenden Entitäten in Automox erfolgreich ausgeführt: {entity.identifier}.“

Wenn der Server korrigiert wurde und ein Server nicht gefunden wird (is_success=true): „Die Aktion konnte die Richtlinie {Policy} für die folgenden Entitäten in Automox nicht ausführen: {entity.identifier}.“

Wenn der Server korrigiert wurde und alle Server nicht gefunden werden (is_success=false): „Es wurden keine Entitäten gefunden. Die Richtlinie {Policy} wurde nicht ausgeführt.“

Wenn alle Server korrigiert wurden (is_success=true): „Die Richtlinie {Policy} wurde in Automox erfolgreich ausgeführt.“

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Wenn ein schwerwiegender Fehler wie falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Richtlinie ausführen‘. Reason: {0}''.format(error.Stacktrace)

Wenn die Richtlinie nicht gefunden wird: „Fehler beim Ausführen der Aktion ‚Richtlinie ausführen‘. Grund: Die Richtlinie „{policy name}“ wurde in Automox nicht gefunden. Bitte überprüfen Sie die Schreibweise.''

Allgemein

Richtlinien auflisten

Listen Sie die verfügbaren Richtlinien in Automox auf.

Parameter

Parametername Typ Standardwert Ist obligatorisch Beschreibung
Filterschlüssel DDL

Wählen Sie eine Option aus.

Mögliche Werte:

  • Name
  • ID
  • Name des Richtlinientyps
  • Status
 Nein Geben Sie den Schlüssel an, der zum Filtern der Richtlinie verwendet werden soll.
Filterlogik DDL

Nicht angegeben

Mögliche Werte:

  • Nicht angegeben
  • Gleich
  • Enthält
 Nein

Geben Sie die Filterlogik an, die angewendet werden soll.

Die Filterlogik basiert auf dem Wert, der im Parameter „Filterschlüssel“ angegeben ist.
Filterwert String – Nein

Geben Sie den Wert an, der im Filter verwendet werden soll.

Wenn „Gleich“ ausgewählt ist, wird nach einer genauen Übereinstimmung in den Ergebnissen gesucht. Wenn „Enthält“ ausgewählt ist, wird nach Ergebnissen gesucht, die diesen Teilstring enthalten.

Wenn für diesen Parameter nichts angegeben ist, wird der Filter nicht angewendet.

Die Filterlogik basiert auf dem Wert, der im Parameter „Filterschlüssel“ angegeben ist.
Maximale Anzahl zurückzugebender Datensätze Ganzzahl 50 Nein Geben Sie die Anzahl der zurückzugebenden Datensätze an. Wenn nichts angegeben ist, gibt die Aktion 50 Einträge zurück.

Ausführen am

Diese Aktion wird nicht für Entitäten ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success=False
JSON-Ergebnis
[
    {
        "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"
    }
]
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn Daten verfügbar sind (is_success=true): „In Automox wurden Richtlinien für die angegebenen Kriterien gefunden.“

Wenn keine Daten verfügbar sind (is_success=false): „In Automox wurden keine Richtlinien für die angegebenen Kriterien gefunden.“

Wenn der Parameter „Filterwert“ leer ist (is_success=true): „Der Filter wurde nicht angewendet, weil der Parameter ‚Filterwert‘ leer ist.“

Wenn der Parameter „Filterlogik“ auf „Nicht angegeben“ festgelegt ist (is_success=true): „Der Filter wurde nicht angewendet, weil der Parameter ‚Filterlogik‘ nicht angegeben ist.“

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Wenn der Parameter „Filter Key“ auf „Select One“ und „Filter Logic“ auf „Equal“ oder „Contains“ gesetzt ist: „Error executing action „{action name}“. Grund: Sie müssen ein Feld aus dem Parameter „Filterschlüssel“ auswählen.“

Wenn für den Parameter „Max Records to Return“ ein ungültiger Wert angegeben wird: „Fehler beim Ausführen der Aktion ‚{action name}‘. Grund: „Für ‚Max. Anzahl der zurückzugebenden Datensätze‘ wurde ein ungültiger Wert angegeben: . Es muss eine positive Zahl angegeben werden."

Wenn ein schwerwiegender Fehler wie falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Richtlinien auflisten‘. Reason: {0}''.format(error.Stacktrace)

 Allgemein
Tabelle mit Fall-Repository

Tabellenname: Verfügbare Richtlinien

Tabellenspalten:

  • Name - name
  • Typ – policy_type_name
  • ID - id
  • Status – Status
  • Notizen – Notizen
 Allgemein

Ping

Testen Sie die Verbindung zu Automox.

Parameter

–

Ausführen am

Die Aktion wird nicht für Entitäten ausgeführt und hat keine obligatorischen Eingabeparameter.

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success=False
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Bei Erfolg: „Successfully connected to the Automox server with the provided connection parameters!“ (Verbindung zum Automox-Server mit den angegebenen Verbindungsparametern erfolgreich hergestellt!)

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Wenn nicht erfolgreich: „Verbindung zum Automox-Server konnte nicht hergestellt werden! Error is {0}".format(exception.stacktrace)

 Allgemein

Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten