Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Axonius in Google SecOps einbinden

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

Anwendungsbereiche

Anreicherungsaktionen ausführen

Integrationsparameter

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

Anzeigename des Parameters	Typ	Standardwert	Ist obligatorisch	Beschreibung
API-Stamm	String	https://{root}	Ja	Axonius-API-Stamm
API-Schlüssel	String	–	Ja	Axonius-API-Schlüssel
API-Secret	Passwort	–	Ja	Axonius API Secret
SSL überprüfen	Kästchen	Aktiviert	Ja	Wenn diese Option ausgewählt ist, validiert die Integration das SSL-Zertifikat, wenn eine Verbindung zum Axonius-Server hergestellt wird.

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.

Aktionen

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

Ping

Testen Sie die Verbindung zu Axonius.

Ausführen am

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

Aktionsergebnisse

Scriptergebnis

Name des Skriptergebnisses	Wertoptionen
is_success	is_success=False
is_success	is_success=True

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 Axonius server with the provided connection parameters!“ (Verbindung zum Axonius-Server mit den angegebenen Verbindungsparametern erfolgreich hergestellt!) Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden: Wenn nicht erfolgreich: „Failed to connect to the Axonius server! Error is {0}".format(exception.stacktrace)	Allgemein

Ergebnistyp

Wert/Beschreibung

Typ

Ausgabenachricht*

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

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

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

Wenn nicht erfolgreich: „Failed to connect to the Axonius server! Error is {0}".format(exception.stacktrace)

Allgemein

Entitäten anreichern

Entitäten mit Informationen von Axonius anreichern. Zu den unterstützten Entitäten gehören Hostname, IP-Adresse, MAC-Adresse, Nutzer und E-Mail-Adressen (Nutzerentitäten, die dem regulären Ausdruck für E-Mails entsprechen).

Parameter

Anzeigename des Parameters	Typ	Standardwert	Ist obligatorisch	Beschreibung
Endpunktstatistik erstellen	Kästchen	Richtig	Nein	Wenn diese Option aktiviert ist, wird eine Statistik mit Informationen zu den Endpunkten erstellt.
Nutzerstatistik erstellen	Kästchen	Richtig	Nein	Wenn diese Option aktiviert ist, wird eine Statistik mit Informationen zum Nutzer erstellt.
Maximale Anzahl zurückzugebender Notizen	Ganzzahl	50	Nein	Geben Sie an, wie viele Notizen in der Tabelle der Fallpinnwand angezeigt werden sollen.

Ausführen am

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

Hostname
IP-Adresse
MAC-Adresse
Nutzer
E-Mail

Aktionsergebnisse

Scriptergebnis

Name des Skriptergebnisses	Wertoptionen
is_success	is_success=False
is_success	is_success=True

JSON-Ergebnis für Endpunkt:

{
    "adapters": [
        {
            "accurate_for_datetime": "Sun, 21 Mar 2021 03:44:19 GMT",
            "client_used": "DOMAIN\\axoniusSvc",
            "raw": {
                "ad_distinguished_name": "CN=DESKTOP-ID,OU=Computers,DC=demo,DC=local",
                "ad_object_class": [
                    "top",
                    "person",
                    "organizationalperson",
                    "user",
                    "computer"
                ],
                "ad_sAMAccountName": "",
                "ad_site_location": "Richmond",
                "ad_site_name": "",
                "device_disabled": false,
                "device_managed_by": "Example User",
                "domain": "example.example",
                "hostname": "HOSTNAME",
                "id": "CN=ID,OU=Computers,DC=demo,DC=local",
                "last_seen": "Tue, 16 Mar 2021 19:44:05 GMT",
                "name": "NAME",
                "network_interfaces": [
                    {
                        "ips": [
                            "IP"
                        ],
                        "ips_raw": [
                            "IP_RAW"
                        ],
                        "ips_v4": [
                            "IP_V4"
                        ],
                        "ips_v4_raw": [
                            "IP_V4_RAW"
                        ]
                    }
                ],
                "os": {
                    "bitness": 64,
                    "distribution": "10",
                    "is_windows_server": false,
                    "os_str": "windows 10 pro 64-bit",
                    "type": "Windows",
                    "type_distribution": "Windows 10"
                },
                "part_of_domain": true
            },
            "plugin_name": "",
            "plugin_type": "Adapter",
            "plugin_unique_name": "",
            "quick_id": "active_directory_adapter_0!CN=ID,OU=OU,DC=DOMAIN,DC=DOMAIN",
            "type": "entitydata"
        },
        {
            "accurate_for_datetime": "Sun, 21 Mar 2021 03:43:52 GMT",
            "client_used": "https://DOMAIN",
            "raw": {
                "hostname": "HOSTNAME",
                "id": "ID",
                "last_seen": "Sun, 21 Mar 2021 01:50:28 GMT",
                "name": "NAME",
                "network_id": "NETWORK_ID",
                "network_interfaces": [
                    {
                        "ips": [
                            "IP"
                        ],
                        "ips_raw": [
                            "IP_RAW"
                        ],
                        "ips_v4": [
                            "IP_V4"
                        ],
                        "ips_v4_raw": [
                            "IP_V4_RAW"
                        ],
                        "mac": "01:23:45:AB:CD:EF",
                        "manufacturer": "(Intel Corporate)"
                    }
                ]
            },
            "plugin_name": "Example",
            "plugin_type": "Adapter",
            "plugin_unique_name": "Example",
            "quick_id": "ID",
            "type": "entitydata"
        }
    ],
"Notes": [],
    "internal_axon_id": "",
    "labels": []
}

JSON-Ergebnis – für Nutzer:

{
    "adapters": [
        {
            "accurate_for_datetime": "Sun, 21 Mar 2021 03:45:01 GMT",
            "client_used": "DOMAIN\\axoniusSvc",
            "raw": {
                "account_disabled": false,
                "ad_display_name": "",
                "ad_distinguished_name": "CN=example, DC=example",
                "ad_sid": "S-1-5-21-70119-3234025",
                "ad_uac_dont_expire_password": false,
                "ad_uac_password_not_required": false,
                "display_name": "",
                "domain": "example.example",
                "employee_id": "ID",
                "first_name": "Example",
                "id": "CN=example, DC=example",
                "is_admin": false,
                "is_local": false,
                "is_locked": false,
                "last_name": "Example",
                "last_password_change": "Wed, 17 Mar 2021 09:12:11 GMT",
                "last_seen": "Thu, 18 Mar 2021 09:25:08 GMT",
                "mail": "email@example.com",
                "password_never_expires": false,
                "password_not_required": false,
                "user_city": "Boston",
                "user_telephone_number": "(800) 555-0175",
                "username": "user@example.com"
            },
            "user_city": "Boston",
            "user_telephone_number": "(800) 555-0175",
            "username": "user@example.com",
            "plugin_name": "active_directory_adapter",
            "plugin_type": "Adapter",
            "plugin_unique_name": "active_directory_adapter_0",
            "quick_id": "active_directory_adapter_0!CN=example,DC=example",
            "type": "entitydata"
        }
    ],
"Notes": [],
    "internal_axon_id": "",
    "labels": []
}

Entitätsanreicherung – für Endpunkte:

Name des Anreicherungsfelds	Logik – Wann anwenden
object_classes	Wenn in JSON verfügbar
site_name	Wenn in JSON verfügbar
device_disabled	Wenn in JSON verfügbar
device_managed_by	Wenn in JSON verfügbar
Hostname	Wenn in JSON verfügbar
ad_distinguished_name	Wenn in JSON verfügbar
asset_name	Wenn in JSON verfügbar
ips	Wenn in JSON verfügbar
os	Wenn in JSON verfügbar
id	Wenn in JSON verfügbar
Link	Wenn in JSON verfügbar

Entitätsanreicherung – für Nutzer:

Name des Anreicherungsfelds	Logik – Wann anwenden
account_disabled	Wenn in JSON verfügbar
ad_display_name	Wenn in JSON verfügbar
ad_distinguished_name	Wenn in JSON verfügbar
ad_sid	Wenn in JSON verfügbar
employee_id	Wenn in JSON verfügbar
is_admin	Wenn in JSON verfügbar
is_local	Wenn in JSON verfügbar
is_locked	Wenn in JSON verfügbar
mail	Wenn in JSON verfügbar
user_telephone_number	Wenn in JSON verfügbar
id	Wenn in JSON verfügbar
Link	Wenn in JSON verfügbar

Fall-Repository

Ergebnistyp	Wert/Beschreibung	Typ (Entität \ Allgemein)
Ausgabenachricht*	Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen: If enriched some(is_success = true): "Successfully enriched the following entities using Axonius:\n".format(entity.identifier) Wenn einige Entitäten nicht angereichert wurden (is_success = true): „Action wasn't able to enriche the following entities using Axonius:\n".format(entity.identifier) Wenn nicht alle angereichert wurden (is_success = false): „Es wurden keine Entitäten 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 Elementen		Entität
Tabelle mit Fall-Repository (wenn Attribute/Daten/Datenliste Werte enthalten)	Name: {entity.identifier}: Notizen Spalte: Nutzername Notiz Zeit	Allgemein

Ergebnistyp

Wert/Beschreibung

Typ (Entität \ Allgemein)

Ausgabenachricht*

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

If enriched some(is_success = true): "Successfully enriched the following entities using Axonius:\n".format(entity.identifier)

Wenn einige Entitäten nicht angereichert wurden (is_success = true): „Action wasn't able to enriche the following entities using Axonius:\n".format(entity.identifier)

Wenn nicht alle angereichert wurden (is_success = false): „Es wurden keine Entitäten 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 Elementen

Entität

Tabelle mit Fall-Repository

(wenn Attribute/Daten/Datenliste Werte enthalten)

Name: {entity.identifier}: Notizen

Spalte:

Nutzername
Notiz
Zeit

Allgemein

Notiz hinzufügen

Fügen Sie Entitäten in Axonius eine Notiz hinzu. Zu den unterstützten Entitäten gehören Hostname, IP-Adresse, MAC-Adresse, Nutzer und E-Mail-Adressen (Nutzerentitäten, die mit dem regulären Ausdruck für E-Mails übereinstimmen).

Parameter

Anzeigename des Parameters	Typ	Standardwert	Ist obligatorisch	Beschreibung
Notiz	String	–	Ja	Geben Sie an, welche Notiz hinzugefügt werden soll.

Ausführen am

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

Hostname
IP-Adresse
MAC-Adresse
Nutzer
E-Mail-Adresse

Aktionsergebnisse

Scriptergebnis

Name des Skriptergebnisses	Wertoptionen
is_success	is_success=False
is_success	is_success=True

JSON-Ergebnis

{
    "data": {
        "attributes": {
            "accurate_for_datetime": "2021-03-21T15:55:10.876568+00:00",
            "note": "example",
            "user_id": "",
            "user_name": "internal/apiNAME",
            "uuid": ""
        },
        "type": "notes_details_schema"
    }
}

Fall-Repository

Ergebnistyp	Wert/Beschreibung	Typ (Entität \ Allgemein)
Ausgabenachricht*	Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen: Wenn mindestens eine Entität erfolgreich hinzugefügt wurde(is_success = true): „Successfully added note to the following entities in Axonius: {0}“.format(entities) Wenn mindestens ein Fehler auftritt(is_success = true): „Action wasn't able to add a note to the following entities in Axonius: {0}“.format(entities) Wenn alle fehlschlagen (is_success = false): „Die Notiz wurde den angegebenen Entitäten nicht hinzugefügt.“ Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden: Bei einem schwerwiegenden Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, sonstiges: „Fehler beim Ausführen der Aktion ‚Notiz hinzufügen‘. Reason: {0}''.format(error.Stacktrace)	Allgemein

Ergebnistyp

Wert/Beschreibung

Typ (Entität \ Allgemein)

Ausgabenachricht*

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

Wenn mindestens eine Entität erfolgreich hinzugefügt wurde(is_success = true): „Successfully added note to the following entities in Axonius: {0}“.format(entities)

Wenn mindestens ein Fehler auftritt(is_success = true): „Action wasn't able to add a note to the following entities in Axonius: {0}“.format(entities)

Wenn alle fehlschlagen (is_success = false): „Die Notiz wurde den angegebenen Entitäten nicht hinzugefügt.“

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

Bei einem schwerwiegenden Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, sonstiges: „Fehler beim Ausführen der Aktion ‚Notiz hinzufügen‘. Reason: {0}''.format(error.Stacktrace)

Allgemein

Tags hinzufügen

Fügen Sie Entitäten in Axonius Tags hinzu. Unterstützte Entitäten: Hostname, IP-Adresse, MAC-Adresse, Nutzer, E-Mail-Adressen (Nutzerentitäten, die mit dem regulären Ausdruck für E-Mails übereinstimmen).

Parameter

Anzeigename des Parameters	Typ	Standardwert	Ist obligatorisch	Beschreibung
Tags	CSV		Ja	Geben Sie eine durch Kommas getrennte Liste von Tags an, die den Entitäten hinzugefügt werden müssen.

Ausführen am

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

Hostname
IP-Adresse
MAC-Adresse
Nutzer
E-Mail-Adresse

Aktionsergebnisse

Scriptergebnis

Name des Skriptergebnisses	Wertoptionen
is_success	is_success=False
is_success	is_success=True

Fall-Repository

Ergebnistyp	Wert/Beschreibung	Typ (Entität \ Allgemein)
Ausgabenachricht*	Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen: Wenn mindestens ein Vorgang erfolgreich war (is_success = true): „Successfully added tags to the following entities in Axonius: {0}“ (Tags wurden den folgenden Entitäten in Axonius hinzugefügt: ).format(entities) Wenn mindestens ein Fehler auftritt(is_success = true): „Action wasn't able to add tags to the following entities in Axonius: {0}“.format(entities) Wenn alle fehlschlagen (is_success = false): „Die Tags wurden den angegebenen Entitäten nicht hinzugefügt.“ 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 ‚Tags hinzufügen‘. Reason: {0}''.format(error.Stacktrace)	Allgemein

Ergebnistyp

Wert/Beschreibung

Typ (Entität \ Allgemein)

Ausgabenachricht*

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

Wenn mindestens ein Vorgang erfolgreich war (is_success = true): „Successfully added tags to the following entities in Axonius: {0}“ (Tags wurden den folgenden Entitäten in Axonius hinzugefügt: ).format(entities)

Wenn mindestens ein Fehler auftritt(is_success = true): „Action wasn't able to add tags to the following entities in Axonius: {0}“.format(entities)

Wenn alle fehlschlagen (is_success = false): „Die Tags wurden den angegebenen Entitäten nicht hinzugefügt.“

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 ‚Tags hinzufügen‘. Reason: {0}''.format(error.Stacktrace)

Allgemein

Tags entfernen

Tags von Entitäten in Axonius entfernen. Unterstützte Entitäten: Hostname, IP, Mac-Adresse, Nutzer, E-Mail-Adressen (Nutzerentitäten, die mit dem regulären Ausdruck für E-Mails übereinstimmen).

Parameter

Anzeigename des Parameters	Typ	Standardwert	Ist obligatorisch	Beschreibung
Tags	CSV		Ja	Geben Sie eine durch Kommas getrennte Liste von Tags an, die aus den Entitäten entfernt werden müssen.

Ausführen am

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

Hostname
IP-Adresse
MAC-Adresse
Nutzer
E-Mail-Adresse

Aktionsergebnisse

Scriptergebnis

Name des Skriptergebnisses	Wertoptionen
is_success	is_success=False
is_success	is_success=True

Fall-Repository

Ergebnistyp	Wert/Beschreibung	Typ (Entität \ Allgemein)
Ausgabenachricht*	Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen: Wenn mindestens ein Erfolg(is_success = true): „Successfully removed tags from the following entities in Axonius: {0}“.format(entities) if at least fail for one(is_success = true): „Action wasn't able to remove tags from the following entities in Axonius: {0}“.format(entities) Wenn alle fehlschlagen (is_success = false): „Tags wurden nicht aus den angegebenen Entitäten entfernt.“ 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 ‚Tags entfernen‘. Reason: {0}''.format(error.Stacktrace)	Allgemein

Ergebnistyp

Wert/Beschreibung

Typ (Entität \ Allgemein)

Ausgabenachricht*

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

Wenn mindestens ein Erfolg(is_success = true): „Successfully removed tags from the following entities in Axonius: {0}“.format(entities)

if at least fail for one(is_success = true): „Action wasn't able to remove tags from the following entities in Axonius: {0}“.format(entities)

Wenn alle fehlschlagen (is_success = false): „Tags wurden nicht aus den angegebenen Entitäten entfernt.“

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 ‚Tags entfernen‘. Reason: {0}''.format(error.Stacktrace)

Allgemein

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