Datenaufnahmescripts verwenden, die als Cloud Run-Funktionen bereitgestellt werden

Unterstützt in:

Google Security Operations hat eine Reihe von Python-Aufnahmescripts bereitgestellt, die als Cloud Run-Funktionen bereitgestellt werden sollen. Mit diesen Scripts können Sie Daten aus den folgenden Protokollquellen aufnehmen, die nach Name und Protokolltyp aufgelistet sind.

  • Armis Google Security Operations Integration
  • Aruba Central (ARUBA_CENTRAL)
  • Azure Event Hub (configurable log type)
  • Box (BOX)
  • Citrix Cloud audit logs (CITRIX_MONITOR)
  • Citrix session metadata (CITRIX_SESSION_METADATA)
  • Cloud Storage (configurable log type)
  • Duo Activity (DUO_ACTIVITY)
  • Duo Admin (DUO_ADMIN)
  • MISP (MISP_IOC)
  • OneLogin (ONELOGIN_SSO)
  • OneLogin user context (ONELOGIN_USER_CONTEXT)
  • Proofpoint (configurable log type)
  • Pub/Sub (configurable log type)
  • Slack audit logs (SLACK_AUDIT)
  • STIX/TAXII threat intelligence (STIX)
  • Tenable.io (TENABLE_IO)
  • Trend Micro Cloud App Security (configurable log type)
  • Trend Micro Vision One audit logs (TREND_MICRO_VISION_AUDIT)

Diese Skripts befinden sich im GitHub-Repository von Google Security Operations.

Bekannte Einschränkung:Wenn diese Scripts in einer zustandslosen Umgebung wie Cloud Run-Funktionen verwendet werden, werden möglicherweise nicht alle Protokolle an Google Security Operations gesendet, da keine Checkpoint-Funktion vorhanden ist. Google Security Operations hat die Scripts mit der Python 3.9-Laufzeit getestet.

Hinweise

In den folgenden Ressourcen finden Sie Kontext und Hintergrundinformationen, mit denen Sie die Google Security Operations-Aufnahmescripts effektiv nutzen können.

Dateien für einen einzelnen Protokolltyp zusammenstellen

Jedes Unterverzeichnis im GitHub-Repository von Google Security Operations enthält Dateien, in die Daten für einen einzelnen Google Security Operations-Logtyp aufgenommen werden. Das Script stellt eine Verbindung zu einem einzelnen Quellgerät her und sendet dann Rohprotokolle über die Ingestion API an Google Security Operations. Wir empfehlen, jeden Logtyp als separate Cloud Run-Funktion bereitzustellen. Rufen Sie die Scripts im GitHub-Repository von Google Security Operations auf. Jedes Unterverzeichnis in GitHub enthält die folgenden Dateien, die dem aufgenommenen Protokolltyp entsprechen.

  • main.py ist das für den Protokolltyp spezifische Aufnahmeskript. Es stellt eine Verbindung zum Quellgerät her und nimmt Daten in Google Security Operations auf.
  • .env.yml speichert die vom Python-Script benötigte Konfiguration und ist spezifisch für die Bereitstellung. In dieser Datei legen Sie die Konfigurationsparameter fest, die vom Datenaufnahme-Script benötigt werden.
  • README.md enthält Informationen zu Konfigurationsparametern.
  • Requirements.txt definiert die Abhängigkeiten, die für das Datenaufnahme-Script erforderlich sind. Außerdem enthält der Ordner common Dienstprogrammfunktionen, von denen alle Datenaufnahmescripts abhängen.

Führen Sie die folgenden Schritte aus, um die Dateien zusammenzustellen, in die Daten für einen einzelnen Protokolltyp aufgenommen werden:

  1. Erstellen Sie ein Bereitstellungsverzeichnis, um die Dateien für die Cloud Run-Funktion zu speichern. Diese enthält alle für die Bereitstellung erforderlichen Dateien.
  2. Kopieren Sie alle Dateien aus dem GitHub-Unterverzeichnis des ausgewählten Protokolltyps, z. B. „OneLogin User Context“, in dieses Bereitstellungsverzeichnis.
  3. Kopieren Sie den Ordner common und den gesamten Inhalt in das Bereitstellungsverzeichnis.
  4. Der Inhalt des Verzeichnisses sieht in etwa so aus:

    one_login_user
    ├─common
    │  ├─__init__.py
    │  ├─auth.py
    │  ├─env_constants.py
    │  ├─ingest.py
    │  ├─status.py
    │  └─utils.py
    ├─env.yml
    ├─main.py
    └─requirements.txt
    

Scripts konfigurieren

  1. Starten Sie eine Cloud Shell-Sitzung.
  2. Stellen Sie eine SSH-Verbindung zu einer Google Cloud Linux-VM her. Weitere Informationen finden Sie unter Mit Google-Tools eine Verbindung zu Linux-VMs herstellen.
  3. Laden Sie die Datenaufnahmescripts hoch, indem Sie auf Mehr > Hochladen oder Herunterladen klicken, um Dateien oder Ordner in Cloud Shell oder von dort aus zu verschieben.

    Dateien und Ordner können nur in Ihr Basisverzeichnis hoch- und heruntergeladen werden. Weitere Optionen zum Übertragen von Dateien zwischen Cloud Shell und Ihrer lokalen Workstation finden Sie unter [Dateien und Ordner von Cloud Shell hoch- und herunterladen](/shell/docs/uploading-and-downloading-files#upload_and_download_files_and_folders.

  4. Bearbeiten Sie die Datei .env.yml für die Funktion und füllen Sie die erforderlichen Umgebungsvariablen aus. In der folgenden Tabelle sind Laufzeitumgebungsvariablen aufgeführt, die für alle Datenaufnahmescripts gemeinsam sind.

    Variablenname Beschreibung Erforderlich Standard Secret
    CHRONICLE_CUSTOMER_ID Google Security Operations-Kundennummer Ja Keine Nein
    CHRONICLE_REGION Google Security Operations-Region. Ja us
    Weitere zulässige Werte: asia-northeast1, asia-south1, asia-southeast1, australia-southeast1, europe, europe-west2, europe-west3, europe-west6, europe-west9, europe-west12, me-central1, me-central2, me-west1, northamerica-northeast2 und southamerica-east1.
    Nein
    CHRONICLE_SERVICE_ACCOUNT Inhalt der JSON-Datei des Dienstkontos für Google Security Operations. Ja Keine Ja
    CHRONICLE_NAMESPACE Der Namespace, mit dem die Google Security Operations-Protokolle gekennzeichnet sind. Informationen zu Namespaces für Google Security Operations finden Sie unter Asset-Namespaces verwenden. Nein Keine Nein

  5. Für jedes Script sind spezifische Umgebungsvariablen erforderlich. Unter Konfigurationsparameter nach Protokolltyp finden Sie Details zu den für jeden Protokolltyp erforderlichen Umgebungsvariablen.

Umgebungsvariablen, die als Secret = Yes gekennzeichnet sind, müssen im Secret Manager als Secrets konfiguriert werden. Informationen zu den Kosten der Nutzung von Secret Manager finden Sie unter Secret Manager-Preise.

Eine detaillierte Anleitung finden Sie unter Secrets erstellen und darauf zugreifen.

Verwenden Sie nach dem Erstellen der Secrets in Secret Manager den Namen der Secret-Ressource als Wert für Umgebungsvariablen. Beispiel: projects/{project_id}/secrets/{secret_id}/versions/{version_id}, wobei {project_id}, {secret_id} und {version_id} für Ihre Umgebung spezifisch sind.

Planer oder Trigger einrichten

Alle Scripts mit Ausnahme von Pub/Sub werden so implementiert, dass die Daten in regelmäßigen Abständen von einem Quellgerät erfasst werden. Sie müssen einen Trigger mit Cloud Scheduler einrichten, um Daten im Zeitverlauf abzurufen. Das Datenaufnahme-Script für Pub/Sub überwacht das Pub/Sub-Abo kontinuierlich. Weitere Informationen finden Sie unter Dienste nach Zeitplan ausführen und Cloud Run-Funktionen mit Pub/Sub auslösen.

Cloud Run-Funktion bereitstellen

  1. Starten Sie eine Cloud Shell-Sitzung.
  2. Stellen Sie eine SSH-Verbindung zu einer Google Cloud Linux-VM her. Weitere Informationen finden Sie unter Mit Google-Tools eine Verbindung zu Linux-VMs herstellen.
  3. Wechseln Sie zu dem Verzeichnis, in das Sie die Datenaufnahmescripts kopiert haben.
  4. Führen Sie den folgenden Befehl aus, um die Cloud Run-Funktion bereitzustellen.

    gcloud functions deploy <FUNCTION NAME> --service-account <SERVICE_ACCOUNT_EMAIL> --entry-point main --trigger-http --runtime python39 --env-vars-file .env.yml

    Ersetzen Sie <FUNCTION_NAME> durch den Namen, den Sie für die Cloud Run-Funktion definieren.

    Ersetzen Sie <SERVICE_ACCOUNT_EMAIL> durch die E-Mail-Adresse des Dienstkontos, das Ihre Cloud Run-Funktion verwenden soll.

    Wenn Sie nicht zum Verzeichnis mit den Dateien wechseln, müssen Sie den Speicherort der Bereitstellungsscripts mit der Option --source angeben.

    Das Dienstkonto, in dem Ihre Cloud Run-Funktion ausgeführt wird, muss die Rollen Cloud Functions-Aufrufer (roles/cloudfunctions.invoker) und Secret Manager Secret Accessor (roles/secretmanager.secretAccessor) haben.

Laufzeitprotokolle ansehen

Die Aufnahmescripts geben Laufzeitmeldungen in stdout aus. Cloud Run-Funktionen bieten einen Mechanismus zum Ansehen von Protokollmeldungen. Weitere Informationen finden Sie in der Cloud Functions-Anleitung zum Ansehen von Laufzeitprotokollen.

Konfigurationsparameter nach Protokolltyp

Armis-Integration in Google Security Operations

Dieses Script erfasst die Daten mithilfe von API-Aufrufen von der Armis-Plattform für verschiedene Arten von Ereignissen wie Benachrichtigungen, Aktivitäten, Geräte und Sicherheitslücken. Die erfassten Daten werden in Google Security Operations aufgenommen und von den entsprechenden Parsern analysiert.

Scriptablauf

So sieht der Ablauf des Scripts aus:

  1. Prüfen Sie die Umgebungsvariablen.

  2. Stellen Sie das Script in Cloud Run-Funktionen bereit.

  3. Daten mit dem Datenaufnahme-Script erfassen

  4. Die erfassten Daten in Google Security Operations aufnehmen.

  5. Die erfassten Daten werden mithilfe der entsprechenden Parser in Google Security Operations analysiert.

Mit einem Script Daten in Google Security Operations erfassen und aufnehmen

  1. Prüfen Sie die Umgebungsvariablen.

    Variable Beschreibung Erforderlich Default Secret
    CHRONICLE_CUSTOMER_ID Google Security Operations-Kundennummer Ja - Nein
    CHRONICLE_REGION Google Security Operations-Region. Ja USA Ja
    CHRONICLE_SERVICE_ACCOUNT Inhalt der JSON-Datei des Dienstkontos für Google Security Operations. Ja - Ja
    CHRONICLE_NAMESPACE Der Namespace, mit dem die Google Security Operations-Protokolle gekennzeichnet sind. Nein - Nein
    POLL_INTERVAL Intervall, in dem die Funktion ausgeführt wird, um zusätzliche Häufigkeitsintervall, in dem die Funktion ausgeführt wird, um zusätzliche Protokolldaten abzurufen (in Minuten). Diese Dauer muss mit dem Cloud Scheduler-Jobintervall übereinstimmen. Ja 10 Nein
    ARMIS_SERVER_URL Server-URL der Armis-Plattform. Ja - Nein
    ARMIS_API_SECRET_KEY Für die Authentifizierung ist ein Secret-Schlüssel erforderlich. Ja - Ja
    HTTPS_PROXY Proxyserver-URL. Nein - Nein
    CHRONICLE_DATA_TYPE Google Security Operations-Datentyp zum Pushen von Daten in Google Security Operations. Ja - Nein
  2. Richten Sie das Verzeichnis ein.

    Erstellen Sie ein neues Verzeichnis für die Bereitstellung der Cloud Run-Funktionen und fügen Sie ihm das Verzeichnis common und den Inhalt des Datenaufnahmescripts (armis) hinzu.

  3. Legen Sie die erforderlichen Laufzeit-Umgebungsvariablen fest.

    Definieren Sie die erforderlichen Umgebungsvariablen in der Datei .env.yml.

  4. Verwenden Sie Secrets.

    Als geheim gekennzeichnete Umgebungsvariablen müssen im Secret Manager als Secrets konfiguriert werden. Weitere Informationen zum Erstellen von Secrets finden Sie unter Secret erstellen.

    Verwenden Sie nach dem Erstellen der Secrets in Secret Manager den Ressourcennamen des Secrets als Wert für Umgebungsvariablen. Beispiel:

    CHRONICLE_SERVICE_ACCOUNT: projects/{project_id}/secrets/{secret_id}/versions/{version_id}

  5. Konfigurieren Sie den Namespace.

    Legen Sie die Umgebungsvariable CHRONICLE_NAMESPACE fest, um den Namensraum zu konfigurieren. Die Google Security Operations-Protokolle werden in den Namespace aufgenommen.

  6. Cloud Run-Funktionen bereitstellen

    Führen Sie den folgenden Befehl im zuvor erstellten Verzeichnis aus, um die Cloud-Funktion bereitzustellen. gcloud functions deploy <FUNCTION NAME> --gen2 --entry-point main --trigger-http --runtime python39 --env-vars-file .env.yml

  7. Standardspezifikationen für Cloud Run-Funktionen

    Variable Default Beschreibung
    Speicher 256 MB Keine Keine
    Zeitüberschreitung 60 Sekunden Keine Keine
    Region us-central1 Keine Keine
    Mindestanzahl von Instanzen 0 Keine Keine
    Maximale Anzahl von Instanzen 100 Keine Keine

    Weitere Informationen zum Konfigurieren dieser Variablen finden Sie unter Cloud Run-Funktionen konfigurieren.

  8. Rufen Sie Verlaufsdaten ab.

    So rufen Sie Verlaufsdaten ab und erfassen weiterhin Echtzeitdaten:

    1. Konfigurieren Sie die Umgebungsvariable POLL_INTERVAL in Minuten, für die die Verlaufsdaten abgerufen werden müssen.
    2. Sie können die Funktion mit einem Scheduler oder manuell auslösen, indem Sie den Befehl in der Google Cloud CLI ausführen, nachdem Sie die Cloud Run-Funktionen konfiguriert haben.

Aruba Central

Dieses Script ruft Audit-Logs von der Aruba Central-Plattform ab und nimmt sie mit dem ARUBA_CENTRAL-Logtyp in Google Security Operations auf. Informationen zur Verwendung der Bibliothek finden Sie im pycentral Python SDK.

Definieren Sie in der Datei .env.yml die folgenden Umgebungsvariablen.

Variable Beschreibung Default Secret
CHRONICLE_CUSTOMER_ID Kundennummer der Google Security Operations-Instanz. Keine Nein
CHRONICLE_REGION Region der Google Security Operations-Instanz. us
Weitere gültige Werte: asia-northeast1, asia-south1, asia-southeast1, australia-southeast1, europe, europe-west2, europe-west3, europe-west6, europe-west9, europe-west12, me-central1, me-central2, me-west1, northamerica-northeast2 und southamerica-east1.
Nein
CHRONICLE_SERVICE_ACCOUNT Pfad zum Secret in Secret Manager, in dem die JSON-Datei des Google Security Operations-Dienstkontos gespeichert ist. Keine Ja
CHRONICLE_NAMESPACE Der Namespace, mit dem die Google Security Operations-Protokolle gekennzeichnet sind. Informationen zu Namespaces für Google Security Operations finden Sie unter Asset-Namespaces verwenden. Keine Nein
POLL_INTERVAL Häufigkeitsintervall, in dem die Funktion ausgeführt wird, um zusätzliche Protokolldaten abzurufen (in Minuten). Diese Dauer muss mit dem Cloud Scheduler-Job-Intervall übereinstimmen. 10 Nein
ARUBA_CLIENT_ID Client-ID des Aruba Central API-Gateways. Keine Nein
ARUBA_CLIENT_SECRET_SECRET_PATH Client-Secret des Aruba Central API-Gateways. Keine Ja
ARUBA_USERNAME Nutzername der Aruba Central-Plattform. Keine Nein
ARUBA_PASSWORD_SECRET_PATH Passwort für die Aruba Central-Plattform. Keine Ja
ARUBA_BASE_URL Basis-URL des Aruba Central API-Gateways. Keine Nein
ARUBA_CUSTOMER_ID Kundennummer der Aruba Central-Plattform. Keine Nein

Azure Event Hub

Im Gegensatz zu anderen Datenaufnahmescripts werden in diesem Script Azure-Funktionen verwendet, um Ereignisse aus Azure Event Hub abzurufen. Eine Azure-Funktion wird jedes Mal ausgelöst, wenn ein neues Ereignis in einen Bucket aufgenommen wird. Jedes Ereignis wird nach und nach in Google Security Operations aufgenommen.

Schritte zum Bereitstellen von Azure-Funktionen:

  1. Laden Sie die Datei „Azure_eventhub_API_function_app.json“ aus dem Repository herunter.
  2. Melden Sie sich im Microsoft Azure-Portal an.
  3. Rufen Sie Microsoft Sentinel > Ihren Arbeitsbereich in der Liste aus > Daten-Connector auswählen im Konfigurationsabschnitt auf und führen Sie die folgenden Schritte aus:
  4. Klicken Sie auf die Schaltfläche In Azure bereitstellen, um Ihre Funktion bereitzustellen, und folgen Sie der Anleitung auf derselben Seite.
  5. Wählen Sie das gewünschte Abo, die Ressourcengruppe und den Speicherort aus und geben Sie die erforderlichen Werte an.
  6. Klicken Sie auf Überprüfen + Erstellen.
  7. Klicken Sie auf Erstellen, um die Bereitstellung vorzunehmen.

Box

Dieses Script ruft Details zu Ereignissen in Box ab und nimmt sie mit dem Protokolltyp BOX in Google Security Operations auf. Die Daten liefern Einblicke in CRUD-Vorgänge für Objekte in der Box-Umgebung. Informationen zu Box-Ereignissen finden Sie in der Box Events API.

Definieren Sie in der Datei .env.yml die folgenden Umgebungsvariablen. Weitere Informationen zur Box-Client-ID, zum Client-Secret und zur Subject-ID finden Sie unter Grant of Client Credentials (Zugriff gewähren).

Variablenname Beschreibung Standardwert Secret
CHRONICLE_CUSTOMER_ID Kundennummer der Google Security Operations-Instanz. Keine Nein
POLL_INTERVAL Häufigkeitsintervall, in dem die Funktion ausgeführt wird, um zusätzliche Protokolldaten abzurufen (in Minuten). Diese Dauer muss mit dem Intervall des Cloud Scheduler-Jobs übereinstimmen. 5 Nein
CHRONICLE_REGION Region der Google Security Operations-Instanz. us
Weitere gültige Werte: asia-northeast1, asia-south1, asia-southeast1, australia-southeast1, europe, europe-west2, europe-west3, europe-west6, europe-west9, europe-west12, me-central1, me-central2, me-west1, northamerica-northeast2 und southamerica-east1.
Nein
CHRONICLE_SERVICE_ACCOUNT Pfad zum Secret in Secret Manager, in dem die JSON-Datei des Google Security Operations-Dienstkontos gespeichert ist. Keine Ja
BOX_CLIENT_ID Client-ID der Box-Plattform, verfügbar in der Box Developer Console. Keine Nein
BOX_CLIENT_SECRET Pfad zum Secret in Secret Manager, in dem das Client-Secret der Box-Plattform gespeichert ist, das für die Authentifizierung verwendet wird. Keine Ja
BOX_SUBJECT_ID Box-Nutzer-ID oder Unternehmens-ID Keine Nein
CHRONICLE_NAMESPACE Der Namespace, mit dem die Google Security Operations-Protokolle gekennzeichnet sind. Informationen zu Namespaces für Google Security Operations finden Sie unter Asset-Namespaces verwenden. Keine Nein

Citrix Cloud-Audit-Logs

Dieses Script sammelt Citrix Cloud-Audit-Logs und nimmt sie mit dem Logtyp CITRIX_MONITOR in Google Security Operations auf. Diese Logs helfen dabei, Aktivitäten in der Citrix Cloud-Umgebung zu identifizieren, indem sie Informationen dazu liefern, was geändert wurde, wer sie geändert hat, wann sie geändert wurde usw. Weitere Informationen finden Sie in der Citrix Cloud SystemLog API.

Definieren Sie in der Datei .env.yml die folgenden Umgebungsvariablen. Informationen zu Citrix-Client-IDs und Clientschlüsseln finden Sie unter Einstieg in Citrix APIs.

Variablenname Beschreibung Standardwert Secret
CHRONICLE_CUSTOMER_ID Kundennummer der Google Security Operations-Instanz. Keine Nein
CHRONICLE_REGION Region der Google Security Operations-Instanz. us
Weitere gültige Werte: asia-northeast1, asia-south1, asia-southeast1, australia-southeast1, europe, europe-west2, europe-west3, europe-west6, europe-west9, europe-west12, me-central1, me-central2, me-west1, northamerica-northeast2 und southamerica-east1.
Nein
CHRONICLE_SERVICE_ACCOUNT Pfad zum Secret in Secret Manager, in dem die JSON-Datei des Google Security Operations-Dienstkontos gespeichert ist. Keine Ja
CITRIX_CLIENT_ID Citrix API-Client-ID. Keine Nein
CITRIX_CLIENT_SECRET Pfad zum Secret in Secret Manager, in dem das für die Authentifizierung verwendete Client-Secret der Citrix API gespeichert ist. Keine Ja
CITRIX_CUSTOMER_ID Citrix-Kundennummer. Keine Nein
POLL_INTERVAL Häufigkeitsintervall, in dem zusätzliche Protokolldaten erfasst werden (in Minuten). Diese Dauer muss mit dem Intervall des Cloud Scheduler-Jobs übereinstimmen. 30 Nein
URL_DOMAIN Citrix Cloud-Endpunkt Keine Nein
CHRONICLE_NAMESPACE Der Namespace, mit dem die Google Security Operations-Protokolle gekennzeichnet sind. Informationen zu Namespaces für Google Security Operations finden Sie unter Asset-Namespaces verwenden. Keine Nein

Citrix-Sitzungsmetadaten

Dieses Script erfasst Citrix-Sitzungsmetadaten aus Citrix-Umgebungen und nimmt sie mit dem CITRIX_MONITOR-Log-Typ in Google Security Operations auf. Die Daten umfassen Anmeldedetails des Nutzers, Sitzungsdauer, Erstellungszeit der Sitzung, Sitzungsendzeit und andere sitzungsbezogene Metadaten. Weitere Informationen finden Sie in der Citrix Monitor Service API.

Definieren Sie in der Datei .env.yml die folgenden Umgebungsvariablen. Informationen zu Citrix-Client-IDs und Clientschlüsseln finden Sie unter Einstieg in Citrix APIs.

Variablenname Beschreibung Standardwert Secret
CHRONICLE_CUSTOMER_ID Kundennummer der Google Security Operations-Instanz. Keine Nein
CHRONICLE_REGION Region der Google Security Operations-Instanz. us
Weitere gültige Werte: asia-northeast1, asia-south1, asia-southeast1, australia-southeast1, europe, europe-west2, europe-west3, europe-west6, europe-west9, europe-west12, me-central1, me-central2, me-west1, northamerica-northeast2 und southamerica-east1.
Nein
CHRONICLE_SERVICE_ACCOUNT Pfad zum Secret in Secret Manager, in dem die JSON-Datei des Google Security Operations-Dienstkontos gespeichert ist. Keine Ja
URL_DOMAIN Citrix-URL-Domain. Keine Nein
CITRIX_CLIENT_ID Citrix-Client-ID. Keine Nein
CITRIX_CLIENT_SECRET Pfad zum Secret in Secret Manager, in dem das für die Authentifizierung verwendete Citrix-Client-Secret gespeichert ist. Keine Ja
CITRIX_CUSTOMER_ID Citrix-Kundennummer. Keine Nein
POLL_INTERVAL Häufigkeitsintervall, in dem die Funktion ausgeführt wird, um zusätzliche Protokolldaten abzurufen (in Minuten). Diese Dauer muss mit dem Intervall des Cloud Scheduler-Jobs übereinstimmen. 30 Nein
CHRONICLE_NAMESPACE Der Namespace, mit dem die Google Security Operations-Protokolle gekennzeichnet sind. Informationen zu Namespaces für Google Security Operations finden Sie unter Asset-Namespaces verwenden. Keine Nein

Cloud Storage

Dieses Script ruft Systemprotokolle aus Cloud Storage ab und nimmt sie mit einem konfigurierbaren Wert für den Logtyp in Google Security Operations auf. Weitere Informationen finden Sie in der Google Cloud-Python-Clientbibliothek.

Definieren Sie in der Datei .env.yml die folgenden Umgebungsvariablen. In Google Cloud gibt es sicherheitsrelevante Logs, von denen einige Logtypen nicht direkt nach Google Security Operations exportiert werden können. Weitere Informationen finden Sie unter Sicherheitsprotokolle analysieren.

Variable Beschreibung Standard Secret
CHRONICLE_CUSTOMER_ID Kundennummer der Google Security Operations-Instanz. Keine Nein
CHRONICLE_REGION Region der Google Security Operations-Instanz. us
Weitere gültige Werte: asia-northeast1, asia-south1, asia-southeast1, australia-southeast1, europe, europe-west2, europe-west3, europe-west6, europe-west9, europe-west12, me-central1, me-central2, me-west1, northamerica-northeast2 und southamerica-east1.
Nein
CHRONICLE_SERVICE_ACCOUNT Pfad zum Secret in Secret Manager, in dem die JSON-Datei des Google Security Operations-Dienstkontos gespeichert ist. Keine Ja
CHRONICLE_NAMESPACE Der Namespace, mit dem die Google Security Operations-Protokolle gekennzeichnet sind. Informationen zu Namespaces für Google Security Operations finden Sie unter Asset-Namespaces verwenden. Keine Nein
POLL_INTERVAL Häufigkeitsintervall, in dem die Funktion ausgeführt wird, um zusätzliche Protokolldaten abzurufen (in Minuten). Diese Dauer muss mit dem Cloud Scheduler-Jobintervall übereinstimmen. 60 Nein
GCS_BUCKET_NAME Name des Cloud Storage-Bucket, aus dem die Daten abgerufen werden sollen. Keine Nein
GCP_SERVICE_ACCOUNT_SECRET_PATH Pfad zum Secret in Secret Manager, in dem die JSON-Datei des Google Cloud-Dienstkontos gespeichert ist. Keine Ja
CHRONICLE_DATA_TYPE Protokolltyp, um Daten in die Google Security Operations-Instanz zu pushen. Keine Nein

Duo-Aktivitäten

Dieses Script ruft Duo-Aktivitätsprotokolle aus Duo Admin ab und nimmt sie mit dem Protokolltyp DUO_ACTIVITY in Google Security Operations auf. Weitere Informationen finden Sie in der Duo Admin API.

Definieren Sie in der Datei .env.yml die folgenden Umgebungsvariablen.

Variablenname Beschreibung Standardwert Secret
CHRONICLE_CUSTOMER_ID Kundennummer der Google Security Operations-Instanz. Keine Nein
CHRONICLE_REGION Region der Google Security Operations-Instanz. us
Weitere gültige Werte: asia-northeast1, asia-south1, asia-southeast1, australia-southeast1, europe, europe-west2, europe-west3, europe-west6, europe-west12, me-central1, me-central2, me-west1 und northamerica-northeast2.
Nein
CHRONICLE_SERVICE_ACCOUNT Pfad zum Secret in Secret Manager, in dem die JSON-Datei des Google Security Operations-Dienstkontos gespeichert ist. Keine Ja
BACKSTORY_API_V1_URL Der URL-Pfad der Duo Security API. Weitere Informationen zum Herunterladen der JSON-Datei mit dem DUO Admin API-Integrationsschlüssel finden Sie in der DUO Admin-Dokumentation. Keine Ja
DUO_SECRET_KEY Der DUO-Secret-Schlüssel, der zum Abrufen von Protokollen aus der DUO API erforderlich ist. In der Duo Admin-Dokumentation finden Sie eine Anleitung zum Herunterladen der JSON-Datei, die den Integrationsschlüssel, den geheimen Schlüssel und den Hostnamen der Duo Admin API enthält.
Keine Ja
DUO_INTEGRATION_KEY Der DUO-Integrationsschlüssel, der zum Abrufen von Protokollen aus der DUO API erforderlich ist. In der Duo Admin-Dokumentation finden Sie eine Anleitung zum Herunterladen der JSON-Datei, die den Integrationsschlüssel, den geheimen Schlüssel und den Hostnamen der Duo Admin API enthält.
Keine Ja
LOG_FETCH_DURATION Die Dauer, für die die Protokolle abgerufen werden. 1 Nein
CHECKPOINT_FILE_PATH Der Pfad zur Datei, in der der Prüfzeitstempel des letzten aufgenommenen Logs gespeichert ist. checkpoint.json Nein
CHRONICLE_NAMESPACE Der Namespace, mit dem die Google Security Operations-Protokolle gekennzeichnet sind. Informationen zu Namespaces für Google Security Operations finden Sie unter Asset-Namespaces verwenden. Keine Nein

Duo Admin

Das Script ruft Ereignisse von Duo Admin ab, die sich auf CRUD-Vorgänge beziehen, die auf verschiedenen Objekten wie Nutzerkonten und Sicherheit ausgeführt werden. Die Ereignisse werden mit dem Protokolltyp DUO_ADMIN in Google Security Operations aufgenommen. Weitere Informationen finden Sie in der Duo Admin API.

Definieren Sie in der Datei .env.yml die folgenden Umgebungsvariablen.

Variablenname Beschreibung Standardwert Secret
CHRONICLE_CUSTOMER_ID Kundennummer der Google Security Operations-Instanz. Keine Nein
CHRONICLE_REGION Region der Google Security Operations-Instanz. us
Weitere gültige Werte: asia-northeast1, asia-south1, asia-southeast1, australia-southeast1, europe, europe-west2, europe-west3, europe-west6, europe-west9, europe-west12, me-central1, me-central2, me-west1, northamerica-northeast2 und southamerica-east1.
Nein
CHRONICLE_SERVICE_ACCOUNT Pfad zum Secret in Secret Manager, in dem die JSON-Datei des Google Security Operations-Dienstkontos gespeichert ist. Keine Ja
POLL_INTERVAL Intervall, in dem die Funktion ausgeführt wird, um zusätzliche Protokolldaten abzurufen (in Minuten). Diese Dauer muss mit dem Cloud Scheduler-Job-Intervall übereinstimmen. Keine Nein
DUO_API_DETAILS Pfad zum Secret im Secret Manager, in dem die JSON-Datei des Duo-Kontos gespeichert ist. Dieser enthält den Integrationsschlüssel, den geheimen Schlüssel und den Hostnamen der Duo Admin API. Beispiel:
{ "ikey": "abcd123", "skey": "def345", "api_host": "abc-123" }
Eine Anleitung zum Herunterladen der JSON-Datei finden Sie in der Duo Admin-Dokumentation.
Keine Ja
CHRONICLE_NAMESPACE Der Namespace, mit dem die Google Security Operations-Protokolle gekennzeichnet sind. Informationen zu Namespaces für Google Security Operations finden Sie unter Asset-Namespaces verwenden. Keine Nein

MISP

Dieses Script ruft Informationen zu Bedrohungsbeziehungen von MISP ab, einer Open-Source-Plattform für Threat Intelligence und ‑Teilen, und nimmt sie mit dem MISP_IOC-Logtyp in Google Security Operations auf. Weitere Informationen finden Sie in der MISP Events API.

Definieren Sie in der Datei .env.yml die folgenden Umgebungsvariablen.

Variable Beschreibung Standardwert Secret
CHRONICLE_CUSTOMER_ID Kundennummer der Google Security Operations-Instanz. Keine Nein
POLL_INTERVAL Häufigkeitsintervall, in dem die Funktion ausgeführt wird, um zusätzliche Protokolldaten abzurufen (in Minuten). Diese Dauer muss mit dem Intervall des Cloud Scheduler-Jobs übereinstimmen. 5 Nein
CHRONICLE_REGION Region der Google Security Operations-Instanz. us
Weitere gültige Werte: asia-northeast1, asia-south1, asia-southeast1, australia-southeast1, europe, europe-west2, europe-west3, europe-west6, europe-west9, europe-west12, me-central1, me-central2, me-west1, northamerica-northeast2 und southamerica-east1.
Nein
CHRONICLE_SERVICE_ACCOUNT Pfad zum Secret in Secret Manager, in dem die JSON-Datei des Google Security Operations-Dienstkontos gespeichert ist. Keine Ja
ORG_NAME Name der Organisation zum Filtern von Ereignissen. Keine Nein
API_KEY Pfad zum Secret in Secret Manager, in dem der API-Schlüssel für die verwendete Authentifizierung gespeichert ist. Keine Ja
TARGET_SERVER Die IP-Adresse der von Ihnen erstellten MISP-Instanz. Keine Nein
CHRONICLE_NAMESPACE Der Namespace, mit dem die Google Security Operations-Protokolle gekennzeichnet sind. Informationen zu Namespaces für Google Security Operations finden Sie unter Asset-Namespaces verwenden. Keine Nein

OneLogin-Ereignisse

Dieses Script ruft Ereignisse aus einer OneLogin-Umgebung ab und nimmt sie mit dem ONELOGIN_SSO-Logtyp in Google Security Operations auf. Diese Ereignisse liefern Informationen wie Vorgänge an Nutzerkonten. Weitere Informationen finden Sie in der OneLogin Events API.

Definieren Sie in der Datei .env.yml die folgenden Umgebungsvariablen. Informationen zu OneLogin-Client-IDs und Client-Secrets finden Sie unter API-Anmeldedaten verwenden.

Variablenname Beschreibung Standardwert Secret
CHRONICLE_CUSTOMER_ID Kundennummer der Google Security Operations-Instanz. Keine Nein
POLL_INTERVAL Häufigkeitsintervall, in dem die Funktion ausgeführt wird, um zusätzliche Protokolldaten abzurufen (in Minuten). Diese Dauer muss mit dem Intervall des Cloud Scheduler-Jobs übereinstimmen. 5 Nein
CHRONICLE_REGION Region der Google Security Operations-Instanz. us
Weitere gültige Werte: asia-northeast1, asia-south1, asia-southeast1, australia-southeast1, europe, europe-west2, europe-west3, europe-west6, europe-west9, europe-west12, me-central1, me-central2, me-west1, northamerica-northeast2 und southamerica-east1.
Nein
CHRONICLE_SERVICE_ACCOUNT Pfad zum Secret in Secret Manager, in dem die JSON-Datei des Google Security Operations-Dienstkontos gespeichert ist. Keine Ja
CLIENT_ID Client-ID der OneLogin-Plattform. Keine Nein
CLIENT_SECRET Pfad zum Secret in Secret Manager, in dem das Client-Secret der OneLogin-Plattform gespeichert ist, das für die Authentifizierung verwendet wird. Keine Ja
TOKEN_ENDPOINT Die URL, unter der ein Zugriffstoken angefordert wird. https://api.us.onelogin.com/auth/oauth2/v2/token Nein
CHRONICLE_NAMESPACE Der Namespace, mit dem die Google Security Operations-Protokolle gekennzeichnet sind. Informationen zu Namespaces für Google Security Operations finden Sie unter Asset-Namespaces verwenden. Keine Nein

OneLogin-Nutzerkontext

Dieses Script ruft Daten zu Nutzerkonten aus einer OneLogin-Umgebung ab und nimmt sie mit dem Protokolltyp ONELOGIN_USER_CONTEXT in Google Security Operations auf. Weitere Informationen finden Sie in der OneLogin User API.

Definieren Sie in der Datei .env.yml die folgenden Umgebungsvariablen. Informationen zu OneLogin-Client-IDs und Client-Secrets finden Sie unter API-Anmeldedaten verwenden.

Variablenname Beschreibung Standardwert Secret
CHRONICLE_CUSTOMER_ID Kundennummer der Google Security Operations-Instanz. Keine Nein
POLL_INTERVAL Häufigkeitsintervall, in dem die Funktion ausgeführt wird, um zusätzliche Protokolldaten abzurufen (in Minuten). Diese Dauer muss mit dem Intervall des Cloud Scheduler-Jobs übereinstimmen. 30 Nein
CHRONICLE_REGION Region der Google Security Operations-Instanz. us
Weitere gültige Werte: asia-northeast1, asia-south1, asia-southeast1, australia-southeast1, europe, europe-west2, europe-west3, europe-west6, europe-west9, europe-west12, me-central1, me-central2, me-west1, northamerica-northeast2 und southamerica-east1.
Nein
CHRONICLE_SERVICE_ACCOUNT Pfad zum Secret in Secret Manager, in dem die JSON-Datei des Google Security Operations-Dienstkontos gespeichert ist. Keine Ja
CLIENT_ID Client-ID der OneLogin-Plattform. Keine Nein
CLIENT_SECRET Pfad zum Secret in Secret Manager, in dem das Client-Secret der OneLogin-Plattform gespeichert ist, das für die Authentifizierung verwendet wird. Keine Ja
TOKEN_ENDPOINT Die URL, unter der ein Zugriffstoken angefordert wird. https://api.us.onelogin.com/auth/oauth2/v2/token Nein
CHRONICLE_NAMESPACE Der Namespace, mit dem die Google Security Operations-Protokolle gekennzeichnet sind. Informationen zu Namespaces für Google Security Operations finden Sie unter Asset-Namespaces verwenden. Keine Nein

Proofpoint

Dieses Script ruft Daten zu Nutzern ab, die innerhalb eines bestimmten Zeitraums von einer bestimmten Organisation angegriffen wurden, und überträgt diese Daten in Google Security Operations. Informationen zur verwendeten API finden Sie in der People API.

Definieren Sie in der Datei .env.yml die folgenden Umgebungsvariablen. Weitere Informationen zum Abrufen des Proofpoint-Dienstprinzipals und des Proofpoint-Geheimnisses finden Sie in der Konfigurationsanleitung zum Bereitstellen von Proofpoint TAP-Anmeldedaten für Arctic Wolf.

Variable Beschreibung Standard Secret
CHRONICLE_CUSTOMER_ID Kundennummer der Google Security Operations-Instanz. Keine Nein
CHRONICLE_REGION Region der Google Security Operations-Instanz. us
Weitere gültige Werte: asia-northeast1, asia-south1, asia-southeast1, australia-southeast1, europe, europe-west2, europe-west3, europe-west6, europe-west9, europe-west12, me-central1, me-central2, me-west1, northamerica-northeast2 und southamerica-east1.
Nein
CHRONICLE_SERVICE_ACCOUNT Pfad zum Secret in Secret Manager, in dem die JSON-Datei des Google Security Operations-Dienstkontos gespeichert ist. Keine Ja
CHRONICLE_NAMESPACE Der Namespace, mit dem die Google Security Operations-Protokolle gekennzeichnet sind. Informationen zu Namespaces für Google Security Operations finden Sie unter Asset-Namespaces verwenden. Keine Nein
POLL_INTERVAL Häufigkeitsintervall, in dem die Funktion ausgeführt wird, um zusätzliche Protokolldaten abzurufen (in Minuten). Diese Dauer muss mit dem Cloud Scheduler-Jobintervall übereinstimmen. 360 Nein
CHRONICLE_DATA_TYPE Protokolltyp, um Daten in die Google Security Operations-Instanz zu pushen. Keine Nein
PROOFPOINT_SERVER_URL Basis-URL des Proofpoint-Server-API-Gateways. Keine Nein
PROOFPOINT_SERVICE_PRINCIPLE Nutzername der Proofpoint-Plattform. Dies ist in der Regel der Dienstprinzipal. Keine Nein
PROOFPOINT_SECRET Pfad zum Secret Manager mit der Version, in der das Passwort der Proofpoint-Plattform gespeichert ist. Keine Ja
PROOFPOINT_RETRIEVAL_RANGE Gibt an, für wie viele Tage die Daten abgerufen werden sollen. Zulässige Werte sind 14, 30 und 90. Keine Nein

Pub/Sub

Dieses Script sammelt Nachrichten aus Pub/Sub-Abos und nimmt die Daten in Google Security Operations auf. Es überwacht kontinuierlich das Abo-Gateway und nimmt neue Nachrichten auf, sobald sie eintreffen. Weitere Informationen finden Sie in folgenden Dokumenten:

Für dieses Datenaufnahme-Script müssen Sie sowohl in der Datei .env.yml als auch im Cloud Scheduler-Job Variablen festlegen.

  • Definieren Sie in der Datei .env.yml die folgenden Umgebungsvariablen.

    Variablenname Beschreibung Standardwert Secret
    CHRONICLE_CUSTOMER_ID Kundennummer der Google Security Operations-Instanz. Keine Nein
    CHRONICLE_REGION Region der Google Security Operations-Instanz. us
    Weitere gültige Werte: asia-northeast1, asia-south1, asia-southeast1, australia-southeast1, europe, europe-west2, europe-west3, europe-west6, europe-west9, europe-west12, me-central1, me-central2, me-west1, northamerica-northeast2 und southamerica-east1.
    Nein
    CHRONICLE_SERVICE_ACCOUNT Pfad zum Secret in Secret Manager, in dem die JSON-Datei des Google Security Operations-Dienstkontos gespeichert ist. Keine Ja
    CHRONICLE_NAMESPACE Der Namespace, mit dem die Google Security Operations-Protokolle gekennzeichnet sind. Informationen zu Namespaces für Google Security Operations finden Sie unter Asset-Namespaces verwenden. Keine Nein
  • Legen Sie die folgenden Variablen im Cloud Scheduler-Feld Message body (Nachrichtentext) als JSON-formatierten String fest. Weitere Informationen zum Feld Nachrichtentext finden Sie unter Cloud Scheduler erstellen.

    Variablenname Beschreibung Standardwert Secret
    PROJECT_ID Pub/Sub-Projekt-ID. Informationen zur Projekt-ID finden Sie unter Projekte erstellen und verwalten. Keine Nein
    SUBSCRIPTION_ID Pub/Sub-Abo-ID. Keine Nein
    CHRONICLE_DATA_TYPE Aufnahmelabel für den Logtyp, der beim Pushen von Daten an Google Security Operations angegeben wurde. Eine Liste der unterstützten Logtypen finden Sie unter Unterstützte Standardparser. Keine Nein

    Hier ist ein Beispiel für einen JSON-formatierten String für das Feld Message body (Nachrichtentext).

    { "PROJECT_ID":"projectid-0000","SUBSCRIPTION_ID":"subscription-id","CHRONICLE_DATA_TYPE":"SQUID_PROXY"}
    

Audit-Logs für Slack

Dieses Script ruft Audit-Logs aus einer Slack Enterprise Grid-Organisation ab und nimmt sie mit dem Protokolltyp SLACK_AUDIT in Google Security Operations auf. Weitere Informationen finden Sie unter Slack Audit Logs API.

Definieren Sie in der Datei .env.yml die folgenden Umgebungsvariablen.

Variablenname Beschreibung Standardwert Secret
CHRONICLE_CUSTOMER_ID Kundennummer der Google Security Operations-Instanz. Keine Nein
CHRONICLE_REGION Region der Google Security Operations-Instanz. us
Weitere gültige Werte: asia-northeast1, asia-south1, asia-southeast1, australia-southeast1, europe, europe-west2, europe-west3, europe-west6, europe-west9, europe-west12, me-central1, me-central2, me-west1, northamerica-northeast2 und southamerica-east1.
Nein
CHRONICLE_SERVICE_ACCOUNT Pfad zum Secret in Secret Manager, in dem die JSON-Datei des Google Security Operations-Dienstkontos gespeichert ist. Keine Ja
POLL_INTERVAL Häufigkeitsintervall, in dem die Funktion ausgeführt wird, um zusätzliche Protokolldaten abzurufen (in Minuten). Diese Dauer muss mit dem Cloud Scheduler-Job-Intervall übereinstimmen. 5 Nein
SLACK_ADMIN_TOKEN Pfad zum Secret in Secret Manager, in dem das Slack-Authentifizierungstoken gespeichert ist.
Keins
Ja
CHRONICLE_NAMESPACE Der Namespace, mit dem die Google Security Operations-Protokolle gekennzeichnet sind. Informationen zu Namespaces für Google Security Operations finden Sie unter Asset-Namespaces verwenden. Keine Nein

STIX/TAXII

Dieses Script ruft Indikatoren vom STIX/TAXII-Server ab und nimmt sie in Google Security Operations auf. Weitere Informationen finden Sie in der STIX/TAXII API-Dokumentation. Definieren Sie die folgenden Umgebungsvariablen in der Datei .env.yml.

Variablenname Beschreibung Default Secret
CHRONICLE_CUSTOMER_ID Kundennummer der Google Security Operations-Instanz. Keine Nein
CHRONICLE_REGION Region der Google Security Operations-Instanz. us
Weitere gültige Werte: asia-northeast1, asia-south1, asia-southeast1, australia-southeast1, europe, europe-west2, europe-west3, europe-west6, europe-west9, europe-west12, me-central1, me-central2, me-west1, northamerica-northeast2 und southamerica-east1.
Nein
CHRONICLE_SERVICE_ACCOUNT Pfad zum Secret in Secret Manager, in dem die JSON-Datei des Google Security Operations-Dienstkontos gespeichert ist. Keine Ja
POLL_INTERVAL Häufigkeitsintervall (in Minuten), in dem die Funktion ausgeführt wird. Diese Dauer muss mit der des Cloud Scheduler-Jobs übereinstimmen. 60 Nein
TAXII_VERSION Die zu verwendende STIX-/TAXII-Version. Mögliche Optionen sind 1.1, 2.0 und 2.1. Keine Nein
TAXII_DISCOVERY_URL Discovery-URL des TAXII-Servers. Keine Nein
TAXII_COLLECTION_NAMES Sammlungen (CSV), aus denen die Daten abgerufen werden sollen. Lassen Sie das Feld leer, um Daten aus allen Sammlungen abzurufen. Keine Nein
TAXII_USERNAME Für die Authentifizierung erforderlicher Nutzername, falls zutreffend. Keine Nein
TAXII_PASSWORD_SECRET_PATH Passwort, falls für die Authentifizierung erforderlich. Keine Ja

Tenable.io

Dieses Script ruft Asset- und Sicherheitslückendaten von der Tenable.io-Plattform ab und nimmt sie mit dem Protokolltyp TENABLE_IO in Google Security Operations auf. Informationen zur verwendeten Bibliothek finden Sie im pyTenable Python SDK.

Definieren Sie in der Datei .env.yml die folgenden Umgebungsvariablen. Weitere Informationen zu Asset- und Sicherheitslückendaten finden Sie in der Tenable.io API: Assets exportieren und Sicherheitslücken exportieren.

Variable Beschreibung Default Secret
CHRONICLE_CUSTOMER_ID Kundennummer der Google Security Operations-Instanz. Keine Nein
CHRONICLE_REGION Region der Google Security Operations-Instanz. us
Weitere gültige Werte: asia-northeast1, asia-south1, asia-southeast1, australia-southeast1, europe, europe-west2, europe-west3, europe-west6, europe-west9, europe-west12, me-central1, me-central2, me-west1, northamerica-northeast2 und southamerica-east1.
Nein
CHRONICLE_SERVICE_ACCOUNT Pfad zum Secret in Secret Manager, in dem die JSON-Datei des Google Security Operations-Dienstkontos gespeichert ist. Keine Ja
CHRONICLE_NAMESPACE Der Namespace, mit dem die Google Security Operations-Protokolle gekennzeichnet sind. Informationen zu Namespaces für Google Security Operations finden Sie unter Asset-Namespaces verwenden. Keine Nein
POLL_INTERVAL Häufigkeitsintervall, in dem die Funktion ausgeführt wird, um zusätzliche Protokolldaten abzurufen (in Minuten). Diese Dauer muss mit dem Cloud Scheduler-Jobintervall übereinstimmen. 360 Nein
TENABLE_ACCESS_KEY Der für die Authentifizierung verwendete Zugriffsschlüssel. Keine Nein
TENABLE_SECRET_KEY_PATH Pfad zum Google Secret Manager mit der Version, in der das Passwort für den Tenable-Server gespeichert ist. Keine Ja
TENABLE_DATA_TYPE Datentyp, der in Google Security Operations aufgenommen werden soll. Mögliche Werte: ASSETS, VULNERABILITIES. ASSETS, VULNERABILITIES Nein
TENABLE_VULNERABILITY Der Status der Sicherheitslücken, die im Export enthalten sein sollen. Mögliche Werte: „OPEN“, „REOPENED“ und „FIXED“. GEÖFFNET, WIEDER GEÖFFNET Nein

Trend Micro Cloud App Security

Dieses Script ruft Sicherheitsprotokolle von der Trend Micro-Plattform ab und nimmt sie in Google Security Operations auf. Informationen zur verwendeten API finden Sie in der API für Sicherheitsprotokolle. Definieren Sie in der Datei .env.yml die folgenden Umgebungsvariablen.

Variable Beschreibung Default Secret
CHRONICLE_CUSTOMER_ID Kundennummer der Google Security Operations-Instanz. Keine Nein
CHRONICLE_REGION Region der Google Security Operations-Instanz. us
Weitere gültige Werte: asia-northeast1, asia-south1, asia-southeast1, australia-southeast1, europe, europe-west2, europe-west3, europe-west6, europe-west9, europe-west12, me-central1, me-central2, me-west1, northamerica-northeast2 und southamerica-east1.
Nein
CHRONICLE_SERVICE_ACCOUNT Pfad zum Secret in Secret Manager, in dem die JSON-Datei des Google Security Operations-Dienstkontos gespeichert ist. Keine Ja
CHRONICLE_NAMESPACE Der Namespace, mit dem die Google Security Operations-Protokolle gekennzeichnet sind. Informationen zu Namespaces für Google Security Operations finden Sie unter Asset-Namespaces verwenden. Keine Nein
POLL_INTERVAL Häufigkeitsintervall, in dem die Funktion ausgeführt wird, um zusätzliche Protokolldaten abzurufen (in Minuten). Diese Dauer muss mit dem Cloud Scheduler-Jobintervall übereinstimmen. 10 Nein
CHRONICLE_DATA_TYPE Protokolltyp, um Daten in die Google Security Operations-Instanz zu pushen. Keine Nein
TREND_MICRO_AUTHENTICATION_TOKEN Pfad zum Google Secret Manager mit der Version, in der das Authentifizierungstoken für den Trend Micro-Server gespeichert ist. Keine Ja
TREND_MICRO_SERVICE_URL Dienst-URL des Cloud App Security-Dienstes. Keine Nein
TREND_MICRO_SERVICE Der Name des geschützten Dienstes, dessen Protokolle abgerufen werden sollen. Unterstützt kommagetrennte Werte. Mögliche Werte: exchange, sharepoint, onedrive, dropbox, box, googledrive, gmail, teams, exchangeserver, salesforce_sandbox, salesforce_production, teams_chat. exchange, sharepoint, onedrive, dropbox, box, googledrive, gmail, teams, exchangeserver, salesforce_sandbox, salesforce_production, teams_chat Nein
TREND_MICRO_EVENT Der Typ des Sicherheitsereignisses, dessen Protokolle abgerufen werden sollen. Unterstützt kommagetrennte Werte. Mögliche Werte: securityrisk, virtualanalyzer, ransomware, dlp. securityrisk, virtualanalyzer, ransomware, dlp Nein

Trend Micro Vision One

Dieses Script ruft die Audit-Logs von Trend Micro Vision One ab und nimmt sie mit dem Logtyp TREND_MICRO_VISION_AUDIT in Google Security Operations auf. Informationen zur verwendeten API finden Sie in der Audit Logs API. Definieren Sie in der Datei .env.yml die folgenden Umgebungsvariablen.

Variable Beschreibung Default Secret
CHRONICLE_CUSTOMER_ID Kundennummer der Google Security Operations-Instanz. Keine Nein
CHRONICLE_REGION Region der Google Security Operations-Instanz. us
Weitere gültige Werte: asia-northeast1, asia-south1, asia-southeast1, australia-southeast1, europe, europe-west2, europe-west3, europe-west6, europe-west9, europe-west12, me-central1, me-central2, me-west1, northamerica-northeast2 und southamerica-east1.
Nein
CHRONICLE_SERVICE_ACCOUNT Pfad zum Secret in Secret Manager, in dem die JSON-Datei des Google Security Operations-Dienstkontos gespeichert ist. Keine Ja
CHRONICLE_NAMESPACE Der Namespace, mit dem die Google Security Operations-Protokolle gekennzeichnet sind. Informationen zu Namespaces für Google Security Operations finden Sie unter Asset-Namespaces verwenden. Keine Nein
POLL_INTERVAL Häufigkeitsintervall, in dem die Funktion ausgeführt wird, um zusätzliche Protokolldaten abzurufen (in Minuten). Diese Dauer muss mit dem Cloud Scheduler-Jobintervall übereinstimmen. 10 Nein
TREND_MICRO_AUTHENTICATION_TOKEN Pfad zum Google Secret Manager mit der Version, in der das Authentifizierungstoken für den Trend Micro-Server gespeichert ist. Keine Ja
TREND_MICRO_DOMAIN Trend Micro Vision One-Region, in der sich der Dienstendpunkt befindet. Keine Nein