Bitbucket

Créer un utilisateur dédié pour Corgea (facultatif)

Bien que ce ne soit pas obligatoire, nous recommandons de créer un compte utilisateur Bitbucket dédié à l’intégration Corgea. Cela permet de distinguer les actions automatisées de Corgea de l’activité de votre compte personnel et d’en améliorer la traçabilité.

Générer un token d’accès à l’API

Accédez à la page des tokens d’API Atlassian, puis cliquez sur « Create API token with scopes ».

Les tokens d’API sont différents des tokens d’espace de travail. Les tokens d’API sont associés à votre compte utilisateur Atlassian. Vous pouvez générer et gérer vos tokens d’API personnels depuis le lien ci-dessus.

Donnez un nom explicite à votre token et fixez sa date d’expiration à un an. Le token restera ainsi valide suffisamment longtemps, dans le respect des bonnes pratiques de sécurité.

Sélectionnez Bitbucket dans la liste des applications pour accorder à ce token un accès à Bitbucket.

Configurez les scopes requis pour l’intégration Corgea. Activez les scopes suivants :

• Repositories: “read:repository:bitbucket”, “write:repository:bitbucket”
• Pull requests: “read:pullrequest:bitbucket”, “write:pullrequest:bitbucket”
• Webhooks: “read:webhook:bitbucket”, “write:webhook:bitbucket”, “delete:webhook:bitbucket”
• General Info: “read:user:bitbucket”, “read:workspace:bitbucket”

Vérifiez votre configuration, puis cliquez sur « Create token » pour générer le token d’accès.

Une fois le token créé, cliquez sur le bouton de copie pour en copier la valeur. Vous en aurez besoin à l’étape suivante et il ne sera plus affiché.

Configurer l’intégration Bitbucket dans Corgea

Accédez à votre tableau de bord Corgea sur corgea.app ou {your-instance}.corgea.app, puis ouvrez la page Intégrations depuis la barre latérale ou le lien correspondant.

Dans la section « Intégrations de dépôts de code », repérez Bitbucket et cliquez sur l’icône plus (+) pour créer une intégration.

Complétez le formulaire d’intégration avec les informations suivantes :

• Slug d’espace de travail : identifiant de votre espace de travail Bitbucket
• Adresse e-mail : adresse associée au compte Bitbucket utilisé pour générer le token d’API
• Token d’accès : token d’API copié à l’étape précédente
• Nom de l’intégration (facultatif) : nom personnalisé permettant d’identifier cette intégration si vous gérez plusieurs espaces de travail Bitbucket

Corgea valide automatiquement vos identifiants. Si une information est incorrecte, vous recevrez un message d’erreur avec des détails sur ce qui doit être corrigé.

Une fois la validation réussie, un message confirme que l’intégration est terminée. Les webhooks étant configurés automatiquement, aucune configuration manuelle n’est nécessaire. Vous pouvez consulter les détails de l’intégration, notamment le statut du webhook, depuis la page des intégrations.