Wiz in Google SecOps einbinden
In diesem Dokument wird beschrieben, wie Sie Wiz in Google Security Operations (Google SecOps) einbinden.
Hinweis
Für die Integration benötigen Sie einen API-Stamm, eine Client-ID und einen Clientschlüssel.
Weitere Informationen zum Generieren dieser Anmeldedaten finden Sie unter Dienstkontoeinstellungen.
Erforderliche Dienstkontoberechtigungen und -bereiche
Achten Sie darauf, dass Ihrem Wiz-Dienstkonto die entsprechenden API-Berechtigungsbereiche für die Vorgänge gewährt werden, die Sie in Google SecOps ausführen möchten.
Lese- und Abfragevorgänge
| Vorgang/Zweck | Verwendet von | Erforderliche Berechtigungen/Bereiche |
|---|---|---|
| Konnektivität testen | Ping-Aktion | read:issues |
| Problemdetails abrufen | Aktion zum Abrufen von Problemdetails | read:issuesread:posture_issuesread:threat_issuesread:comments |
| Ergebnisse zu Sicherheitslücken in Ressourcen auflisten | Aktion „Ergebnisse zu Sicherheitslücken in Ressourcen auflisten“ | read:vulnerabilities |
| Analyse des blauen Agenten abrufen | Aktion „Analyse des blauen Agenten abrufen“ | read:threat_issues |
Schreib- und Änderungsvorgänge (Mutationen)
| Vorgang/Zweck | Verwendet von | Erforderliche Berechtigungen/Bereiche |
|---|---|---|
| Problem wieder öffnen | Aktion zum erneuten Öffnen des Problems | write:issue_statusupdate:posture_issue_statuswrite:threat_issue_status |
| Problem beheben | Aktion zur Problembehebung | write:threat_issue_statuswrite:threat_issues |
| Problem ignorieren | Aktion „Problem ignorieren“ | update:posture_issue_ignorewrite:issue_ignore |
| Kommentar zu Problem hinzufügen | Aktion „Kommentar zu Problem hinzufügen“ | write:issue_commentswrite:threat_issue_commentswrite:comments |
Integrationsparameter
Für die Wiz-Integration sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
API Root |
Pflichtangabe. Die GraphQL API-Endpunkt-URL für Ihren Wiz-Mandanten. Der Endpunkt muss das Format Die genaue Endpunkt-URL finden Sie in den Details zu Ihrem Wiz-Mandanten. Verwenden Sie keine generischen, nicht nummerierten regionalen URLs. |
Authentication URL |
Optional. Die Authentifizierungs-URL, die zum Generieren von OAuth-Zugriffstokens verwendet wird. Verwenden Sie für kommerzielle Umgebungen Der Standardwert ist |
Client ID |
Pflichtangabe. Die Client-ID, die mit Ihren Wiz API-Anmeldedaten verknüpft ist. |
Client Secret |
Pflichtangabe. Der Clientschlüssel, der mit Ihren Wiz API-Anmeldedaten verknüpft ist. |
Verify SSL |
Pflichtangabe. Wenn diese Option ausgewählt ist, validiert die Integration das SSL-Zertifikat, wenn eine Verbindung zum Wiz-Server hergestellt wird. Standardmäßig aktiviert. |
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 zu Wiz 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 Wiz 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 |
Problemdetails abrufen
Verwenden Sie die Aktion Get Issue Details, um Informationen zu einem bestimmten Problem in Wiz abzurufen.
Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.
Aktionseingaben
Für die Aktion Get Issue Details sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
Issue ID |
Pflichtangabe. Die eindeutige Kennung des Wiz-Problems, das abgerufen oder bearbeitet werden soll. |
Aktionsausgaben
Die Aktion Get Issue Details 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 | Verfügbar |
| Ausgabenachrichten | Verfügbar |
| Scriptergebnis | Verfügbar |
JSON-Ergebnis
Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Get Issue Details empfangen wird:
{
"id": "f54e3fb9-a520-4e99-aacc-b99f6ae7f28d",
"createdAt": "2025-07-26T11:47:43.94524Z",
"updatedAt": "2025-07-31T07:34:54.445702Z",
"status": "RESOLVED",
"severity": "CRITICAL",
"type": "TOXIC_COMBINATION",
"description": "This container is using an image that contains a file identified as a high/critical severity malware by ReversingLabs.\n\nMalware can imply a malicious actor's presence in your environment. The malware can be used for crypto-mining, data leakage, lateral movement to other resources in your environment, etc.",
"resolvedAt": "2025-07-31T07:34:54.445702Z",
"entitySnapshot": {
"cloudPlatform": "GCP",
"id": "1971f945-3476-5b3d-a5a1-ab166c3e2eca",
"name": "cluster-solr",
"region": "us-central1",
"subscriptionName": "Wiz-Labs",
"type": "KUBERNETES_CLUSTER"
},
"projects": [
{
"id": "904cbc14-1c52-571c-a6b8-46fee263eb0f",
"name": "GCP Lab"
}
],
"sourceRules": [
{
"id": "wc-id-1038",
"name": "Container using an image infected with critical/high severity malware",
"description": "This container is using an image that contains a file identified as a high/critical severity malware by ReversingLabs.\n\nMalware can imply a malicious actor's presence in your environment. The malware can be used for crypto-mining, data leakage, lateral movement to other resources in your environment, etc."
}
]
}
Ausgabenachrichten
Die Aktion Get Issue Details kann die folgenden Ausgabenachrichten zurückgeben:
| Ausgabemeldung | Beschreibung der Nachricht |
|---|---|
|
Die Aktion war erfolgreich. |
Error executing action "Get Issue Details". 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 aufgeführt, wenn die Aktion Get Issue Details verwendet wird:
| Name des Skriptergebnisses | Wert |
|---|---|
is_success |
True oder False |
Problem wieder öffnen
Verwenden Sie die Aktion Problem wieder öffnen, um ein bestimmtes Problem in Wiz wieder zu öffnen.
Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.
Aktionseingaben
Für die Aktion Problem wieder öffnen sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
Issue ID |
Pflichtangabe. Die eindeutige Kennung des Problems in Wiz, das abgerufen oder aktualisiert werden soll. |
Aktionsausgaben
Die Aktion Problem wieder öffnen 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 | Verfügbar |
| Ausgabenachrichten | Verfügbar |
| Scriptergebnis | Verfügbar |
JSON-Ergebnis
Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Problem wieder öffnen empfangen wird:
{
"id": "41facd3f-29b0-4fcf-9a0c-e7fc40416aa0",
"note": "",
"status": "OPEN",
"dueAt": null,
"resolutionReason": null
}
Ausgabenachrichten
Die Aktion Problem wieder öffnen kann die folgenden Ausgabenachrichten zurückgeben:
| Ausgabemeldung | Beschreibung der Nachricht |
|---|---|
|
Die Aktion war erfolgreich. |
Error executing action "Reopen Issue". 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 aufgeführt, wenn die Aktion Problem wieder öffnen verwendet wird:
| Name des Skriptergebnisses | Wert |
|---|---|
is_success |
True oder False |
Problem ignorieren
Verwenden Sie die Aktion Problem ignorieren, um ein bestimmtes Problem in Wiz zu ignorieren.
Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.
Aktionseingaben
Für die Aktion Ignore Issue sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
Issue ID |
Pflichtangabe. Die eindeutige Kennung des Problems in Wiz. |
Resolution Reason |
Pflichtangabe. Der Grund für die Lösung des Problems. Folgende Werte sind möglich:
Der Standardwert ist |
Resolution Note |
Optional. Ein Hinweis, der zusätzlichen Kontext zur Problemlösung bietet. |
Aktionsausgaben
Die Aktion Problem ignorieren 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 | Verfügbar |
| Ausgabenachrichten | Verfügbar |
| Scriptergebnis | Verfügbar |
JSON-Ergebnis
Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Problem ignorieren empfangen wird:
{
"id": "41facd3f-29b0-4fcf-9a0c-e7fc40416aa0",
"note": "",
"status": "REJECTED",
"dueAt": null,
"resolutionReason": "FALSE_POSITIVE"
}
Ausgabenachrichten
Die Aktion Ignore Issue kann die folgenden Ausgabenachrichten zurückgeben:
| Ausgabemeldung | Beschreibung der Nachricht |
|---|---|
|
Die Aktion war erfolgreich. |
Error executing action "Ignore Issue". 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 aufgeführt, wenn die Aktion Problem ignorieren verwendet wird:
| Name des Skriptergebnisses | Wert |
|---|---|
is_success |
True oder False |
Problem beheben
Verwenden Sie die Aktion Problem beheben, um ein bestimmtes Problem in Wiz zu beheben.
Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.
Aktionseingaben
Für die Aktion Problem beheben sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
Issue ID |
Pflichtangabe. Die eindeutige Kennung des Problems in Wiz. |
Resolution Reason |
Pflichtangabe. Der Grund für die Lösung des Problems. Folgende Werte sind möglich:
Der Standardwert ist |
Resolution Note |
Optional. Eine Notiz, die zusätzlichen Kontext zur Lösung enthält. |
Aktionsausgaben
Die Aktion Problem beheben 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 | Verfügbar |
| Ausgabenachrichten | Verfügbar |
| Scriptergebnis | Verfügbar |
JSON-Ergebnis
Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die Sie bei Verwendung der Aktion Problem beheben erhalten:
{
"id": "0db2222f-7d1f-501a-9ad5-fe669c7da036",
"resolutionNote": "",
"status": "RESOLVED",
"dueAt": null,
"resolutionReason": "NOT_MALICIOUS_THREAT"
}
Ausgabenachrichten
Die Aktion Problem beheben kann die folgenden Ausgabenachrichten zurückgeben:
| Ausgabemeldung | Beschreibung der Nachricht |
|---|---|
|
Die Aktion war erfolgreich. |
Error executing action "Resolve Issue". 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 aufgeführt, wenn die Aktion Problem beheben verwendet wird:
| Name des Skriptergebnisses | Wert |
|---|---|
is_success |
True oder False |
Kommentar zu Problem hinzufügen
Verwenden Sie die Aktion Kommentar zu Problem hinzufügen, um einem bestimmten Problem in Wiz einen Kommentar hinzuzufügen.
Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.
Aktionseingaben
Für die Aktion Kommentar zu Problem hinzufügen sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
Issue ID |
Pflichtangabe. Die eindeutige Kennung des Problems in Wiz. |
Comment |
Pflichtangabe. Der Text des Kommentars, der dem Problem hinzugefügt werden soll. |
Aktionsausgaben
Die Aktion Kommentar zu Problem hinzufügen 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 | Verfügbar |
| Ausgabenachrichten | Verfügbar |
| Scriptergebnis | Verfügbar |
JSON-Ergebnis
Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Kommentar zu Problem hinzufügen empfangen wird:
{
"createdAt": "2025-08-01T11:59:00.843434941Z", "id":
"6f997da2-85a0-4be2-b205-83ea19e9b17a", "text": "testing"
}
Ausgabenachrichten
Die Aktion Kommentar zu Problem hinzufügen kann die folgenden Ausgabenachrichten zurückgeben:
| Ausgabemeldung | Beschreibung der Nachricht |
|---|---|
|
Die Aktion war erfolgreich. |
Error executing action "Add Comment To Issue". 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 aufgeführt, wenn die Aktion Kommentar zu Problem hinzufügen verwendet wird:
| Name des Skriptergebnisses | Wert |
|---|---|
is_success |
True oder False |
Analyse des blauen Agenten abrufen
Verwenden Sie die Aktion Get Blue Agent Analysis, um Analysedetails vom Wiz Blue Agent für eine bestimmte Bedrohung abzurufen.
Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.
Aktionseingaben
Für die Aktion Get Blue Agent Analysis sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
Threat ID |
Pflichtangabe. Die eindeutige Kennung der Wiz-Bedrohungs-ID. |
Aktionsausgaben
Die Aktion Get Blue Agent Analysis 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 | Verfügbar |
| Ausgabenachrichten | Verfügbar |
| Scriptergebnis | Verfügbar |
JSON-Ergebnis
Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die Sie bei Verwendung der Aktion Get Blue Agent Analysis erhalten:
{
"id": "threat-12345",
"threatType": "MALWARE_DETECTION",
"status": "COMPLETED",
"analysis": {
"summary": "Blue Agent analysis details",
"riskScore": "HIGH"
}
}
Ausgabenachrichten
Die Aktion Get Blue Agent Analysis kann die folgenden Ausgabemeldungen zurückgeben:
| Ausgabemeldung | Beschreibung der Nachricht |
|---|---|
|
Die Aktion war erfolgreich. |
Error executing action "Get Blue Agent Analysis". 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 aufgeführt, wenn die Aktion Get Blue Agent Analysis verwendet wird:
| Name des Skriptergebnisses | Wert |
|---|---|
is_success |
True oder False |
Jobs
Weitere Informationen zu Jobs finden Sie unter Neuen Job konfigurieren und Erweiterte Planung.
Bidirektionaler Synchronisierungsjob für Wiz und Google SecOps
Verwenden Sie den bidirektionalen Synchronisierungsjob für Wiz und Google SecOps, um eine kontinuierliche Synchronisierung zwischen Wiz-Bedrohungen und Google SecOps-Fällen aufrechtzuerhalten.
Jobparameter
Für den bidirektionalen Synchronisierungsjob von Wiz und Google SecOps sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
Environment Name |
Pflichtangabe. Name der Umgebung, in der Fälle synchronisiert werden sollen. Der Standardwert ist |
Wiz API Root |
Pflichtangabe. Der Wiz GraphQL API-Endpunkt für Ihren Mandanten. Der Endpunkt muss das Format Die genaue Endpunkt-URL finden Sie in den Details zu Ihrem Wiz-Mandanten. Verwenden Sie keine generischen, nicht nummerierten regionalen URLs. Der Standardplatzhalterwert ist |
Wiz Authentication URL |
Optional. Die Authentifizierungs-URL, die zum Generieren von OAuth-Zugriffstokens verwendet wird. Verwenden Sie für kommerzielle Umgebungen Der Standardwert ist |
Wiz Client ID |
Pflichtangabe. Client-ID für das Wiz API-Dienstkonto. |
Wiz Client Secret |
Pflichtangabe. Clientschlüssel für das Wiz API-Dienstkonto. |
Max Hours Backwards |
Optional. Anzahl der Stunden vor der ersten Jobiteration, ab der aktualisierte Fälle abgerufen werden sollen (Bereich: 1 bis 720, Standard: 24). Dieser Parameter gilt für die erste Jobausführung oder als Fallback, wenn der Zeitstempel der letzten Ausführung zurückgesetzt wird. |
Verify SSL |
Pflichtangabe. Wenn diese Option ausgewählt ist, validiert die Integration das SSL-Zertifikat, wenn eine Verbindung zum Wiz-Server hergestellt wird. Standardmäßig ausgewählt. |
Fields to sync |
Pflichtangabe. Eine durch Kommas getrennte Liste von Elementen, die festlegen, welche Felder synchronisiert werden sollen. Nur die hier explizit aufgeführten Felder werden synchronisiert. Mögliche Werte sind: Der Standardwert ist |
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten