Atlassian Bitbucket-Logs erfassen
Parserversion: 2.0
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
- 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.
Bitbucket Webhook Logs. - Wählen Sie Webhook als Quelltyp aus.
- Wählen Sie Atlassian Bitbucket als Logtyp aus.
- Klicken Sie auf Weiter.
- 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.
- Trennzeichen für Aufteilung (optional): Geben Sie ein Trennzeichen ein, um mehrzeilige Ereignisse aufzuteilen. Häufige Werte:
- 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 in der Google Cloud Console die Seite „Anmeldedaten“ 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
- 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).
- 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 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.
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
- Melden Sie sich als Arbeitsbereichs- oder Repository-Administrator in Bitbucket Cloud an.
- Rufen Sie das Repository auf, in dem Sie den Webhook konfigurieren möchten.
- Gehen Sie zu Repository-Einstellungen > Webhooks.
- Klicken Sie auf Add webhook (Webhook hinzufügen).
- 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
- Titel: Geben Sie einen aussagekräftigen Namen ein (z. B.
- Klicken Sie auf Speichern.
Webhook in Bitbucket Data Center erstellen
- Melden Sie sich als Projekt- oder Repository-Administrator im Bitbucket Data Center an.
- Rufen Sie das Projekt oder Repository auf, in dem Sie den Webhook konfigurieren möchten.
- Rufen Sie Projekteinstellungen > Webhooks (für die Projektebene) oder Repository-Einstellungen > Webhooks (für die Repository-Ebene) auf.
- Klicken Sie auf Webhook erstellen.
- 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
- Name: Geben Sie einen aussagekräftigen Namen ein (z. B.
- Klicken Sie auf Speichern.
Webhook-Zustellung überprüfen
- Führen Sie nach dem Erstellen des Webhooks eine Aktion in Ihrem Repository aus, z. B. einen Commit per Push übertragen.
- Gehen Sie zu Repository-Einstellungen > Webhooks.
- Klicken Sie neben dem Webhook auf Anfragen ansehen.
- 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.
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:
- 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