Google Formulare in Google SecOps einbinden
In diesem Dokument wird beschrieben, wie Sie Google Formulare in Google Security Operations (Google SecOps) einbinden.
Hinweis
Bevor Sie die Google Formulare-Integration in Google SecOps konfigurieren, müssen Sie Ihre Google Cloud - und Google Workspace-Umgebungen für den API-Zugriff und die Identitätsübernahme vorbereiten.
Damit die Integration ordnungsgemäß funktioniert, müssen drei Elemente zur Verwaltung von Berechtigungen aufeinander abgestimmt sein:
Dienstkonto: Fungiert als Brücke zwischen Systemen.
Delegierter Nutzer: Die Identität, die das Dienstkonto übernimmt, um auf Formulardaten zuzugreifen.
Berechtigungen: Die Bereiche und Rollen, die definieren, was die Identität tun darf.
Wenn der Nutzer, dessen Identität Sie übernehmen, bereits die erforderlichen Administratorberechtigungen hat, ist das Erstellen einer benutzerdefinierten Rolle nicht erforderlich. Viele Organisationen ziehen es jedoch vor, einen dedizierten Dienstnutzer mit einer benutzerdefinierten Rolle zu erstellen, um das Prinzip der geringsten Berechtigung einzuhalten.
Führen Sie die folgenden erforderlichen Schritte aus:
- Erstellen Sie ein Dienstkonto.
- JSON-Schlüssel erstellen
- Aktivieren Sie die erforderlichen APIs für Ihr Projekt.
- Optional: Erstellen Sie eine benutzerdefinierte Rolle für die Integration.
- Optional: Weisen Sie die benutzerdefinierte Rolle einem Nutzer zu.
- Domainweite Autorität an Ihr Dienstkonto delegieren
Dienstkonto erstellen
Das Dienstkonto repräsentiert einen nicht menschlichen Nutzer und bietet eine sichere Möglichkeit, die Integration zu authentifizieren und zu autorisieren, damit sie auf Ihre Daten zugreifen kann.
Rufen Sie in der Google Cloud Console die Seite Anmeldedaten auf.
Wählen Sie add_2Anmeldedaten erstellen > Dienstkonto aus.
Geben Sie unter Dienstkontodetails im Feld Dienstkontoname einen Namen ein.
Optional: Bearbeiten Sie die Dienstkonto-ID.
Klicken Sie auf Fertig.
JSON-Schlüssel erstellen
Google SecOps benötigt eine JSON-Schlüsseldatei, um die Identität des Dienstkontos nachzuweisen und eine sichere Verbindung herzustellen.
Wählen Sie Ihr Dienstkonto aus und rufen Sie Schlüssel auf.
Klicken Sie auf Schlüssel hinzufügen > Neuen Schlüssel erstellen.
Wählen Sie als Schlüsseltyp JSON aus und klicken Sie auf Erstellen. Das Dialogfeld Privater Schlüssel auf Ihrem Computer gespeichert wird angezeigt und eine Kopie des privaten Schlüssels wird auf Ihren Computer heruntergeladen.
Erforderliche APIs für Ihr Projekt aktivieren
Sie müssen die spezifischen Google Cloud APIs aktivieren, die es der Integration ermöglichen, mit Google Formulare und dem Google Workspace-Verzeichnis zu interagieren.
Rufen Sie in der Google Cloud Console APIs und Dienste auf.
Klicken Sie auf addAPIs und Dienste aktivieren.
Aktivieren Sie die folgenden APIs für Ihr Projekt:
Admin SDK API
Google Forms API
Optional: Benutzerdefinierte Rolle für die Integration erstellen
Wenn das Nutzerkonto, das Sie für die Identitätsübernahme verwenden, noch nicht die erforderlichen Administratorberechtigungen hat, können Sie eine benutzerdefinierte Rolle mit eingeschränkten Berechtigungen erstellen. Zur Unterstützung der Integration benötigt der Nutzer Admin API-Berechtigungen für Folgendes:
Organisationseinheiten
Nutzer
Gruppen
Gehen Sie in der Admin-Konsole zu Konto > Administratorrollen.
Wählen Sie Neue Rolle erstellen aus.
Geben Sie einen Namen für die neue benutzerdefinierte Rolle ein und klicken Sie auf Weiter.
Suchen Sie unter Berechtigungen auswählen den Abschnitt Admin API-Berechtigungen.
Klicken Sie die Kästchen für Organisationseinheiten, Nutzer und Gruppen an.
Klicken Sie auf Weiter > Rolle erstellen.
Optional: Benutzerdefinierte Rolle einem Nutzer zuweisen
Wenn Sie im vorherigen Schritt eine benutzerdefinierte Rolle erstellt haben, müssen Sie sie jetzt der spezifischen E-Mail-Adresse zuweisen, die für die Identitätsübernahme verwendet wird.
Öffnen Sie in der Admin-Konsole Verzeichnis > Nutzer.
Wählen Sie den Nutzer aus, den Sie für die Integration verwenden möchten (einen vorhandenen Administrator oder einen neuen dedizierten Nutzer).
Öffnen Sie die Einstellungen für den Nutzer und klicken Sie auf Administratorrollen und ‑berechtigungen > Bearbeiten.
Wählen Sie die von Ihnen erstellte benutzerdefinierte Rolle aus und stellen Sie den Schalter auf Zugewiesen.
Klicken Sie auf Speichern.
Domainweite Berechtigungen an Ihr Dienstkonto delegieren
Mit der domainweiten Delegierung kann Ihr Dienstkonto auf Daten in Ihrer gesamten Google Workspace-Domain zugreifen, indem es die Identität des autorisierten Nutzers annimmt.
Öffnen Sie in der Admin-Konsole Ihrer Domain Sicherheit > Zugriffs- und Datenkontrolle > API-Steuerung.
Wählen Sie im Bereich Domainweite Delegation die Option Domainweite Delegation verwalten aus.
Klicken Sie auf Neu hinzufügen.
Geben Sie im Feld Client-ID die Client-ID des Dienstkontos ein, das Sie im ersten Schritt erstellt haben.
Geben Sie im Feld OAuth-Bereiche die folgende durch Kommas getrennte Liste der erforderlichen Bereiche ein:
https://mail.google.com/, https://www.googleapis.com/auth/admin.directory.customer.readonly, https://www.googleapis.com/auth/admin.directory.domain.readonly, https://www.googleapis.com/auth/admin.directory.group, https://www.googleapis.com/auth/admin.directory.group.member, https://www.googleapis.com/auth/admin.directory.orgunit, https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly, https://www.googleapis.com/auth/admin.directory.user, https://www.googleapis.com/auth/admin.directory.user.alias, https://www.googleapis.com/auth/apps.groups.settings, https://www.googleapis.com/auth/cloud-platform, https://www.googleapis.com/auth/forms.body.readonly, https://www.googleapis.com/auth/forms.responses.readonlyKlicken Sie auf Autorisieren.
Integrationsparameter
Für die Google Formulare-Integration sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
Delegated Email |
Erforderlich Eine E-Mail-Adresse, die für die Identitätsübernahme und die Zugriffssteuerung verwendet werden soll. |
Service Account JSON |
Erforderlich Der Inhalt der JSON-Datei des Dienstkontoschlüssels. |
Verify SSL |
Erforderlich Wenn diese Option ausgewählt ist, wird bei der Integration geprüft, ob das SSL-Zertifikat für die Verbindung mit Google Formulare gültig ist. 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 zu Google Formulare 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 Google Forms server with the
provided connection parameters! |
Die Aktion war erfolgreich. |
Failed to connect to the Google Forms 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 |
Connectors
Eine detaillierte Anleitung zum Konfigurieren eines Connectors in Google SecOps finden Sie unter Daten aufnehmen (Connectors).
Google Formulare – Antworten-Connector
Verwenden Sie den Google Formulare – Antworten-Connector, um Antworten aus Google Formulare abzurufen.
Für den Google Formulare – Responses Connector sind die folgenden Parameter erforderlich:
| Parameter | Beschreibung |
|---|---|
Product Field Name |
Erforderlich Der Name des Felds, in dem der Produktname gespeichert ist. Der Standardwert ist |
Event Field Name |
Erforderlich Der Feldname, der zur Bestimmung des Ereignisnamens (Untertyp) verwendet wird. Der Standardwert ist |
Environment Field Name |
Optional
Der Name des Felds, in dem der Umgebungsname gespeichert ist. Wenn das Feld „environment“ nicht gefunden wird, wird die Umgebung auf die Standardumgebung gesetzt. 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) |
Erforderlich Das Zeitlimit in Sekunden für den Python-Prozess, der das aktuelle Script ausführt. Der Standardwert beträgt 300 Sekunden. |
Delegated Email |
Erforderlich Eine E-Mail-Adresse, die für die Identitätsübernahme und die Zugriffssteuerung verwendet werden soll. |
Service Account JSON |
Erforderlich Der Inhalt der JSON-Datei des Dienstkontoschlüssels. |
Form IDs To Track |
Erforderlich Eine durch Kommas getrennte Liste von Google Formulare-IDs, für die Antworten erfasst werden sollen. Wenn Sie die eindeutige ID eines Formulars abrufen möchten, öffnen Sie das Formular im Formular-Editor (nicht über den öffentlichen Antwortlink) und kopieren Sie den String zwischen |
Alert Severity |
Optional Ein Schweregrad, der allen Benachrichtigungen zugewiesen wird, die der Connector basierend auf der aufgenommenen Google Formulare-Antwort erstellt. Folgende Werte sind möglich:
Der Standardwert ist |
Max Hours Backwards |
Erforderlich Eine Anzahl von Stunden vor der ersten Connector-Iteration, aus der Antworten abgerufen werden sollen. Dieser Parameter gilt entweder für die erste Connector-Iteration, nachdem Sie den Connector zum ersten Mal aktiviert haben, oder für den Fallback-Wert für einen abgelaufenen Connector-Zeitstempel. Der Standardwert ist 1 Stunde. |
Max Responses To Fetch |
Erforderlich Die maximale Anzahl von Antworten, die pro Connector-Iteration verarbeitet werden sollen. Die maximale Anzahl beträgt 100. |
Disable Overflow |
Optional Wenn diese Option ausgewählt ist, ignoriert der Connector beim Erstellen von Benachrichtigungen den Überlaufmechanismus von Google SecOps. Standardmäßig nicht ausgewählt. |
Verify SSL |
Erforderlich Wenn diese Option ausgewählt ist, wird bei der Integration geprüft, ob das SSL-Zertifikat für die Verbindung mit Google Formulare gültig ist. Nicht 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. |
Connector-Regeln
Der Google Formulare – Antworten-Connector unterstützt Proxys.
Connector-Ereignisse
Das folgende Beispiel zeigt die JSON-Ausgabe eines Google SecOps-Ereignisses, das vom Google Formulare – Responses Connector generiert wurde:
{
"responseId": "RESPONSE_ID",
"createTime": "2024-09-05T11:43:13.892Z",
"lastSubmittedTime": "2024-09-05T11:43:13.892123Z",
"event_type": "Question",
"questionId": "78099fe3",
"textAnswers": {
"answers": [
{
"value": "Option 1"
}
]
}
}
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten