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:

  1. Dienstkonto: Fungiert als Brücke zwischen Systemen.

  2. Delegierter Nutzer: Die Identität, die das Dienstkonto übernimmt, um auf Formulardaten zuzugreifen.

  3. 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:

  1. Erstellen Sie ein Dienstkonto.
  2. JSON-Schlüssel erstellen
  3. Aktivieren Sie die erforderlichen APIs für Ihr Projekt.
  4. Optional: Erstellen Sie eine benutzerdefinierte Rolle für die Integration.
  5. Optional: Weisen Sie die benutzerdefinierte Rolle einem Nutzer zu.
  6. 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.

  1. Rufen Sie in der Google Cloud Console die Seite Anmeldedaten auf.

    Zu den Anmeldedaten

  2. Wählen Sie add_2Anmeldedaten erstellen > Dienstkonto aus.

  3. Geben Sie unter Dienstkontodetails im Feld Dienstkontoname einen Namen ein.

  4. Optional: Bearbeiten Sie die Dienstkonto-ID.

  5. 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.

  1. Wählen Sie Ihr Dienstkonto aus und rufen Sie Schlüssel auf.

  2. Klicken Sie auf Schlüssel hinzufügen > Neuen Schlüssel erstellen.

  3. 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.

  1. Rufen Sie in der Google Cloud Console APIs und Dienste auf.

    Rufen Sie "APIs & Dienste" auf.

  2. Klicken Sie auf addAPIs und Dienste aktivieren.

  3. 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

  1. Gehen Sie in der Admin-Konsole zu Konto > Administratorrollen.

  2. Wählen Sie Neue Rolle erstellen aus.

  3. Geben Sie einen Namen für die neue benutzerdefinierte Rolle ein und klicken Sie auf Weiter.

  4. Suchen Sie unter Berechtigungen auswählen den Abschnitt Admin API-Berechtigungen.

  5. Klicken Sie die Kästchen für Organisationseinheiten, Nutzer und Gruppen an.

  6. 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.

  1. Öffnen Sie in der Admin-Konsole Verzeichnis > Nutzer.

  2. Wählen Sie den Nutzer aus, den Sie für die Integration verwenden möchten (einen vorhandenen Administrator oder einen neuen dedizierten Nutzer).

  3. Öffnen Sie die Einstellungen für den Nutzer und klicken Sie auf Administratorrollen und ‑berechtigungen > Bearbeiten.

  4. Wählen Sie die von Ihnen erstellte benutzerdefinierte Rolle aus und stellen Sie den Schalter auf Zugewiesen.

  5. 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.

  1. Öffnen Sie in der Admin-Konsole Ihrer Domain Sicherheit > Zugriffs- und Datenkontrolle > API-Steuerung.

  2. Wählen Sie im Bereich Domainweite Delegation die Option Domainweite Delegation verwalten aus.

  3. Klicken Sie auf Neu hinzufügen.

  4. Geben Sie im Feld Client-ID die Client-ID des Dienstkontos ein, das Sie im ersten Schritt erstellt haben.

  5. 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.readonly
    
  6. Klicken 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 Product Name.

Event Field Name Erforderlich

Der Feldname, der zur Bestimmung des Ereignisnamens (Untertyp) verwendet wird.

Der Standardwert ist event_type.

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 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) 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 /d/ und /edit in der vollständigen Adresse, die in der Adressleiste Ihres Browsers angezeigt wird.

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:

  • Informational
  • Low
  • Medium
  • High
  • Critical

Der Standardwert ist Low.

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