> ## Documentation Index
> Fetch the complete documentation index at: https://docs.corgea.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Bitbucket

> Guide complet pour configurer Bitbucket avec Corgea

L’intégration de Bitbucket avec Corgea vous permet de scanner des projets et de créer des pull requests pour des correctifs de code directement depuis la plateforme Corgea.

<Steps>
  <Step title="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é.

    <Frame>
      <img src="https://mintcdn.com/corgea/1YT68j9GOThy2yLb/images/bitbucket_user.png?fit=max&auto=format&n=1YT68j9GOThy2yLb&q=85&s=e6294580d18378439c15ea8cc252d23a" style={{ borderRadius: '0.5rem' }} alt="Créer un utilisateur Bitbucket" width="1916" height="864" data-path="images/bitbucket_user.png" />
    </Frame>
  </Step>

  <Step title="Générer un token d’accès à l’API">
    Accédez à la <a href="https://id.atlassian.com/manage-profile/security/api-tokens" target="_blank">page des tokens d’API Atlassian</a>, puis cliquez sur « Create API token with scopes ».

    <Warning>
      **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.
    </Warning>

    <Frame>
      <img src="https://mintcdn.com/corgea/1YT68j9GOThy2yLb/images/bitbucket_create_access_token.png?fit=max&auto=format&n=1YT68j9GOThy2yLb&q=85&s=d2c2690dcd87c35b1651ece83f037c9f" style={{ borderRadius: '0.5rem' }} alt="Créer un token d’API" width="904" height="333" data-path="images/bitbucket_create_access_token.png" />
    </Frame>

    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é.

    <Frame>
      <img src="https://mintcdn.com/corgea/1YT68j9GOThy2yLb/images/bitbucket_token_name.png?fit=max&auto=format&n=1YT68j9GOThy2yLb&q=85&s=86506d715f1fbf86a5ef1ca858b4acc2" style={{ borderRadius: '0.5rem' }} alt="Nom et expiration du token" width="813" height="839" data-path="images/bitbucket_token_name.png" />
    </Frame>

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

    <Frame>
      <img src="https://mintcdn.com/corgea/1YT68j9GOThy2yLb/images/bitbucket_app_selection.png?fit=max&auto=format&n=1YT68j9GOThy2yLb&q=85&s=eed318e49348eea6d137a651c8b8238f" style={{ borderRadius: '0.5rem' }} alt="Sélectionnez l’application Bitbucket" width="789" height="673" data-path="images/bitbucket_app_selection.png" />
    </Frame>

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

    <div class="alert alert-info" role="alert">
      <strong>Scopes requis :</strong>

      <ul class="mb-0 mt-2">
        <li><code>Repositories: "read:repository:bitbucket", "write:repository:bitbucket"</code></li>
        <li><code>Pull requests: "read:pullrequest:bitbucket", "write:pullrequest:bitbucket"</code></li>
        <li><code>Webhooks: "read:webhook:bitbucket", "write:webhook:bitbucket", "delete:webhook:bitbucket"</code></li>
        <li><code>General Info: "read:user:bitbucket", "read:workspace:bitbucket"</code></li>
      </ul>
    </div>

    <Frame>
      <img src="https://mintcdn.com/corgea/1YT68j9GOThy2yLb/images/bitbucket_token_scopes.png?fit=max&auto=format&n=1YT68j9GOThy2yLb&q=85&s=c91333a78a6849ae68c22f5e412356c5" style={{ borderRadius: '0.5rem' }} alt="Scopes du token" width="1022" height="787" data-path="images/bitbucket_token_scopes.png" />
    </Frame>

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

    <Frame>
      <img src="https://mintcdn.com/corgea/1YT68j9GOThy2yLb/images/bitbucket_create_token.png?fit=max&auto=format&n=1YT68j9GOThy2yLb&q=85&s=391d9ebffbe9a06bbdcc1da964bbc0df" style={{ borderRadius: '0.5rem' }} alt="Créer un token" width="781" height="866" data-path="images/bitbucket_create_token.png" />
    </Frame>

    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é.

    <Frame>
      <img src="https://mintcdn.com/corgea/1YT68j9GOThy2yLb/images/bitbucket_copy_token.png?fit=max&auto=format&n=1YT68j9GOThy2yLb&q=85&s=56a741f0624cf8e64937ab63911f2fc3" style={{ borderRadius: '0.5rem' }} alt="Copier le token" width="691" height="798" data-path="images/bitbucket_copy_token.png" />
    </Frame>
  </Step>

  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/corgea/1YT68j9GOThy2yLb/images/bitbucket_integration_page.png?fit=max&auto=format&n=1YT68j9GOThy2yLb&q=85&s=bf73904b1aca7582ef3bb21b875a5df5" style={{ borderRadius: '0.5rem' }} alt="Page Intégrations Corgea" width="1897" height="840" data-path="images/bitbucket_integration_page.png" />
    </Frame>

    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.

    <Frame>
      <img src="https://mintcdn.com/corgea/1YT68j9GOThy2yLb/images/bitbucket_new_integration.png?fit=max&auto=format&n=1YT68j9GOThy2yLb&q=85&s=2540b183bd20606f310c7e707db71b67" style={{ borderRadius: '0.5rem' }} alt="Nouvelle intégration" width="1675" height="457" data-path="images/bitbucket_new_integration.png" />
    </Frame>

    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

    <Frame>
      <img src="https://mintcdn.com/corgea/1YT68j9GOThy2yLb/images/bitbucket_create_modal.png?fit=max&auto=format&n=1YT68j9GOThy2yLb&q=85&s=3c61d1f0340dddd0bd12f89eede8f529" style={{ borderRadius: '0.5rem' }} alt="Fenêtre de création d’une intégration" width="835" height="701" data-path="images/bitbucket_create_modal.png" />
    </Frame>

    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é.

    <Frame>
      <img src="https://mintcdn.com/corgea/1YT68j9GOThy2yLb/images/bitbucket_modal_validation.png?fit=max&auto=format&n=1YT68j9GOThy2yLb&q=85&s=a895ec1f7b3e0ccb9cfe3e0940e19bed" style={{ borderRadius: '0.5rem' }} alt="Validation" width="910" height="720" data-path="images/bitbucket_modal_validation.png" />
    </Frame>

    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.

    <Frame>
      <img src="https://mintcdn.com/corgea/1YT68j9GOThy2yLb/images/bitbucket_success_message.png?fit=max&auto=format&n=1YT68j9GOThy2yLb&q=85&s=bb62edb596c23ba63a62942e39112b4f" style={{ borderRadius: '0.5rem' }} alt="Message de réussite" width="1700" height="629" data-path="images/bitbucket_success_message.png" />
    </Frame>
  </Step>
</Steps>
