Atlassian Bitbucket-Logs erfassen

Parserversion: 2.0

Unterstützt in:

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

Atlassian Bitbucket ist ein Git-basierter Hosting-Dienst für Quellcode-Repositories. Es bietet Entwicklungsteams Code-Zusammenarbeit, Pull-Anfrage-Workflows und CI/CD-Pipelines. Bitbucket unterstützt sowohl Cloud- als auch selbst gehostete Bereitstellungen (Rechenzentrum).

Hinweis

Folgende Voraussetzungen müssen erfüllt sein:

  • Eine Google SecOps-Instanz
  • Eine Atlassian Bitbucket Cloud- oder Rechenzentrum-Instanz mit Administratorzugriff
  • Zugriff auf die Google Cloud Console (zum Erstellen von API-Schlüsseln)

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. Bitbucket Webhook Logs.
  5. Wählen Sie Webhook als Quelltyp aus.
  6. Wählen Sie Atlassian Bitbucket 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 ein Trennzeichen ein, um mehrzeilige Ereignisse aufzuteilen. Häufige Werte:
      • \n – Zeilenumbruch (am häufigsten für NDJSON)
      • Lassen Sie das Feld leer, wenn jede Anfrage ein einzelnes Ereignis enthält.
    • 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 in der Google Cloud Console die Seite „Anmeldedaten“ 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. Gehen Sie auf der Seite mit den Einstellungen für den API-Schlüssel so vor:
    • Name: Geben Sie einen aussagekräftigen Namen ein (z. B. 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 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.

Atlassian Bitbucket-Webhook konfigurieren

Webhook-URL erstellen

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

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

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

Webhook in Bitbucket Cloud erstellen

  1. Melden Sie sich als Arbeitsbereichs- oder Repository-Administrator in Bitbucket Cloud an.
  2. Rufen Sie das Repository auf, in dem Sie den Webhook konfigurieren möchten.
  3. Gehen Sie zu Repository-Einstellungen > Webhooks.
  4. Klicken Sie auf Add webhook (Webhook hinzufügen).
  5. Geben Sie die folgenden Konfigurationsdetails an:
    • Titel: Geben Sie einen aussagekräftigen Namen ein (z. B. SIEM Webhook).
    • URL: Fügen Sie die vollständige Endpunkt-URL mit dem API-Schlüssel und dem Secret von oben ein.
    • Status: Wählen Sie Aktiv aus.
    • Trigger: Wählen Sie Aus einer vollständigen Liste von Triggern auswählen und dann die zu sendenden Ereignisse aus:
      • Repository: Push, Fork, Commit Comment Created
      • Pull-Anfrage: Erstellt, aktualisiert, genehmigt, nicht genehmigt, zusammengeführt, abgelehnt, Kommentar erstellt
      • Problem: Erstellt, Aktualisiert, Kommentar erstellt
  6. Klicken Sie auf Speichern.

Webhook in Bitbucket Data Center erstellen

  1. Melden Sie sich als Projekt- oder Repository-Administrator im Bitbucket Data Center an.
  2. Rufen Sie das Projekt oder Repository auf, in dem Sie den Webhook konfigurieren möchten.
  3. Rufen Sie Projekteinstellungen > Webhooks (für die Projektebene) oder Repository-Einstellungen > Webhooks (für die Repository-Ebene) auf.
  4. Klicken Sie auf Webhook erstellen.
  5. Geben Sie die folgenden Konfigurationsdetails an:
    • Name: Geben Sie einen aussagekräftigen Namen ein (z. B. SIEM Webhook).
    • URL: Fügen Sie die vollständige Endpunkt-URL mit dem API-Schlüssel und dem Secret von oben ein.
    • Status: Wählen Sie Aktiv aus.
    • Ereignisse: Wählen Sie die Ereignisse aus, die weitergeleitet werden sollen:
      • Repository: Refs geändert, Fork, Kommentar hinzugefügt
      • Pull-Anfrage: Geöffnet, Quellzweig aktualisiert, Geändert, Prüfer aktualisiert, Genehmigt, Nicht genehmigt, Überarbeitung erforderlich, Zusammengeführt, Abgelehnt, Gelöscht, Kommentar hinzugefügt
  6. Klicken Sie auf Speichern.

Webhook-Zustellung überprüfen

  1. Führen Sie nach dem Erstellen des Webhooks eine Aktion in Ihrem Repository aus, z. B. einen Commit per Push übertragen.
  2. Gehen Sie zu Repository-Einstellungen > Webhooks.
  3. Klicken Sie neben dem Webhook auf Anfragen ansehen.
  4. Prüfen Sie, ob die Anfrage den Statuscode 200 für eine erfolgreiche Zustellung zurückgibt.

Weitere Informationen finden Sie in der Dokumentation zu Bitbucket Cloud-Webhooks oder in der Dokumentation zu Bitbucket Data Center-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:

  • In der URL sichtbare Anmeldedaten
  • 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)

Webhook-Limits und Best Practices

Anfragelimits

Limit Wert
Maximale Anfragegröße 4 MB
Maximale Abfragen pro Sekunde 15.000
Zeitlimit für Anfragen 30 Sekunden
Wiederholungsverhalten Automatisch mit exponentiellem Backoff

UDM-Zuordnungstabelle

Logfeld UDM-Zuordnung Logik
actor.display_name principal.user.user_display_name Wert aus dem Feld actor.display_name.
actor.nickname principal.user.userid Wert aus dem Feld actor.nickname.
actor.account_id principal.user.product_object_id Wert aus dem Feld actor.account_id.
actor.uuid principal.user.product_object_id Wert, der aus dem Feld actor.uuid übernommen wird, wenn actor.account_id nicht vorhanden ist.
actor.links.html.href principal.url Wert aus dem Feld actor.links.html.href.
repository.full_name target.resource.name Wert aus dem Feld repository.full_name.
repository.uuid target.resource.product_object_id Wert aus dem Feld repository.uuid.
repository.links.html.href target.url Wert aus dem Feld repository.links.html.href.
repository.project.key target.resource.attribute.labels Wird als Schlüssel/Wert-Paar mit dem Schlüssel „project_key“ hinzugefügt.
repository.project.name target.resource.attribute.labels Wird als Schlüssel/Wert-Paar mit dem Schlüssel „project_name“ hinzugefügt.
repository.workspace.slug target.resource.attribute.labels Wird als Schlüssel/Wert-Paar mit dem Schlüssel „workspace“ hinzugefügt.
push.changes[].new.name target.resource.attribute.labels Wird als Schlüssel/Wert-Paar mit dem Schlüssel „branch_name“ hinzugefügt.
push.changes[].new.target.hash target.resource.attribute.labels Wird als Schlüssel/Wert-Paar mit dem Schlüssel „commit_hash“ hinzugefügt.
push.changes[].new.target.message target.resource.attribute.labels Wird als Schlüssel/Wert-Paar mit dem Schlüssel „commit_message“ hinzugefügt.
push.changes[].new.target.date target.resource.attribute.labels Wird als Schlüssel/Wert-Paar mit dem Schlüssel „commit_date“ hinzugefügt.
push.changes[].new.target.author.raw target.user.email_addresses E-Mail-Adresse, die aus dem Rohfeld „author“ extrahiert wurde.
pullrequest.id target.resource.attribute.labels Wird als Schlüssel/Wert-Paar mit dem Schlüssel „pullrequest_id“ hinzugefügt.
pullrequest.title target.resource.attribute.labels Wird als Schlüssel/Wert-Paar mit dem Schlüssel „pullrequest_title“ hinzugefügt.
pullrequest.state target.resource.attribute.labels Wird als Schlüssel/Wert-Paar mit dem Schlüssel „pullrequest_state“ hinzugefügt.
pullrequest.author.display_name target.user.user_display_name Wert aus dem Feld pullrequest.author.display_name.
pullrequest.source.branch.name target.resource.attribute.labels Wird als Schlüssel/Wert-Paar mit dem Schlüssel „source_branch“ hinzugefügt.
pullrequest.destination.branch.name target.resource.attribute.labels Wird als Schlüssel/Wert-Paar mit dem Schlüssel „destination_branch“ hinzugefügt.
date metadata.event_timestamp Wird als ISO8601-Zeitstempel geparst. Wird als Ereigniszeitstempel verwendet, wenn in der Webhook-Nutzlast vorhanden.
metadata.event_type Legen Sie zuerst „GENERIC_EVENT“ fest. Wurde basierend auf dem Ereignisschlüssel und dem Vorhandensein von Hauptkonto- und Zielfeldern in „USER_RESOURCE_ACCESS“, „USER_RESOURCE_UPDATE_CONTENT“ oder „USER_UNCATEGORIZED“ geändert.
metadata.product_event_type Wird basierend auf dem Wert des Webhook-Headers X-Event-Key festgelegt (z. B. repo:push, pullrequest:created, pullrequest:updated).
metadata.product_name Legen Sie diesen Wert auf „Atlassian Bitbucket“ fest.
metadata.vendor_name Legen Sie diesen Wert auf „Atlassian“ fest.

Änderungsprotokoll

Änderungsprotokoll für diesen Parser ansehen

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