IBM OpenPages-Logs erfassen
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
- Rufen Sie die Einstellungen > Datenverwaltung > Feeds auf. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Feeds auf.
- Klicken Sie auf Neuen Feed hinzufügen.
- Klicken Sie auf der nächsten Seite auf Einzelnen Feed konfigurieren.
- Geben Sie im Feld Feedname einen Namen für den Feed ein, z. B.
IBM OpenPages Events. - Wählen Sie Webhook als Quelltyp aus.
- Wählen Sie IBM OpenPages als Logtyp aus.
- Klicken Sie auf Weiter.
- Geben Sie Werte für die folgenden Eingabeparameter an:
- Trennzeichen für Aufteilung (optional): Geben Sie
\nein, 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.
- Trennzeichen für Aufteilung (optional): Geben Sie
- Klicken Sie auf Weiter.
- 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:
- Klicken Sie auf der Feed-Detailseite auf Geheimen Schlüssel generieren.
- In einem Dialogfeld wird der geheime Schlüssel angezeigt.
- Kopieren und speichern Sie den geheimen Schlüssel an einem sicheren Ort.
Feed-Endpunkt-URL abrufen
- Gehen Sie zum Tab Details des Feeds.
- Kopieren Sie im Abschnitt Endpunktinformationen die Feed-Endpunkt-URL.
Das URL-Format lautet:
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:importDabei ist
{region}die Region Ihrer Google SecOps-Instanz (z. B.us,europeoderasia-southeast1) und{parent}der Ressourcenpfad im Formatprojects/<PROJECT_ID>/locations/<LOCATION>/instances/<INSTANCE_ID>/logTypes/<LOG_TYPE>.Speichern Sie diese URL für die nächsten Schritte.
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
- Rufen Sie die Seite „Anmeldedaten“ derGoogle Cloud Console auf.
- Wählen Sie Ihr Projekt aus (das Projekt, das mit Ihrer Google SecOps-Instanz verknüpft ist).
- Klicken Sie auf Anmeldedaten erstellen > API-Schlüssel.
- Ein API-Schlüssel wird erstellt und in einem Dialogfeld angezeigt.
- Klicken Sie auf API-Schlüssel bearbeiten, um den Schlüssel einzuschränken.
API-Schlüssel einschränken
- 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).
- Name: Geben Sie einen aussagekräftigen Namen ein (z. B.
- Gehen Sie unter API-Einschränkungen so vor:
- Wählen Sie Schlüssel einschränken aus.
- Suchen Sie im Drop-down-Menü APIs auswählen nach der Google SecOps API (oder Chronicle API) und wählen Sie sie aus.
- Klicken Sie auf Speichern.
- Kopieren Sie den Wert des API-Schlüssels aus dem Feld API-Schlüssel oben auf der Seite.
- 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
- Melden Sie sich als Administrator in der Verwaltungskonsole von IBM OpenPages an.
- Gehen Sie zu Verwaltung > Integrationen > Webhooks.
- Klicken Sie auf Webhook erstellen.
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.
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
- Objekttypen: Wählen Sie die GRC-Objekttypen aus, die überwacht werden sollen (z. B.
Webhook testen und aktivieren
Für SaaS-Bereitstellungen:
- Aktivieren Sie zuerst den Webhook, indem Sie den Schalter Aktiviert auf Ein stellen.
- Warten Sie etwa 1–2 Minuten, bis die Verbindung für ausgehenden Traffic geöffnet wird.
- Klicken Sie auf Verbindung testen, um zu prüfen, ob der Endpunkt erreichbar ist.
- Prüfen Sie, ob der Test eine erfolgreiche Antwort zurückgibt.
Für lokale Bereitstellungen:
- Klicken Sie auf Verbindung testen, um zu prüfen, ob der Endpunkt erreichbar ist.
- Prüfen Sie, ob der Test eine erfolgreiche Antwort zurückgibt.
- Aktivieren Sie den Webhook, indem Sie den Schalter Aktiviert auf Ein stellen.
- 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.
Methode 1: Benutzerdefinierte Header (empfohlen)
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