Beispielintegration in Google SecOps einbinden

Dieses Dokument ist ein umfassender Leitfaden für eine Beispielintegration, die gängige Designmuster für das Erstellen von Aktionen, Connectors und Jobs für Google Security Operations (Google SecOps) veranschaulicht.

Integrationsparameter

Für die Beispielintegration sind die folgenden Parameter erforderlich:

Parameter Beschreibung
API Root

Pflichtangabe.

Der API-Stamm für die Integrationsinstanz.

In diesem Beispiel wird der Dienst VAT Comply mit dem API-Stamm api.vatcomply.com eingebunden.

Der Standardwert ist http://api.vatcomply.com.

Password Field

Optional.

Beispiel für ein API-Passwortfeld.

Dieser Parameter dient nur zu Demonstrationszwecken und ist für die Authentifizierung durch die API nicht erforderlich.

Der Standardwert ist Google SecOps.

Verify SSL

Pflichtangabe.

Wenn diese Option ausgewählt ist, wird das SSL-Zertifikat des API-Servers validiert.

Standardmäßig ausgewählt.

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

Verwenden Sie die Aktion Ping, um die Verbindung zur Integration zu testen.

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

Aktionseingaben

Keine.

Aktionsausgaben

Die Aktion Ping liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Nicht verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis. Verfügbar
Ausgabenachrichten

Die Aktion Ping kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Beschreibung der Nachricht

Successfully connected to the API Service server with the provided connection parameters!

Die Aktion war erfolgreich.
Failed to connect to the API Service server! Error is ERROR_REASON

Die Aktion ist fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses bei Verwendung der Aktion Ping aufgeführt:

Name des Skriptergebnisses Wert
is_success True oder False

Beispiel für eine einfache Aktion

Dies ist ein Beispiel für eine einfache Aktion in Google SecOps.

Mit dieser Aktion werden Daten vom api.vatcomply.com-Dienst basierend auf den angegebenen Parametern abgerufen.

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

Aktionseingaben

Parameter Beschreibung
Currencies String

Dies ist ein Beispiel für einen Parameter, der eine durch Kommas getrennte Liste von Werten akzeptiert.

Optional.

Eine durch Kommas getrennte Liste der zu verarbeitenden Währungen.

Der Standardwert ist USD, EUR.

Currencies DDL

Dies ist ein Beispiel für einen Parameter, der eine Drop-down-Liste mit Werten akzeptiert.

Optional.

Eine Drop-down-Liste der zu verarbeitenden Währungen.

Der Standardwert ist Select One.

Die möglichen Werte sind:

  • Select One
  • USD
  • EUR
  • CAD
Time Frame

Optional.

Der Zeitraum für die Ergebnisse.

Der Standardwert ist Today.

Die möglichen Werte sind:

  • Today
  • Last 7 Days
  • Custom

Wenn Sie Custom auswählen, müssen Sie auch einen Wert für den Parameter Start Time angeben.

Start Time

Optional.

Die Startzeit für die Ergebnisse im ISO 8601-Format.

Dieser Parameter ist erforderlich, wenn Sie Custom für den Parameter Time Frame auswählen.

Die Zeitspanne zwischen Start Time und End Time darf nicht mehr als sieben Tage betragen.

Die Aktion verwendet nur den Datumsteil des Zeitstempels.

End Time

Optional.

Die Endzeit für die Ergebnisse im ISO 8601-Format.

Wenn Sie Custom für Time Frame auswählen und keinen Wert angeben, wird für die Aktion die aktuelle Zeit verwendet.

Die Zeitspanne zwischen Start Time und End Time darf nicht mehr als sieben Tage betragen.

Die Aktion verwendet nur den Datumsteil des Zeitstempels.

Return JSON Result

Dies ist ein Beispiel für eine boolesche Eingabe.

Optional.

Wenn diese Option aktiviert ist, gibt die Aktion ein JSON-Ergebnis zurück.

Standardmäßig ausgewählt.

Aktionsausgaben

Die Aktion Search Graphs liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Verfügbar
Link zum Fall-Repository Verfügbar
Tabelle mit Fall-Repository Verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar

Die Aktion gibt den folgenden Link zurück:

  • Währung: https://www.vatcomply.com/currencies/BASE_CURRENCY/date/DATE
Tabelle mit Fall-Repository

Die Aktion stellt für jede API-Antwort die folgende Tabelle bereit:

Tabellenname: Currency: {base} - {date}

Tabellenspalten:

  • Währung (rate.keyname)
  • Wert (rate.keyname.value)
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion empfangen wird:

[
   {
       "date": "2000-03-03",
       "exchange_rates": [
           {
               "base": "USD",
               "rates": {
                   "EUR": 1.035303861683404,
                   "USD": 1.0,
                   "JPY": 107.8476032715602,
                   "CYP": 0.5955481933947614,
                   "CZK": 36.87752355316285,
                   "DKK": 7.711357283362667,
                   "EEK": 16.19898540221555,
                   "GBP": 0.6332953721917383,
                   "HUF": 265.60720571487735,
                   "LTL": 4.001035303861683,
                   "LVL": 0.5954032508541256,
                   "MTL": 0.4235428098146806,
                   "PLN": 4.125168236877524,
                   "ROL": 18961.590226731547,
                   "SEK": 8.769023708458434,
                   "SIT": 209.5625841184388,
                   "SKK": 43.26845429133451,
                   "CHF": 1.6630085930220522,
                   "ISK": 73.39269075473652,
                   "NOK": 8.369396417848638,
                   "TRL": 574745.8329019567,
                   "AUD": 1.647479035096801,
                   "CAD": 1.454705456051351,
                   "HKD": 7.782379128274149,
                   "KRW": 1119.9503054146392,
                   "NZD": 2.0485557511129517,
                   "SGD": 1.7232632777720263,
                   "ZAR": 6.4730303344031475
               }
           },
           {
               "base": "EUR",
               "rates": {
                   "EUR": 1.0,
                   "USD": 0.9659,
                   "JPY": 104.17,
                   "CYP": 0.57524,
                   "CZK": 35.62,
                   "DKK": 7.4484,
                   "EEK": 15.6466,
                   "GBP": 0.6117,
                   "HUF": 256.55,
                   "LTL": 3.8646,
                   "LVL": 0.5751,
                   "MTL": 0.4091,
                   "PLN": 3.9845,
                   "ROL": 18315.0,
                   "SEK": 8.47,
                   "SIT": 202.4165,
                   "SKK": 41.793,
                   "CHF": 1.6063,
                   "ISK": 70.89,
                   "NOK": 8.084,
                   "TRL": 555147.0,
                   "AUD": 1.5913,
                   "CAD": 1.4051,
                   "HKD": 7.517,
                   "KRW": 1081.76,
                   "NZD": 1.9787,
                   "SGD": 1.6645,
                   "ZAR": 6.2523
               }
           }
       ]
   }
]
Ausgabenachrichten

Die Aktion kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Beschreibung der Nachricht

Successfully returned information about the following currencies from START_TIME to END_TIME: "CURRENCIES"

Die Aktion war erfolgreich.
Error executing action "ACTION_NAME". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses bei Verwendung der Aktion aufgeführt:

Name des Skriptergebnisses Wert
is_success True oder False

Beispiel für die Aktion „Entität anreichern“

Dies ist ein Beispiel für eine Aktion, die mit Entitäten in Google SecOps funktioniert und diese anreichert.

Diese Aktion wird für alle Google SecOps-Entitäten ausgeführt, die im Parameter Entity Type angegeben sind.

Aktionseingaben

Für die Aktion Entität anreichern sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Entity Type

Pflichtangabe.

Die Entitäten aus dem Bereich der Benachrichtigung, die verarbeitet werden sollen.

Der Standardwert ist All Entities.

Die möglichen Werte sind:

  • IP
  • Hash
  • User

Aktionsausgaben

Die Aktion Entität anreichern liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Tabelle mit Entitätsanreicherungen Verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
Tabelle mit Entitätsanreicherungen

Die Aktion Entität anreichern unterstützt die folgende Anreicherung für Entitäten:

Anreicherungsfeld Quelle (JSON-Schlüssel) Gültigkeit
SampleIntegration_enriched true Wenn im JSON-Ergebnis verfügbar.
SampleIntegration_timestamp timestamp Wenn im JSON-Ergebnis verfügbar.
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Entität anreichern empfangen wird:

{
   "Entity": "Entity",
   "EntityResult": [
       {
           "enriched": "true",
           "timestamp": "12123213123"
       }
   ]
}
Ausgabenachrichten

Die Aktion Entität anreichern kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Beschreibung der Nachricht

Successfully enriched the following entities: ENTITIES

Die Aktion war erfolgreich.
No eligible entities were found in the scope of the alert.

Die Aktion ist fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle sind die Werte für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Entität anreichern verwendet wird:

Name des Skriptergebnisses Wert
is_success True oder False

Beispiel für einen asynchronen Vorgang

Dies ist ein Beispiel für eine asynchrone Aktion in Google SecOps.

Die Aktion wird erst abgeschlossen, wenn das Zeitlimit erreicht ist oder die Fälle ein im Parameter Case Tag To Wait For angegebenes Tag haben.

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

Aktionseingaben

Für die Aktion Async sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Case IDs

Optional.

Eine durch Kommas getrennte Liste der zu bearbeitenden Fälle.

Wenn nichts angegeben ist, wird die Fall-ID verwendet, von der aus die Aktion ausgeführt wurde.

Case Tag To Wait For

Pflichtangabe.

Die Aktion wartet, bis Fälle mit diesem Wert getaggt wurden, bevor sie die Ausführung beendet.

Aktionsausgaben

Die Aktion Asynchron liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Tabelle mit Entitätsanreicherungen Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Async zurückgegeben wird:

[{
   "case_id": "123",
   "tags": ["Async"]
}, {
   "case_id": "123",
   "tags": ["Async"]
},]
Ausgabenachrichten

Die Aktion Async kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Beschreibung der Nachricht

The following cases have tag TAG: CASE_ID

Die Aktion war erfolgreich.
Error executing action "Async Action Example". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle sind die Werte für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Async verwendet wird:

Name des Skriptergebnisses Wert
is_success True oder False

Connectors

Weitere Informationen zum Konfigurieren von Connectors in Google SecOps finden Sie unter Daten aufnehmen (Connectors).

Beispielintegration – Beispiel für einen einfachen Connector

Verwenden Sie die Beispielintegration – Einfaches Connector-Beispiel, um Währungskurse und andere Daten vom api.vatcomply.com-Dienst abzurufen.

Wenn Sie mit einer dynamischen Liste arbeiten möchten, verwenden Sie den Parameter alert_type.

Connector-Eingaben

Für den Google Threat Intelligence – DTM Alerts Connector sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Product Field Name

Pflichtangabe.

Der Name des Felds, in dem der Produktname gespeichert ist.

Der Produktname wirkt sich hauptsächlich auf die Zuordnung aus. Um den Zuordnungsprozess für den Connector zu optimieren und zu verbessern, wird der Standardwert in einen Fallback-Wert aufgelöst, auf den im Code verwiesen wird. Jede ungültige Eingabe für diesen Parameter wird standardmäßig in einen Fallback-Wert aufgelöst.

Der Standardwert ist Product Name.

Event Field Name

Pflichtangabe.

Der Name des Felds, das den Ereignisnamen (Untertyp) bestimmt.

Der Standardwert ist event_type.

Environment Field Name

Optional.

Der Name des Felds, in dem der Umgebungsname gespeichert ist.

Wenn das Feld „environment“ fehlt, verwendet der Connector den Standardwert.

Der Standardwert ist "".

Environment Regex Pattern

Optional.

Ein reguläres Ausdrucksmuster, das für den im Feld Environment Field Name gefundenen Wert ausgeführt werden soll. Mit diesem Parameter können Sie das Umgebungsfeld mithilfe der Logik regulärer Ausdrücke bearbeiten.

Verwenden Sie den Standardwert .*, um den erforderlichen Rohwert Environment Field Name abzurufen.

Wenn das Muster des regulären Ausdrucks null oder leer ist oder der Umgebungswert null ist, ist das endgültige Umgebungsergebnis die Standardumgebung.

Script Timeout (Seconds)

Pflichtangabe.

Das Zeitlimit in Sekunden für den Python-Prozess, der das aktuelle Script ausführt.

Der Standardwert ist 180.

API Root

Pflichtangabe.

Der API-Stamm für die Integrationsinstanz.

In diesem Beispiel wird der Dienst [VAT Comply](https://www.vatcomply.com/) mit dem API-Stamm „api.vatcomply.com“ eingebunden.

Der Standardwert ist http://api.vatcomply.com.

Password Field

Optional.

Beispiel für ein API-Passwortfeld.

Dieser Parameter dient nur zu Demonstrationszwecken und ist für die Authentifizierung durch die API nicht erforderlich.

Der Standardwert ist Google SecOps.

Currencies To Fetch

Optional.

Die abzurufenden Wechselkurse.

Der Standardwert ist USD, EUR.

Create Alert Per Exchange Rate

Optional.

Wenn diese Option aktiviert ist, erstellt der Connector für jeden Wechselkurs eine separate Benachrichtigung.

Alert Severity

Optional.

Der Schweregrad der Benachrichtigung.

Die möglichen Werte sind:

  • Critical
  • High
  • Medium
  • Low
  • Informational

Der Standardwert ist Informational.

Add Attachment

Optional.

Wenn diese Option aktiviert ist, fügt der Connector der Benachrichtigung ein JSON-Objekt hinzu.

Der Standardwert ist True.

Max Days Backwards

Pflichtangabe.

Die Anzahl der Tage, für die Benachrichtigungen abgerufen werden sollen.

Der Höchstwert ist 30.

Der Standardwert ist 1.

Max Alerts To Fetch

Pflichtangabe.

Die Anzahl der Benachrichtigungen, die in jeder Connector-Iteration verarbeitet werden sollen.

Der Standardwert ist 3.

Use dynamic list as a blocklist

Pflichtangabe.

Wenn diese Option ausgewählt ist, verwendet der Connector die dynamische Liste als Sperrliste.

Standardmäßig nicht ausgewählt.

Disable Overflow

Optional.

Wenn diese Option ausgewählt ist, ignoriert der Connector den Google SecOps-Überlaufmechanismus.

Standardmäßig ausgewählt.

Verify SSL

Pflichtangabe.

Wenn diese Option ausgewählt ist, wird das SSL-Zertifikat des API-Servers validiert.

Standardmäßig ausgewählt.

Proxy Server Address

Optional.

Die Adresse des zu verwendenden Proxyservers.

Proxy Username

Optional.

Der Proxy-Nutzername für die Authentifizierung.

Proxy Password

Optional.

Das Proxy-Passwort für die Authentifizierung.

Jobs

Die Beispielintegration ermöglicht die Verwendung des folgenden Jobs:

Einfaches Jobbeispiel

Verwenden Sie den Job Simple Job Example, um Fälle automatisch zu verwalten.

Dieser Job hat zwei Hauptfunktionen:

  • Schließe einen Fall, wenn er das Tag Closed hat.

  • Fügen Sie einem Fall einen Kommentar hinzu, wenn er das Tag Currency hat.

Job-Eingaben

Verwenden Sie die folgenden Parameter, um diesen Job zu konfigurieren:

Parameter
API Root

Pflichtangabe.

Der API-Stamm für die Integrationsinstanz.

In diesem Beispiel wird der Dienst [VAT Comply](https://www.vatcomply.com/) mit dem API-Stamm „api.vatcomply.com“ eingebunden.

Der Standardwert ist http://api.vatcomply.com.

Password Field

Optional.

Beispiel für ein API-Passwortfeld.

Dieser Parameter dient nur zu Demonstrationszwecken und ist für die Authentifizierung durch die API nicht erforderlich.

Der Standardwert ist Google SecOps.

Verify SSL

Pflichtangabe.

Wenn diese Option ausgewählt ist, wird das SSL-Zertifikat des API-Servers validiert.

Standardmäßig ausgewählt.

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