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 Der Standardwert ist |
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 |
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 |
|---|---|
|
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 |
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 Die möglichen Werte sind:
|
Time Frame |
Optional. Der Zeitraum für die Ergebnisse. Der Standardwert ist Die möglichen Werte sind:
Wenn Sie |
Start Time |
Optional. Die Startzeit für die Ergebnisse im ISO 8601-Format. Dieser Parameter ist erforderlich, wenn Sie Die Zeitspanne zwischen Die Aktion verwendet nur den Datumsteil des Zeitstempels. |
End Time |
Optional. Die Endzeit für die Ergebnisse im ISO 8601-Format. Wenn Sie Die Zeitspanne zwischen 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 |
Link zum Fall-Repository
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 |
|---|---|
|
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 Die möglichen Werte sind: |
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 |
|---|---|
|
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 |
|---|---|
|
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 |
Event Field Name |
Pflichtangabe. Der Name des Felds, das den Ereignisnamen (Untertyp) bestimmt. Der Standardwert ist |
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 Verwenden Sie den Standardwert 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 |
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 |
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 |
Currencies To Fetch |
Optional. Die abzurufenden Wechselkurse. Der Standardwert ist |
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:
Der Standardwert ist |
Add Attachment |
Optional. Wenn diese Option aktiviert ist, fügt der Connector der Benachrichtigung ein JSON-Objekt hinzu. Der Standardwert ist |
Max Days Backwards |
Pflichtangabe. Die Anzahl der Tage, für die Benachrichtigungen abgerufen werden sollen. Der Höchstwert ist Der Standardwert ist |
Max Alerts To Fetch |
Pflichtangabe. Die Anzahl der Benachrichtigungen, die in jeder Connector-Iteration verarbeitet werden sollen. Der Standardwert ist |
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
Closedhat.Fügen Sie einem Fall einen Kommentar hinzu, wenn er das Tag
Currencyhat.
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 |
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 |
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