Collecter les journaux Atlassian Bitbucket
Version de l'analyseur : 2.0
Ce document explique comment configurer Atlassian Bitbucket pour envoyer des journaux à Google Security Operations à l'aide de webhooks.
Atlassian Bitbucket est un service d'hébergement de dépôts de code source basé sur Git. Il fournit des fonctionnalités de collaboration sur le code, des workflows de demande d'extraction et des pipelines CI/CD pour les équipes de développement. Bitbucket est compatible avec les déploiements cloud et auto-hébergés (Data Center).
Avant de commencer
Assurez-vous de remplir les conditions préalables suivantes :
- Une instance Google SecOps
- Une instance Atlassian Bitbucket Cloud ou Data Center avec un accès administrateur
- Accès à la console Google Cloud (pour la création de clés API)
Créer un flux de webhook dans Google SecOps
Créer le flux
- Accédez à Paramètres > Gestion des données > Flux. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Flux.
- Cliquez sur Ajouter un flux d'actualités.
- Sur la page suivante, cliquez sur Configurer un seul flux.
- Dans le champ Nom du flux, saisissez un nom pour le flux (par exemple,
Bitbucket Webhook Logs). - Sélectionnez Webhook comme type de source.
- Sélectionnez Atlassian Bitbucket comme Type de journal.
- Cliquez sur Suivant.
- Spécifiez les valeurs des paramètres d'entrée suivants :
- Délimiteur de division (facultatif) : saisissez un délimiteur pour diviser les événements multilignes. Valeurs courantes :
\n: délimiteur de saut de ligne (le plus courant pour NDJSON)- Laissez ce champ vide si chaque requête contient un seul événement.
- Espace de noms de l'élément : espace de noms de l'élément
- Étiquettes d'ingestion : étiquette à appliquer aux événements de ce flux
- Délimiteur de division (facultatif) : saisissez un délimiteur pour diviser les événements multilignes. Valeurs courantes :
- Cliquez sur Suivant.
- Vérifiez la configuration de votre nouveau flux sur l'écran Finaliser, puis cliquez sur Envoyer.
Générer et enregistrer une clé secrète
Après avoir créé le flux, vous devez générer une clé secrète pour l'authentification :
- Sur la page d'informations du flux, cliquez sur Générer une clé secrète.
- Une boîte de dialogue affiche la clé secrète.
- Copiez et enregistrez la clé secrète de manière sécurisée.
Obtenir l'URL du point de terminaison du flux
- Accédez à l'onglet Détails du flux.
- Dans la section Informations sur le point de terminaison, copiez l'URL du point de terminaison du flux.
Le format d'URL est le suivant :
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:importOù
{region}est la région de votre instance Google SecOps (par exemple,us,europeouasia-southeast1) et{parent}est le chemin d'accès à la ressource au formatprojects/<PROJECT_ID>/locations/<LOCATION>/instances/<INSTANCE_ID>/logTypes/<LOG_TYPE>.Enregistrez cette URL pour les étapes suivantes.
Cliquez sur OK.
Créer Google Cloud une clé API
Google SecOps nécessite une clé API pour l'authentification. Créez une clé API restreinte dans la console Google Cloud .
Créer la clé API
- Accédez à la page Identifiants de la consoleGoogle Cloud .
- Sélectionnez votre projet (celui associé à votre instance Google SecOps).
- Cliquez sur Créer des identifiants > Clé API.
- Une clé API est créée et s'affiche dans une boîte de dialogue.
- Cliquez sur Modifier la clé API pour restreindre la clé.
Restreindre la clé API
- Sur la page des paramètres de la clé API :
- Nom : saisissez un nom descriptif (par exemple,
Webhook API Key).
- Nom : saisissez un nom descriptif (par exemple,
- Sous Restrictions relatives aux API :
- Sélectionnez Restreindre la clé.
- Dans le menu déroulant Sélectionner des API, recherchez et sélectionnez API Google SecOps.
- Cliquez sur Enregistrer.
- Copiez la valeur de la clé API dans le champ Clé API en haut de la page.
Enregistrez la clé API de manière sécurisée.
Configurer le webhook Atlassian Bitbucket
Créer l'URL de webhook
Combinez l'URL du point de terminaison Google SecOps et la clé API :
<ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>Exemple :
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...
Créer un webhook dans Bitbucket Cloud
- Connectez-vous à Bitbucket Cloud en tant qu'administrateur d'espace de travail ou de dépôt.
- Accédez au dépôt dans lequel vous souhaitez configurer le webhook.
- Accédez à Repository settings > Webhooks (Paramètres du dépôt > Webhooks).
- Cliquez sur Add webhook (Ajouter un Webhook).
- Fournissez les informations de configuration suivantes :
- Titre : saisissez un nom descriptif (par exemple,
SIEM Webhook). - URL : collez l'URL complète du point de terminaison avec la clé API et le secret ci-dessus.
- État : sélectionnez Actif.
- Déclencheurs : sélectionnez Choisir dans une liste complète de déclencheurs, puis les événements à envoyer :
- Dépôt : Push, Fork, Commit Comment Created (Push, Fork, Commentaire de commit créé)
- Demande d'extraction : créée, mise à jour, approuvée, non approuvée, fusionnée, refusée, commentaire créé
- Problème : créé, mis à jour, commentaire créé
- Titre : saisissez un nom descriptif (par exemple,
- Cliquez sur Enregistrer.
Créer un webhook dans Bitbucket Data Center
- Connectez-vous à Bitbucket Data Center en tant qu'administrateur de projet ou de dépôt.
- Accédez au projet ou au dépôt dans lequel vous souhaitez configurer le webhook.
- Accédez à Paramètres du projet > Webhooks (pour le niveau du projet) ou à Paramètres du dépôt > Webhooks (pour le niveau du dépôt).
- Cliquez sur Créer un webhook.
- Fournissez les informations de configuration suivantes :
- Nom : saisissez un nom descriptif (par exemple,
SIEM Webhook). - URL : collez l'URL complète du point de terminaison avec la clé API et le secret ci-dessus.
- État : sélectionnez Actif.
- Événements : sélectionnez les événements à transférer :
- Dépôt : Refs changed, Fork, Comment added
- Demande d'extraction : ouverte, branche source mise à jour, modifiée, réviseur mis à jour, approuvée, non approuvée, nécessite du travail, fusionnée, refusée, supprimée, commentaire ajouté
- Nom : saisissez un nom descriptif (par exemple,
- Cliquez sur Enregistrer.
Vérifier la diffusion du webhook
- Après avoir créé le webhook, effectuez une action dans votre dépôt (par exemple, un commit push).
- Accédez à Repository settings > Webhooks (Paramètres du dépôt > Webhooks).
- Cliquez sur Afficher les requêtes à côté de votre webhook.
- Vérifiez que la requête affiche un code d'état 200, indiquant que la diffusion a réussi.
Pour en savoir plus, consultez la documentation sur les webhooks Bitbucket Cloud ou la documentation sur les webhooks Bitbucket Data Center.
Référence des méthodes d'authentification
Les flux de webhook Google SecOps sont compatibles avec plusieurs méthodes d'authentification. Choisissez la méthode compatible avec votre fournisseur.
Méthode 1 : En-têtes personnalisés (recommandé)
Si votre fournisseur accepte les en-têtes HTTP personnalisés, utilisez cette méthode pour une sécurité renforcée.
Format de la requête :
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" }Avantages :
- Clé API et code secret non visibles dans l'URL
- Plus sécurisé (les en-têtes ne sont pas enregistrés dans les journaux d'accès du serveur Web)
- Méthode privilégiée lorsque le fournisseur la prend en charge
Méthode 2 : Paramètres de requête
Si votre fournisseur n'accepte pas les en-têtes personnalisés, ajoutez les identifiants à l'URL.
Format d'URL :
<ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>Exemple :
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...Format de la requête :
POST <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY> HTTP/1.1 Content-Type: application/json { "event": "data", "timestamp": "2025-01-15T10:30:00Z" }
Inconvénients :
- Identifiants visibles dans l'URL
- Peut être consigné dans les journaux d'accès du serveur Web
- Moins sécurisé que les en-têtes
Méthode 3 : Hybride (URL + en-tête)
Certaines configurations utilisent une clé API dans l'URL et une clé secrète dans l'en-tête.
Format de la requête :
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" }
Noms des en-têtes d'authentification
Google SecOps accepte les noms d'en-tête suivants pour l'authentification :
Pour une clé API :
x-goog-chronicle-auth(recommandé)X-Goog-Chronicle-Auth(non sensible à la casse)
Pour la clé secrète :
x-chronicle-auth(recommandé)X-Chronicle-Auth(non sensible à la casse)
Limites et bonnes pratiques concernant les webhooks
Limites de requêtes
| Limite | Valeur |
|---|---|
| Taille maximale de la requête | 4 Mo |
| Nombre maximal de RPS (requêtes par seconde) | 15 000 |
| Délai avant expiration de la requête | 30 seconds |
| Comportement de nouvelle tentative | Automatique avec intervalle exponentiel entre les tentatives |
Table de mappage UDM
| Champ du journal | Mappage UDM | Logique |
|---|---|---|
actor.display_name |
principal.user.user_display_name |
Valeur extraite du champ actor.display_name. |
actor.nickname |
principal.user.userid |
Valeur extraite du champ actor.nickname. |
actor.account_id |
principal.user.product_object_id |
Valeur extraite du champ actor.account_id. |
actor.uuid |
principal.user.product_object_id |
Valeur extraite du champ actor.uuid lorsque actor.account_id n'est pas présent. |
actor.links.html.href |
principal.url |
Valeur extraite du champ actor.links.html.href. |
repository.full_name |
target.resource.name |
Valeur extraite du champ repository.full_name. |
repository.uuid |
target.resource.product_object_id |
Valeur extraite du champ repository.uuid. |
repository.links.html.href |
target.url |
Valeur extraite du champ repository.links.html.href. |
repository.project.key |
target.resource.attribute.labels |
Ajouté en tant que paire clé-valeur avec la clé "project_key". |
repository.project.name |
target.resource.attribute.labels |
Ajouté en tant que paire clé-valeur avec la clé "project_name". |
repository.workspace.slug |
target.resource.attribute.labels |
Ajouté en tant que paire clé-valeur avec la clé "workspace". |
push.changes[].new.name |
target.resource.attribute.labels |
Ajouté en tant que paire clé-valeur avec la clé "branch_name". |
push.changes[].new.target.hash |
target.resource.attribute.labels |
Ajouté en tant que paire clé-valeur avec la clé "commit_hash". |
push.changes[].new.target.message |
target.resource.attribute.labels |
Ajouté en tant que paire clé-valeur avec la clé "commit_message". |
push.changes[].new.target.date |
target.resource.attribute.labels |
Ajouté en tant que paire clé-valeur avec la clé "commit_date". |
push.changes[].new.target.author.raw |
target.user.email_addresses |
Adresse e-mail extraite du champ brut de l'auteur. |
pullrequest.id |
target.resource.attribute.labels |
Ajouté en tant que paire clé-valeur avec la clé "pullrequest_id". |
pullrequest.title |
target.resource.attribute.labels |
Ajouté en tant que paire clé-valeur avec la clé "pullrequest_title". |
pullrequest.state |
target.resource.attribute.labels |
Ajouté en tant que paire clé-valeur avec la clé "pullrequest_state". |
pullrequest.author.display_name |
target.user.user_display_name |
Valeur extraite du champ pullrequest.author.display_name. |
pullrequest.source.branch.name |
target.resource.attribute.labels |
Ajouté en tant que paire clé-valeur avec la clé "source_branch". |
pullrequest.destination.branch.name |
target.resource.attribute.labels |
Ajouté en tant que paire clé-valeur avec la clé "destination_branch". |
date |
metadata.event_timestamp |
Analysé en tant que code temporel ISO8601. Utilisé comme code temporel de l'événement lorsqu'il est présent dans la charge utile du webhook. |
metadata.event_type |
Définissez initialement sur "GENERIC_EVENT". Remplacé par "USER_RESOURCE_ACCESS", "USER_RESOURCE_UPDATE_CONTENT" ou "USER_UNCATEGORIZED" en fonction de la clé d'événement et de la présence des champs "principal" et "target". | |
metadata.product_event_type |
Définie en fonction de la valeur de l'en-tête de webhook X-Event-Key (par exemple, repo:push, pullrequest:created, pullrequest:updated). |
|
metadata.product_name |
Définissez cette option sur "Atlassian Bitbucket". | |
metadata.vendor_name |
Défini sur "Atlassian". |
Journal des modifications
Afficher le journal des modifications de cet analyseur
Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.