PingOne Advanced Identity Cloud-Logs erfassen

Parserversion:4.0

Unterstützt in:

In diesem Dokument wird beschrieben, wie Sie PingOne Advanced Identity Cloud-Logs (früher ForgeRock Identity Cloud) mit Google Cloud Storage V2 in Google Security Operations aufnehmen.

PingOne Advanced Identity Cloud ist eine cloudnative IDaaS-Plattform (Identity-as-a-Service), die Funktionen für die Identitätsverwaltung, Zugriffsverwaltung und Identitäts-Governance bietet. So können Organisationen Nutzeridentitäten verwalten, Authentifizierungsrichtlinien wie die Multi-Faktor-Authentifizierung erzwingen und die Einmalanmeldung für alle Anwendungen ermöglichen, während Compliance und Sicherheit gewährleistet werden.

Weitere Informationen finden Sie in der ForgeRock Identity Cloud-Dokumentation.

Hinweis

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

  • Eine Google SecOps-Instanz
  • Ein GCP-Projekt mit aktivierter Cloud Storage API
  • Berechtigungen zum Erstellen und Verwalten von GCS-Buckets
  • Berechtigungen zum Verwalten von IAM-Richtlinien für GCS-Buckets
  • Berechtigungen zum Erstellen von Cloud Run-Diensten, Pub/Sub-Themen und Cloud Scheduler-Jobs
  • Privilegierter Zugriff auf die Admin-Konsole von PingOne Advanced Identity Cloud (Tenant-Administrator)
  • Ein PingOne Advanced Identity Cloud Log API-Schlüssel und ein Secret mit Zugriff auf die Monitoring-Endpunkte

Google Cloud Storage-Bucket erstellen

  1. Gehen Sie zur Google Cloud Console.
  2. Wählen Sie Ihr Projekt aus oder erstellen Sie ein neues.
  3. Rufen Sie im Navigationsmenü Cloud Storage > Buckets auf.
  4. Klicken Sie auf Bucket erstellen.

  5. Geben Sie die folgenden Konfigurationsdetails an:

    Einstellung Wert
    Bucket benennen Geben Sie einen global eindeutigen Namen ein, z. B. forgerock-identity-cloud-logs.
    Standorttyp Wählen Sie die Option aus, die am besten zu Ihren Anforderungen passt (Region, Dual-Region, Multi-Region).
    Standort Wählen Sie den Ort aus, z. B. us-central1.
    Speicherklasse Standard (empfohlen für Logs, auf die häufig zugegriffen wird)
    Zugriffskontrolle Einheitlich (empfohlen)
    Schutzmaßnahmen Optional: Objektversionsverwaltung oder Aufbewahrungsrichtlinie aktivieren

  6. Klicken Sie auf Erstellen.

Log API-Schlüssel in PingOne Advanced Identity Cloud erstellen

PingOne Advanced Identity Cloud verwendet Log API-Schlüssel, um Anfragen an den /monitoring/logs-Endpunkt zu authentifizieren. Dies unterscheidet sich von Dienstkonten, die für AM/IDM-Vorgänge verwendet werden.

API-Schlüssel erstellen

  1. Melden Sie sich in der PingOne Advanced Identity Cloud-Admin-Konsole unter https://<tenant-env-fqdn>/platform/admin an (z. B. https://openam-mycompany-ew2.id.forgerock.io/platform/admin).
  2. Klicken Sie oben rechts auf das Mandantenmenü.
  3. Klicken Sie auf Mandanteneinstellungen.
  4. Klicken Sie auf den Tab Globale Einstellungen.
  5. Klicken Sie auf API-Schlüssel protokollieren.
  6. Klicken Sie auf New Log API Key (Neuer Log-API-Schlüssel).
  7. Geben Sie einen aussagekräftigen Namen ein, z. B. chronicle-log-collector.
  8. Klicken Sie auf Erstellen.

  9. Kopieren und speichern Sie die folgenden Werte sicher:

    • api_key_id: Die API-Schlüssel-ID.
    • api_key_secret: Das Secret des API-Schlüssels.

FQDN Ihrer Mandantenumgebung abrufen

  1. Melden Sie sich in der Admin-Konsole von PingOne Advanced Identity Cloud an.
  2. Klicken Sie oben rechts auf das Mandantenmenü.
  3. Klicken Sie auf Mandanteneinstellungen.
  4. Notieren Sie sich unter Details den Wert für Tenant Name (Name des Mandanten).
    • Produktionsformat: openam-<base-name>-<data-region>.id.forgerock.io
    • Entwicklungsformat: openam-<base-name>-<data-region>-dev.id.forgerock.io
    • Sandbox-Format: openam-<sandbox-name>.forgeblocks.com

API-Zugriff testen

  • Testen Sie Ihre Anmeldedaten, bevor Sie mit der Integration fortfahren:

    # Replace with your actual tenant FQDN and credentials
TENANT_FQDN="openam-mycompany-ew2.id.forgerock.io"
API_KEY="<your-api-key-id>"
API_SECRET="<your-api-key-secret>"

# List available log sources
curl -v \
    -H "x-api-key: ${API_KEY}" \
    -H "x-api-secret: ${API_SECRET}" \
    "https://${TENANT_FQDN}/monitoring/logs/sources?_prettyPrint=true"

# Retrieve recent audit logs
curl -v \
    -H "x-api-key: ${API_KEY}" \
    -H "x-api-secret: ${API_SECRET}" \
    "https://${TENANT_FQDN}/monitoring/logs?source=am-authentication&_pageSize=5"

Eine erfolgreiche Antwort gibt HTTP 200 mit einem JSON-Objekt zurück, das Logeinträge enthält. Wenn Sie HTTP 401 erhalten, überprüfen Sie den API-Schlüssel und das Secret. Wenn Sie den HTTP-Statuscode 429 erhalten, haben Sie das Ratenlimit von 60 Anfragen pro Minute überschritten.

Dienstkonto für Cloud Run-Funktion erstellen

Die Cloud Run-Funktion benötigt ein Dienstkonto mit Berechtigungen zum Schreiben in den GCS-Bucket und zum Aufrufen durch Pub/Sub.

Dienstkonto erstellen

  1. Wechseln Sie in der GCP Console zu IAM & Verwaltung > Dienstkonten.
  2. Klicken Sie auf Dienstkonto erstellen.
  3. Geben Sie die folgenden Konfigurationsdetails an:
    • Name des Dienstkontos: Geben Sie forgerock-logs-collector-sa ein.
    • Beschreibung des Dienstkontos: Geben Sie Service account for Cloud Run function to collect PingOne Advanced Identity Cloud logs ein.
  4. Klicken Sie auf Erstellen und fortfahren.
  5. Fügen Sie im Abschnitt Diesem Dienstkonto Zugriff auf das Projekt erteilen die folgenden Rollen hinzu:
    1. Klicken Sie auf Rolle auswählen.
    2. Suchen Sie nach Storage-Objekt-Administrator und wählen Sie die Rolle aus.
    3. Klicken Sie auf + Weitere Rolle hinzufügen.
    4. Suchen Sie nach Cloud Run Invoker und wählen Sie die Rolle aus.
    5. Klicken Sie auf + Weitere Rolle hinzufügen.
    6. Suchen Sie nach Cloud Functions Invoker und wählen Sie die Rolle aus.
  6. Klicken Sie auf Weiter.
  7. Klicken Sie auf Fertig.

Diese Rollen sind erforderlich für:

  • Storage Object Admin (Storage-Objekt-Administrator): Logs in den GCS-Bucket schreiben und Statusdateien verwalten.
  • Cloud Run Invoker: Ermöglicht Pub/Sub, die Funktion aufzurufen.
  • Cloud Functions-Invoker: Ermöglicht den Funktionsaufruf.

IAM-Berechtigungen für GCS-Bucket erteilen

Gewähren Sie dem Dienstkonto Schreibberechtigungen für den GCS-Bucket:

  1. Rufen Sie Cloud Storage > Buckets auf.
  2. Klicken Sie auf den Namen Ihres Buckets, z. B. forgerock-identity-cloud-logs.
  3. Wechseln Sie zum Tab Berechtigungen.
  4. Klicken Sie auf Zugriff erlauben.
  5. Geben Sie die folgenden Konfigurationsdetails an:
    • Hauptkonten hinzufügen: Geben Sie die E-Mail-Adresse des Dienstkontos ein (z. B. forgerock-logs-collector-sa@PROJECT_ID.iam.gserviceaccount.com).
    • Rollen zuweisen: Wählen Sie Storage-Objekt-Administrator aus.
  6. Klicken Sie auf Speichern.

Pub/Sub-Thema erstellen

Erstellen Sie ein Pub/Sub-Thema, in dem Cloud Scheduler veröffentlicht und das von der Cloud Run-Funktion abonniert wird.

  1. Rufen Sie in der GCP Console Pub/Sub > Themen auf.
  2. Klicken Sie auf Thema erstellen.
  3. Geben Sie die folgenden Konfigurationsdetails an:
    • Themen-ID: Geben Sie forgerock-logs-trigger ein.
    • Andere Einstellungen als Standardeinstellungen beibehalten
  4. Klicken Sie auf Erstellen.

Cloud Run-Funktion zum Erfassen von Logs erstellen

Die Cloud Run-Funktion wird durch Pub/Sub-Nachrichten von Cloud Scheduler ausgelöst, um Logs von der PingOne Advanced Identity Cloud Monitoring API abzurufen und in GCS zu schreiben.

  1. Rufen Sie in der GCP Console Cloud Run auf.
  2. Klicken Sie auf Dienst erstellen.
  3. Wählen Sie Funktion aus, um eine Funktion mit einem Inline-Editor zu erstellen.

  4. Geben Sie im Abschnitt Konfigurieren die folgenden Konfigurationsdetails an:

    Einstellung Wert
    Dienstname forgerock-logs-collector
    Region Wählen Sie die Region aus, die Ihrem GCS-Bucket entspricht (z. B. us-central1).
    Laufzeit Wählen Sie Python 3.12 oder höher aus.

  5. Im Abschnitt Trigger (optional):

    1. Klicken Sie auf + Trigger hinzufügen.
    2. Wählen Sie Cloud Pub/Sub aus.
    3. Wählen Sie unter Cloud Pub/Sub-Thema auswählen die Option forgerock-logs-trigger aus.
    4. Klicken Sie auf Speichern.

  6. Im Abschnitt Authentifizierung:

    1. Wählen Sie Authentifizierung erforderlich aus.
    2. Identitäts- und Zugriffsverwaltung

  7. Scrollen Sie nach unten und maximieren Sie Container, Netzwerk, Sicherheit.

  8. Rufen Sie den Tab Sicherheit auf:

    • Dienstkonto: Wählen Sie forgerock-logs-collector-sa aus.

  9. Rufen Sie den Tab Container auf:

    1. Klicken Sie auf Variablen und Secrets.
    2. Klicken Sie für jede Umgebungsvariable auf + Variable hinzufügen:
    Variablenname Beispielwert Beschreibung
    GCS_BUCKET forgerock-identity-cloud-logs Name des GCS-Buckets
    GCS_PREFIX forgerock-logs Präfix für Protokolldateien
    STATE_KEY forgerock-logs/state.json Statusdateipfad
    TENANT_FQDN openam-mycompany-ew2.id.forgerock.io FQDN der PingOne AIC-Mandantenumgebung
    API_KEY <your-api-key-id> ID des PingOne AIC Log API-Schlüssels
    API_SECRET <your-api-key-secret> Secret des PingOne AIC Log API-Schlüssels
    LOG_SOURCES am-authentication,am-access,am-activity,am-config,idm-access,idm-activity,idm-authentication,idm-sync Kommagetrennte Logquellen
    MAX_RECORDS 5000 Maximale Anzahl von Datensätzen pro Quelle und Ausführung
    PAGE_SIZE 1000 Einträge pro Seite (max. 1.000)
    LOOKBACK_HOURS 24 Erster Rückschauzeitraum

  10. Scrollen Sie im Bereich Variablen und Secrets nach unten zu Anfragen:

    • Zeitüberschreitung bei Anfrage: Geben Sie 600 Sekunden (10 Minuten) ein.

  11. Rufen Sie den Tab Einstellungen auf:

    • Im Abschnitt Ressourcen:
      • Arbeitsspeicher: Wählen Sie 512 MiB oder höher aus.
      • CPU: Wählen Sie 1 aus.

  12. Im Abschnitt Versionsskalierung:

    • Mindestanzahl von Instanzen: Geben Sie 0 ein.
    • Maximale Anzahl von Instanzen: Geben Sie 100 ein (oder passen Sie den Wert an die erwartete Last an).

  13. Klicken Sie auf Erstellen.

  14. Warten Sie ein bis zwei Minuten, bis der Dienst erstellt wurde.

  15. Nachdem der Dienst erstellt wurde, wird automatisch der Inline-Code-Editor geöffnet.

Funktionscode hinzufügen

  1. Geben Sie main in das Feld Einstiegspunkt ein.

  2. Erstellen Sie im Inline-Codeeditor zwei Dateien:

    • main.py:

      import functions_framework
from google.cloud import storage
import json
import os
import urllib3
from datetime import datetime, timezone, timedelta
import time

# Initialize HTTP client with timeouts
http = urllib3.PoolManager(
    timeout=urllib3.Timeout(connect=5.0, read=30.0),
    retries=False,
)

# Initialize Storage client
storage_client = storage.Client()

# Environment variables
GCS_BUCKET = os.environ.get('GCS_BUCKET')
GCS_PREFIX = os.environ.get('GCS_PREFIX', 'forgerock-logs')
STATE_KEY = os.environ.get('STATE_KEY', 'forgerock-logs/state.json')
TENANT_FQDN = os.environ.get('TENANT_FQDN')
API_KEY = os.environ.get('API_KEY')
API_SECRET = os.environ.get('API_SECRET')
LOG_SOURCES = os.environ.get('LOG_SOURCES', 'am-authentication,am-access,am-activity,idm-access,idm-activity,idm-authentication')
MAX_RECORDS = int(os.environ.get('MAX_RECORDS', '5000'))
PAGE_SIZE = int(os.environ.get('PAGE_SIZE', '1000'))
LOOKBACK_HOURS = int(os.environ.get('LOOKBACK_HOURS', '24'))

def parse_datetime(value: str) -> datetime:
    """Parse ISO datetime string to datetime object."""
    if value.endswith("Z"):
        value = value[:-1] + "+00:00"
    return datetime.fromisoformat(value)

@functions_framework.cloud_event
def main(cloud_event):
    """
    Cloud Run function triggered by Pub/Sub to fetch PingOne Advanced Identity Cloud
    logs and write to GCS.

    Args:
        cloud_event: CloudEvent object containing Pub/Sub message
    """

    if not all([GCS_BUCKET, TENANT_FQDN, API_KEY, API_SECRET]):
        print('Error: Missing required environment variables')
        return

    try:
        # Get GCS bucket
        bucket = storage_client.bucket(GCS_BUCKET)

        # Load state
        state = load_state(bucket, STATE_KEY)

        # Determine time window
        now = datetime.now(timezone.utc)
        last_time = None

        if isinstance(state, dict) and state.get("last_event_time"):
            try:
                last_time = parse_datetime(state["last_event_time"])
                # Overlap by 2 minutes to catch any delayed events
                last_time = last_time - timedelta(minutes=2)
            except Exception as e:
                print(f"Warning: Could not parse last_event_time: {e}")

        if last_time is None:
            last_time = now - timedelta(hours=LOOKBACK_HOURS)

        print(f"Fetching logs from {last_time.isoformat()} to {now.isoformat()}")

        # Fetch logs for configured sources
        all_records = []
        newest_event_time = None
        sources = [s.strip() for s in LOG_SOURCES.split(',') if s.strip()]

        for source in sources:
            records, source_newest_time = fetch_logs(
                tenant_fqdn=TENANT_FQDN,
                api_key=API_KEY,
                api_secret=API_SECRET,
                source=source,
                start_time=last_time,
                end_time=now,
                page_size=PAGE_SIZE,
                max_records=MAX_RECORDS,
            )
            all_records.extend(records)

            if source_newest_time:
                if newest_event_time is None or parse_datetime(source_newest_time) > parse_datetime(newest_event_time):
                    newest_event_time = source_newest_time

            print(f"Source '{source}': {len(records)} records")

        if not all_records:
            print("No new log records found.")
            save_state(bucket, STATE_KEY, now.isoformat())
            return

        # Write to GCS as NDJSON
        timestamp = now.strftime('%Y%m%d_%H%M%S')
        object_key = f"{GCS_PREFIX}/logs_{timestamp}.ndjson"
        blob = bucket.blob(object_key)

        ndjson = '\n'.join([json.dumps(record, ensure_ascii=False) for record in all_records]) + '\n'
        blob.upload_from_string(ndjson, content_type='application/x-ndjson')

        print(f"Wrote {len(all_records)} records to gs://{GCS_BUCKET}/{object_key}")

        # Update state with newest event time
        if newest_event_time:
            save_state(bucket, STATE_KEY, newest_event_time)
        else:
            save_state(bucket, STATE_KEY, now.isoformat())

        print(f"Successfully processed {len(all_records)} records")

    except Exception as e:
        print(f'Error processing logs: {str(e)}')
        raise

def load_state(bucket, key):
    """Load state from GCS."""
    try:
        blob = bucket.blob(key)
        if blob.exists():
            state_data = blob.download_as_text()
            return json.loads(state_data)
    except Exception as e:
        print(f"Warning: Could not load state: {e}")

    return {}

def save_state(bucket, key, last_event_time_iso: str):
    """Save the last event timestamp to GCS state file."""
    try:
        state = {'last_event_time': last_event_time_iso}
        blob = bucket.blob(key)
        blob.upload_from_string(
            json.dumps(state, indent=2),
            content_type='application/json'
        )
        print(f"Saved state: last_event_time={last_event_time_iso}")
    except Exception as e:
        print(f"Warning: Could not save state: {e}")

def fetch_logs(tenant_fqdn: str, api_key: str, api_secret: str, source: str, start_time: datetime, end_time: datetime, page_size: int, max_records: int):
    """
    Fetch logs from PingOne Advanced Identity Cloud Monitoring API with pagination.

    Args:
        tenant_fqdn: Tenant environment FQDN
        api_key: Log API key ID
        api_secret: Log API key secret
        source: Log source (am-authentication, am-access, idm-access, etc.)
        start_time: Start time for log query
        end_time: End time for log query
        page_size: Number of records per page (max 1000)
        max_records: Maximum total records to fetch

    Returns:
        Tuple of (records list, newest_event_time ISO string)
    """
    endpoint = f"https://{tenant_fqdn}/monitoring/logs"

    headers = {
        'x-api-key': api_key,
        'x-api-secret': api_secret,
        'Accept': 'application/json',
        'User-Agent': 'GoogleSecOps-ForgeRockCollector/1.0'
    }

    records = []
    newest_time = None
    page_num = 0
    backoff = 1.0

    begin_time = start_time.strftime('%Y-%m-%dT%H:%M:%SZ')
    end_time_str = end_time.strftime('%Y-%m-%dT%H:%M:%SZ')
    paged_results_cookie = None

    while True:
        page_num += 1

        if len(records) >= max_records:
            print(f"Reached max_records limit ({max_records})")
            break

        current_limit = min(page_size, max_records - len(records))
        url = f"{endpoint}?source={source}&beginTime={begin_time}&endTime={end_time_str}&_pageSize={current_limit}"

        if paged_results_cookie:
            url += f"&_pagedResultsCookie={paged_results_cookie}"

        try:
            response = http.request('GET', url, headers=headers)

            # Handle rate limiting with exponential backoff
            if response.status == 429:
                retry_after = int(response.headers.get('Retry-After', str(int(backoff))))
                print(f"Rate limited (429). Retrying after {retry_after}s...")
                time.sleep(retry_after)
                backoff = min(backoff * 2, 30.0)
                continue

            backoff = 1.0

            if response.status != 200:
                print(f"HTTP Error: {response.status}")
                response_text = response.data.decode('utf-8')
                print(f"Response body: {response_text}")
                return [], None

            data = json.loads(response.data.decode('utf-8'))

            page_results = data.get('result', [])

            if not page_results:
                print(f"No more results (empty page)")
                break

            print(f"Page {page_num}: Retrieved {len(page_results)} events")
            records.extend(page_results)

            # Track newest event time
            for event in page_results:
                try:
                    event_time = event.get('timestamp')
                    if event_time:
                        if newest_time is None or parse_datetime(event_time) > parse_datetime(newest_time):
                            newest_time = event_time
                except Exception as e:
                    print(f"Warning: Could not parse event time: {e}")

            # Check for more results
            paged_results_cookie = data.get('pagedResultsCookie')
            if not paged_results_cookie or paged_results_cookie == "-1":
                print(f"Reached last page (no more results)")
                break

        except Exception as e:
            print(f"Error fetching logs: {e}")
            return [], None

    print(f"Retrieved {len(records)} total records from {page_num} pages")
    return records, newest_time

    • requirements.txt:

      functions-framework==3.*
google-cloud-storage==2.*
urllib3>=2.0.0

  3. Klicken Sie auf Bereitstellen, um die Funktion zu speichern und bereitzustellen.

  4. Warten Sie, bis die Bereitstellung abgeschlossen ist (2–3 Minuten).

Cloud Scheduler-Job erstellen

Cloud Scheduler veröffentlicht in regelmäßigen Abständen Nachrichten im Pub/Sub-Thema und löst so die Cloud Run-Funktion aus.

  1. Rufen Sie in der GCP Console Cloud Scheduler auf.
  2. Klicken Sie auf Job erstellen.

  3. Geben Sie die folgenden Konfigurationsdetails an:

    Einstellung Wert
    Name forgerock-logs-collector-hourly
    Region Dieselbe Region wie für die Cloud Run-Funktion auswählen
    Frequenz 0 * * * * (jede Stunde, zur vollen Stunde)
    Zeitzone Zeitzone auswählen (UTC empfohlen)
    Zieltyp Pub/Sub
    Thema forgerock-logs-trigger auswählen
    Inhalt der Nachricht {} (leeres JSON-Objekt)

  4. Klicken Sie auf Erstellen.

Optionen für die Häufigkeit des Zeitplans

Wählen Sie die Häufigkeit basierend auf dem Logvolumen und den Latenzanforderungen aus:

Häufigkeit Cron-Ausdruck Anwendungsfall
Alle 5 Minuten */5 * * * * Hohes Volumen, niedrige Latenz
Alle 15 Minuten */15 * * * * Mittleres Suchvolumen
Stündlich 0 * * * * Standard (empfohlen)
Alle 6 Stunden 0 */6 * * * Geringes Volumen, Batchverarbeitung
Täglich 0 0 * * * Erhebung von Verlaufsdaten

Integration testen

  1. Suchen Sie in der Cloud Scheduler-Konsole nach Ihrem Job (forgerock-logs-collector-hourly).
  2. Klicken Sie auf Force run (Ausführung erzwingen), um den Job manuell auszulösen.
  3. Warten Sie einige Sekunden.
  4. Rufen Sie Cloud Run > Dienste auf.
  5. Klicken Sie auf forgerock-logs-collector.
  6. Klicken Sie auf den Tab Logs.

  7. Prüfen Sie, ob die Funktion erfolgreich ausgeführt wurde. Darauf sollten Sie achten:

    Fetching logs from YYYY-MM-DDTHH:MM:SS+00:00 to YYYY-MM-DDTHH:MM:SS+00:00
Source 'am-authentication': X records
Source 'am-access': X records
Wrote X records to gs://forgerock-identity-cloud-logs/forgerock-logs/logs_YYYYMMDD_HHMMSS.ndjson
Successfully processed X records

  8. Rufen Sie Cloud Storage > Buckets auf.

  9. Klicken Sie auf den Namen Ihres Buckets (forgerock-identity-cloud-logs).

  10. Rufen Sie den Ordner forgerock-logs/ auf.

  11. Prüfen Sie, ob eine neue .ndjson-Datei mit dem aktuellen Zeitstempel erstellt wurde.

Wenn Sie Fehler in den Logs sehen:

  • HTTP 401: Prüfen Sie den Log API-Schlüssel und das Secret in den Umgebungsvariablen.
  • HTTP 403: Prüfen Sie, ob der API-Schlüssel in PingOne Advanced Identity Cloud widerrufen wurde.
  • HTTP 429: Ratenbegrenzung (60 Anfragen pro Minute und Umgebung) – die Funktion wird automatisch mit Backoff wiederholt.
  • Fehlende Umgebungsvariablen: Prüfen Sie, ob alle erforderlichen Variablen festgelegt sind.

Google SecOps-Dienstkonto abrufen

Google SecOps verwendet ein eindeutiges Dienstkonto, um Daten aus Ihrem GCS-Bucket zu lesen. Sie müssen diesem Dienstkonto Zugriff auf Ihren Bucket gewähren.

E-Mail-Adresse des Dienstkontos abrufen

  1. Rufen Sie die SIEM-Einstellungen > Feeds auf.
  2. Klicken Sie auf Neuen Feed hinzufügen.
  3. Klicken Sie auf Einzelnen Feed konfigurieren.
  4. Geben Sie im Feld Feedname einen Namen für den Feed ein, z. B. ForgeRock Identity Cloud Logs.
  5. Wählen Sie Google Cloud Storage V2 als Quelltyp aus.
  6. Wählen Sie ForgeRock Identity Cloud als Logtyp aus.

  7. Klicken Sie auf Dienstkonto abrufen. Es wird eine eindeutige E-Mail-Adresse für das Dienstkonto angezeigt, z. B.:

    chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com

  8. Kopieren Sie diese E-Mail-Adresse für den nächsten Schritt.

  9. Klicken Sie auf Weiter.

  10. Geben Sie Werte für die folgenden Eingabeparameter an:

    • Storage-Bucket-URL: Geben Sie den GCS-Bucket-URI mit dem Präfixpfad ein:

      gs://forgerock-identity-cloud-logs/forgerock-logs/

    • Option zum Löschen der Quelle: Wählen Sie die gewünschte Löschoption aus:

      • Nie: Es werden nach Übertragungen nie Dateien gelöscht (empfohlen für Tests).
      • Übertragene Dateien löschen: Dateien werden nach der erfolgreichen Übertragung gelöscht.
      • Übertragene Dateien und leere Verzeichnisse löschen: Dateien und leere Verzeichnisse werden nach der erfolgreichen Übertragung gelöscht.

    • Maximales Dateialter: Dateien einschließen, die in den letzten Tagen geändert wurden (Standardwert: 180 Tage).

    • Asset-Namespace: Der Asset-Namespace.

    • Aufnahmelabels: Das Label, das auf die Ereignisse aus diesem Feed angewendet werden soll.

  11. Klicken Sie auf Weiter.

  12. Prüfen Sie die neue Feedkonfiguration auf dem Bildschirm Abschließen und klicken Sie dann auf Senden.

Dem Google SecOps-Dienstkonto IAM-Berechtigungen gewähren

Das Google SecOps-Dienstkonto benötigt die Rolle Storage-Objekt-Betrachter für Ihren GCS-Bucket.

  1. Rufen Sie Cloud Storage > Buckets auf.
  2. Klicken Sie auf den Namen Ihres Buckets (forgerock-identity-cloud-logs).
  3. Wechseln Sie zum Tab Berechtigungen.
  4. Klicken Sie auf Zugriff erlauben.
  5. Geben Sie die folgenden Konfigurationsdetails an:
    • Hauptkonten hinzufügen: Fügen Sie die E‑Mail-Adresse des Google SecOps-Dienstkontos ein.
    • Rollen zuweisen: Wählen Sie Storage-Objekt-Betrachter aus.

  6. Klicken Sie auf Speichern.

UDM-Zuordnungstabelle

Logfeld UDM-Zuordnung Logik
aav_label additional.fields Zusammengeführt
detail_label additional.fields Zusammengeführt
id_label additional.fields Zusammengeführt
objectId_label additional.fields Zusammengeführt
secure_label additional.fields Zusammengeführt
source_label additional.fields Zusammengeführt
topic_label additional.fields Zusammengeführt
trackingId_list additional.fields Zusammengeführt
transactionId_label additional.fields Zusammengeführt
extensions extensions Umbenannt/zugeordnet
metadata metadata Umbenannt/zugeordnet
payload.eventName metadata.product_event_type Direkt zugeordnet
network network Umbenannt/zugeordnet
x-forwarded-proto network.application_protocol Direkt zugeordnet
payload.http.request.method network.http.method Direkt zugeordnet
value network.http.response_code Umbenannt/zugeordnet
user-agent network.http.user_agent Direkt zugeordnet
principal principal Umbenannt/zugeordnet
host principal.asset.hostname Direkt zugeordnet
payload.client.ip principal.asset.ip Zusammengeführt
xip principal.asset.ip Zusammengeführt
host principal.hostname Direkt zugeordnet
entry.info.ipAddress principal.ip Zusammengeführt
payload.client.ip principal.ip Zusammengeführt
xip principal.ip Zusammengeführt
payload.client.port principal.port Umbenannt/zugeordnet
user_distinguished_name principal.user.attribute.labels Zusammengeführt
payload.userId principal.user.userid Direkt zugeordnet
userId principal.user.userid Direkt zugeordnet
Security_Result security_result Zusammengeführt
target target Umbenannt/zugeordnet
payload.applicationPrincipal.0 target.application Direkt zugeordnet
app_label target.resource.attribute.labels Zusammengeführt
realm_label target.resource.attribute.labels Zusammengeführt
payload.component target.resource.name Direkt zugeordnet
payload.http.request.path target.url Direkt zugeordnet
– additional.fields Konstante: topic_label
– extensions.auth.type Konstante: AUTHTYPE_UNSPECIFIED
– metadata.event_type Konstante: USER_LOGIN
– principal.asset.ip Konstante: payload.client.ip
– principal.ip Konstante: payload.client.ip
– principal.user.attribute.labels Konstante: user_distinguished_name
– security_result Konstante: Security_Result
– target.resource.attribute.labels Konstante: app_label
source_cloud event.idm.read_only_udm.additional.fields Aus dem Änderungsprotokoll zugeordnet
type event.idm.read_only_udm.additional.fields Aus dem Änderungsprotokoll zugeordnet
entry_info_nodeExtraLogging_auditInfo_Timestamp event.idm.read_only_udm.additional.fields Aus dem Änderungsprotokoll zugeordnet
entry_info_nodeOutcome event.idm.read_only_udm.additional.fields Aus dem Änderungsprotokoll zugeordnet
entry_info_authLevel event.idm.read_only_udm.additional.fields Aus dem Änderungsprotokoll zugeordnet
entry_info_nodeExtraLogging_auditInfo_clientId event.idm.read_only_udm.principal.application Aus dem Änderungsprotokoll zugeordnet
entry_info_nodeExtraLogging_auditInfo_EventName event.idm.read_only_udm.security_result.detection_fields Aus dem Änderungsprotokoll zugeordnet
entry_info_nodeExtraLogging_auditInfo_FlowType event.idm.read_only_udm.security_result.detection_fields Aus dem Änderungsprotokoll zugeordnet
entry_info_displayName event.idm.read_only_udm.security_result.detection_fields Aus dem Änderungsprotokoll zugeordnet
entry_info_nodeType event.idm.read_only_udm.security_result.detection_fields Aus dem Änderungsprotokoll zugeordnet
entry_info_nodeExtraLogging_auditInfo_Status event.idm.read_only_udm.security_result.action Aus dem Änderungsprotokoll zugeordnet
entry_info_nodeExtraLogging_auditInfo_TransactionId event.idm.read_only_udm.metadata.product_log_id Aus dem Änderungsprotokoll zugeordnet
entry_info_nodeId event.idm.read_only_udm.principal.user.userid Aus dem Änderungsprotokoll zugeordnet
entry_info_treeName event.idm.read_only_udm.security_result.description Aus dem Änderungsprotokoll zugeordnet
tenant_url event.idm.read_only_udm.principal.url Aus dem Änderungsprotokoll zugeordnet
payload.client.ip event.idm.read_only_udm.principal.ip und event.idm.read_only_udm.principal.asset.ip Aus dem Änderungsprotokoll zugeordnet
payload.http.request.headers.x-forwarded-for event.idm.read_only_udm.principal.ip und event.idm.read_only_udm.principal.asset.ip Aus dem Änderungsprotokoll zugeordnet
payload.client.port event.idm.read_only_udm.principal.port Aus dem Änderungsprotokoll zugeordnet
payload.http.request.method event.idm.read_only_udm.network.http.request.method Aus dem Änderungsprotokoll zugeordnet
payload.http.request.path event.idm.read_only_udm.target.url Aus dem Änderungsprotokoll zugeordnet
payload.topic event.idm.read_only_udm.additional.fields Aus dem Änderungsprotokoll zugeordnet
payload.http.request.headers.accept-api-version event.idm.read_only_udm.additional.fields Aus dem Änderungsprotokoll zugeordnet
payload.http.request.secure event.idm.read_only_udm.additional.fields Aus dem Änderungsprotokoll zugeordnet
payload.request.detail event.idm.read_only_udm.additional.fields Aus dem Änderungsprotokoll zugeordnet
payload.response event.idm.read_only_udm.additional.fields Aus dem Änderungsprotokoll zugeordnet
payload.request event.idm.read_only_udm.additional.fields Aus dem Änderungsprotokoll zugeordnet
payload.trackingIds event.idm.read_only_udm.additional.fields Aus dem Änderungsprotokoll zugeordnet
payload.objectId event.idm.read_only_udm.additional.fields Aus dem Änderungsprotokoll zugeordnet
payload.http.request.headers.user-agent event.idm.read_only_udm.network.http.user_agent Aus dem Änderungsprotokoll zugeordnet
payload.http.request.headers.host event.idm.read_only_udm.principal.hostname und event.idm.read_only_udm.principal.asset.hostname Aus dem Änderungsprotokoll zugeordnet
payload.http.request.headers.x-forwarded-proto event.idm.read_only_udm.network.application_protocol Aus dem Änderungsprotokoll zugeordnet
payload.response.statusCode event.idm.read_only_udm.network.http.response_code Aus dem Änderungsprotokoll zugeordnet
payload.operation event.idm.read_only_udm.security_result.action_details Aus dem Änderungsprotokoll zugeordnet

Änderungsprotokoll

Änderungsprotokoll für diesen Parser ansehen

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