IBM OpenPages-Logs erfassen

Unterstützt in:

In diesem Dokument wird beschrieben, wie Sie IBM OpenPages so konfigurieren, dass Logs über Webhooks an Google Security Operations gesendet werden.

IBM OpenPages ist eine KI-gestützte GRC-Plattform (Governance, Risk, and Compliance), die eine zentrale Lösung für die Verwaltung von Risiken, die Einhaltung regulatorischer Anforderungen, die interne Revision, die IT-Governance und die Richtlinienverwaltung bietet. OpenPages unterstützt Webhooks (Version 9.1.2 und höher), die Echtzeit-Ereignisbenachrichtigungen senden, wenn GRC-Objekte erstellt, aktualisiert, gelöscht, verknüpft oder getrennt werden.

Hinweis

Prüfen Sie, ob die folgenden Voraussetzungen erfüllt sind:

  • Eine Google SecOps-Instanz
  • IBM OpenPages unterstützt Webhooks oder HTTP-POST für die Protokollbereitstellung
  • Zugriff auf die Google Cloud Console (zum Erstellen von API-Schlüsseln)
  • IBM OpenPages Version 9.1.2 oder höher mit Administratorzugriff
  • Für lokale und Cloud Pak for Data-Bereitstellungen: RabbitMQ installiert und konfiguriert, wobei die OpenPages-Verbindung zu RabbitMQ eingerichtet ist
  • Bei SaaS-Bereitstellungen muss die Domain des Google SecOps-Webhook-Endpunkts auf der Zulassungsliste stehen.

Webhook-Feed in Google SecOps erstellen

Feed erstellen

  1. Rufen Sie die Einstellungen > Datenverwaltung > Feeds auf. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Feeds auf.
  2. Klicken Sie auf Neuen Feed hinzufügen.
  3. Klicken Sie auf der nächsten Seite auf Einzelnen Feed konfigurieren.
  4. Geben Sie im Feld Feedname einen Namen für den Feed ein, z. B. IBM OpenPages Events.
  5. Wählen Sie Webhook als Quelltyp aus.
  6. Wählen Sie IBM OpenPages als Logtyp aus.
  7. Klicken Sie auf Weiter.
  8. Geben Sie Werte für die folgenden Eingabeparameter an:
    • Trennzeichen für Aufteilung (optional): Geben Sie \n ein, um mehrzeilige Ereignisse aufzuteilen.
    • Asset-Namespace: Der Asset-Namespace
    • Labels für Datenaufnahme: Das Label, das auf die Ereignisse aus diesem Feed angewendet werden soll.
  9. Klicken Sie auf Weiter.
  10. Prüfen Sie die neue Feedkonfiguration auf dem Bildschirm Abschließen und klicken Sie dann auf Senden.

Secret-Schlüssel generieren und speichern

Nachdem Sie den Feed erstellt haben, müssen Sie einen Secret-Schlüssel für die Authentifizierung generieren:

  1. Klicken Sie auf der Feed-Detailseite auf Geheimen Schlüssel generieren.
  2. In einem Dialogfeld wird der geheime Schlüssel angezeigt.
  3. Kopieren und speichern Sie den geheimen Schlüssel an einem sicheren Ort.

Feed-Endpunkt-URL abrufen

  1. Gehen Sie zum Tab Details des Feeds.
  2. Kopieren Sie im Abschnitt Endpunktinformationen die Feed-Endpunkt-URL.
  3. Das URL-Format lautet:

    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import
    

    Dabei ist {region} die Region Ihrer Google SecOps-Instanz (z. B. us, europe oder asia-southeast1) und {parent} der Ressourcenpfad im Format projects/<PROJECT_ID>/locations/<LOCATION>/instances/<INSTANCE_ID>/logTypes/<LOG_TYPE>.

  4. Speichern Sie diese URL für die nächsten Schritte.

  5. Klicken Sie auf Fertig.

Google Cloud API-Schlüssel erstellen

Google SecOps erfordert einen API-Schlüssel für die Authentifizierung. Erstellen Sie in der Google Cloud Console einen eingeschränkten API-Schlüssel.

API-Schlüssel erstellen

  1. Rufen Sie die Seite „Anmeldedaten“ derGoogle Cloud Console auf.
  2. Wählen Sie Ihr Projekt aus (das Projekt, das mit Ihrer Google SecOps-Instanz verknüpft ist).
  3. Klicken Sie auf Anmeldedaten erstellen > API-Schlüssel.
  4. Ein API-Schlüssel wird erstellt und in einem Dialogfeld angezeigt.
  5. Klicken Sie auf API-Schlüssel bearbeiten, um den Schlüssel einzuschränken.

API-Schlüssel einschränken

  1. Auf der Seite mit den Einstellungen für den API-Schlüssel:
    • Name: Geben Sie einen aussagekräftigen Namen ein (z. B. Google SecOps Webhook API Key).
  2. Gehen Sie unter API-Einschränkungen so vor:
    1. Wählen Sie Schlüssel einschränken aus.
    2. Suchen Sie im Drop-down-Menü APIs auswählen nach der Google SecOps API (oder Chronicle API) und wählen Sie sie aus.
  3. Klicken Sie auf Speichern.
  4. Kopieren Sie den Wert des API-Schlüssels aus dem Feld API-Schlüssel oben auf der Seite.
  5. Speichern Sie den API-Schlüssel an einem sicheren Ort.

IBM OpenPages-Webhook konfigurieren

Webhook-URL erstellen

  • Kombinieren Sie die Chronicle-Endpunkt-URL und den API-Schlüssel:

    <ENDPOINT_URL>?key=<API_KEY>
    

    Beispiel:

    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...
    

Webhook in IBM OpenPages erstellen

  1. Melden Sie sich als Administrator in der Verwaltungskonsole von IBM OpenPages an.
  2. Gehen Sie zu Verwaltung > Integrationen > Webhooks.
  3. Klicken Sie auf Webhook erstellen.
  4. Geben Sie die folgenden Konfigurationsdetails an:

    • Endpunkt-URL: Fügen Sie die vollständige Endpunkt-URL mit dem API-Schlüssel von oben ein (z. B. https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...).

    • Authentifizierungsmethode: Wählen Sie Inhabertoken aus.

    • Inhabertoken: Fügen Sie den Secret-Schlüssel ein, der im Schritt zum Erstellen des Google SecOps-Feeds generiert wurde.

  5. Wählen Sie im Bereich Ereignisabos die Objekttypen und Ereignisse aus, die überwacht werden sollen:

    • Objekttypen: Wählen Sie die GRC-Objekttypen aus, die überwacht werden sollen (z. B. SOXRisk, SOXIssue, SOXBusEntity, SOXControl, SOXProcess, SOXTask).
    • Ereignistypen: Wählen Sie die Ereignisse aus, die an Google SecOps gesendet werden sollen:
      • create: wird veröffentlicht, wenn ein Objekt eines abonnierten Typs erstellt wird
      • update: wird veröffentlicht, wenn ein Objekt eines abonnierten Typs aktualisiert wird (einschließlich der geänderten Felder)
      • delete: wird veröffentlicht, wenn ein Objekt eines abonnierten Typs gelöscht wird
      • associate: wird veröffentlicht, wenn ein Objekt mit einem übergeordneten Objekt verknüpft wird
      • disassociate: wird veröffentlicht, wenn ein Objekt aus einem übergeordneten Objekt entfernt wird

Webhook testen und aktivieren

Für SaaS-Bereitstellungen:

  1. Aktivieren Sie zuerst den Webhook, indem Sie den Schalter Aktiviert auf Ein stellen.
  2. Warten Sie etwa 1–2 Minuten, bis die Verbindung für ausgehenden Traffic geöffnet wird.
  3. Klicken Sie auf Verbindung testen, um zu prüfen, ob der Endpunkt erreichbar ist.
  4. Prüfen Sie, ob der Test eine erfolgreiche Antwort zurückgibt.

Für lokale Bereitstellungen:

  1. Klicken Sie auf Verbindung testen, um zu prüfen, ob der Endpunkt erreichbar ist.
  2. Prüfen Sie, ob der Test eine erfolgreiche Antwort zurückgibt.
  3. Aktivieren Sie den Webhook, indem Sie den Schalter Aktiviert auf Ein stellen.
  4. Warten Sie etwa 5 Minuten, bis der Ereignis-Broker die Konfiguration übernommen hat.

Format der Webhook-Nutzlast

  • IBM OpenPages sendet Webhook-Ereignisse als JSON-Nutzlasten über HTTP POST. Das folgende Beispiel zeigt eine Webhook-Nutzlast für die Aktualisierung eines Risikoobjekts:

    {
        "action": "update",
        "type": "GRC_OBJECT",
        "objectType": "SOXRisk",
        "message": {
            "event": "update",
            "publishedDate": "2025-09-25 02:14:26.797Z",
            "details": {
                "object_id": "9032",
                "object_name": "RB-01-Risk00190",
                "object_path": "/_op_sox/Project/Default/ICDocumentation/Risks/Global Financial Services/North America/Retail Banking/RB-01-Risk00190.txt",
                "updated_fields": [
                    "OPSS-Risk-Qual:Inherent Likelihood",
                    "OPSS-Risk-Qual:Inherent Risk Rating",
                    "OPSS-Risk-Quant:Inherent Frequency",
                    "OPSS-Risk-Quant:Inherent Risk Exposure"
                ],
                "last_modification": "2025-08-30 08:58:48.000Z"
            },
            "actor": {
                "iam_id": "user1@ibm.com",
                "user_id": "2087",
                "user_name": "user1"
            }
        },
        "version": "9.1.2"
    }
    

Webhook-Systemeinschränkungen

Einschränkung Wert
Maximale Anzahl aktivierter Webhooks 50 (Standard), konfigurierbar bis zu 100 über die Registry-Einstellung /Platform/Messaging/Webhooks Limit
Eindeutige Endpunkt-URL Jeder Webhook muss eine eindeutige Endpunkt-URL verwenden.
Ereignis-TTL in der Warteschlange 1 Tag (Ereignisse, die nicht innerhalb dieses Zeitraums gesendet werden, werden entfernt)
Verzögerung bei der Abholung durch den Broker 5 Minuten nach dem Aktivieren eines Webhooks

Referenz zu Authentifizierungsmethoden

Google SecOps-Webhook-Feeds unterstützen mehrere Authentifizierungsmethoden. Wählen Sie die Methode aus, die von Ihrem Anbieter unterstützt wird.

Wenn Ihr Anbieter benutzerdefinierte HTTP-Header unterstützt, verwenden Sie diese Methode, um die Sicherheit zu erhöhen.

  • Anfrageformat:

    POST <ENDPOINT_URL> HTTP/1.1
    Content-Type: application/json
    x-goog-chronicle-auth: <API_KEY>
    x-chronicle-auth: <SECRET_KEY>
    
    {
            "event": "data",
            "timestamp": "2025-01-15T10:30:00Z"
    }
    

Vorteile:

  • API-Schlüssel und Secret sind in der URL nicht sichtbar.
  • Sicherer (Header werden nicht in Webserver-Zugriffslogs protokolliert)
  • Bevorzugte Methode, wenn der Anbieter sie unterstützt

Methode 2: Suchparameter

Wenn Ihr Anbieter keine benutzerdefinierten Header unterstützt, hängen Sie die Anmeldedaten an die URL an.

  • URL-Format:

    <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>
    
  • Beispiel:

    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...
    
  • Anfrageformat:

    POST <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY> HTTP/1.1
    Content-Type: application/json
    
    {
            "event": "data",
            "timestamp": "2025-01-15T10:30:00Z"
    }
    

Nachteile:

  • Anmeldedaten in URL sichtbar
  • Kann in Webserver-Zugriffsprotokollen protokolliert werden
  • Weniger sicher als Header

Methode 3: Hybrid (URL + Header)

Bei einigen Konfigurationen wird der API-Schlüssel in der URL und der geheime Schlüssel im Header verwendet.

  • Anfrageformat:

    POST <ENDPOINT_URL>?key=<API_KEY> HTTP/1.1
    Content-Type: application/json
    x-chronicle-auth: <SECRET_KEY>
    
    {
            "event": "data",
            "timestamp": "2025-01-15T10:30:00Z"
    }
    

Namen der Authentifizierungsheader

Google SecOps akzeptiert die folgenden Headernamen für die Authentifizierung:

Für API-Schlüssel:

  • x-goog-chronicle-auth (empfohlen)
  • X-Goog-Chronicle-Auth (Groß-/Kleinschreibung wird nicht berücksichtigt)

Für den geheimen Schlüssel:

  • x-chronicle-auth (empfohlen)
  • X-Chronicle-Auth (Groß-/Kleinschreibung wird nicht berücksichtigt)

UDM-Zuordnungstabelle

Logfeld UDM-Zuordnung Logik
column5 metadata.description Eine Beschreibung des Ereignisses
has_principal_user metadata.event_type Ereignistyp (z.B. USER_LOGIN, NETWORK_CONNECTION)
Spalte1 metadata.product_event_type Produktspezifischer Ereignistyp
metadata.product_name metadata.product_name Produktname
metadata.vendor_name metadata.vendor_name Anbieter-/Unternehmensname
column6 principal.user.userid Nutzer-ID des Hauptkontos
is_successful security_result.action Ergriffene Maßnahme
is_successful security_result.action_details Details zur Aktion
Spalte4 security_result.detection_fields Zusätzliche Erkennungsfelder
column5 security_result.detection_fields
Zähler security_result.detection_fields
Spalte4 security_result.description Beschreibung des Sicherheitsergebnisses
Spalte2 security_result.summary Zusammenfassung des Sicherheitsergebnisses
Spalte4 target.user.attribute.roles Rollen, die mit dem Zielnutzer verknüpft sind
Spalte4 target.user.userid Nutzer-ID des Ziels
target_user target.user.userid Aus Änderungsprotokoll zugeordnet
IBM_OPENPAGES metadata.vendor_name Aus Änderungsprotokoll zugeordnet
IBM_OPENPAGES metadata.product_name Aus Änderungsprotokoll zugeordnet
OpenPages metadata.product_name Aus Änderungsprotokoll zugeordnet

Änderungsprotokoll

Änderungsprotokoll für diesen Parser ansehen

Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten