> ## 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

> Umfassender Leitfaden zur Konfiguration von Bitbucket mit Corgea

Die Bitbucket-Integration mit Corgea ermöglicht es Ihnen, Projekte zu scannen und Pull Requests für Codekorrekturen direkt von der Corgea-Plattform aus zu erstellen.

<Steps>
  <Step title="Eigenen Benutzer für Corgea erstellen (optional)">
    Wir empfehlen, für die Corgea-Integration ein eigenes Bitbucket-Benutzerkonto zu erstellen. Dies ist zwar nicht erforderlich, trennt die automatisierten Aktionen von Corgea aber von den Aktivitäten Ihres persönlichen Kontos und verbessert die Nachvollziehbarkeit.

    <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="Bitbucket-Benutzer erstellen" width="1916" height="864" data-path="images/bitbucket_user.png" />
    </Frame>
  </Step>

  <Step title="API-Zugriffstoken erstellen">
    Öffnen Sie die Seite <a href="https://id.atlassian.com/manage-profile/security/api-tokens" target="_blank">Atlassian API Tokens</a> und klicken Sie auf "Create API token with scopes".

    <Warning>
      **API-Tokens sind nicht dasselbe wie Workspace-Tokens.** API-Tokens sind mit Ihrem Atlassian-Benutzerkonto verknüpft. Sie können Ihre persönlichen API-Tokens über den oben angegebenen Link erstellen und verwalten.
    </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="API-Token erstellen" width="904" height="333" data-path="images/bitbucket_create_access_token.png" />
    </Frame>

    Geben Sie einen aussagekräftigen Namen für Ihr Token an und legen Sie das Ablaufdatum auf ein Jahr ab dem aktuellen Datum fest. So bleibt das Token über einen längeren Zeitraum gültig, ohne gängige Security Best Practices zu vernachlässigen.

    <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="Token-Name und Ablauf" width="813" height="839" data-path="images/bitbucket_token_name.png" />
    </Frame>

    Wählen Sie in der Anwendungsliste **Bitbucket**, um dem Token Zugriff auf Bitbucket zu gewähren.

    <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="Bitbucket-App auswählen" width="789" height="673" data-path="images/bitbucket_app_selection.png" />
    </Frame>

    Konfigurieren Sie die für die Corgea-Integration erforderlichen Scopes:

    <div class="alert alert-info" role="alert">
      <strong>Erforderliche Scopes:</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="Token-Bereiche" width="1022" height="787" data-path="images/bitbucket_token_scopes.png" />
    </Frame>

    Prüfen Sie Ihre Konfiguration und klicken Sie auf "Create token", um das Zugriffstoken zu erstellen.

    <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="Token erstellen" width="781" height="866" data-path="images/bitbucket_create_token.png" />
    </Frame>

    Klicken Sie nach dem Erstellen auf die Kopierschaltfläche, um den Tokenwert zu kopieren. Sie benötigen das Token im nächsten Schritt; es wird später nicht erneut angezeigt.

    <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="Token kopieren" width="691" height="798" data-path="images/bitbucket_copy_token.png" />
    </Frame>
  </Step>

  <Step title="Bitbucket-Integration in Corgea konfigurieren">
    Öffnen Sie Ihr Corgea-Dashboard unter `corgea.app` oder `{your-instance}.corgea.app` und wechseln Sie über die Seitenleiste oder den Integrationslink zur Seite "Integrations".

    <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="Corgea Integrationsseite" width="1897" height="840" data-path="images/bitbucket_integration_page.png" />
    </Frame>

    Suchen Sie im Abschnitt "Code Repository Integrations" nach Bitbucket und klicken Sie auf das Pluszeichen (+), um eine neue Integration zu erstellen.

    <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="Neue Integration" width="1675" height="457" data-path="images/bitbucket_new_integration.png" />
    </Frame>

    Füllen Sie das Integrationsformular mit folgenden Angaben aus:

    * **Workspace-Slug**: Ihre Bitbucket-Workspace-Kennung
    * **E-Mail-Adresse**: Die E-Mail-Adresse, die mit dem Bitbucket-Konto verknüpft ist, das zum Erstellen des API-Tokens verwendet wird
    * **Zugriffstoken**: Das API-Token, das Sie im vorherigen Schritt kopiert haben
    * **Integrationsname** (optional): Ein benutzerdefinierter Name, um diese Integration zu identifizieren, falls Sie mehrere Bitbucket-Workspaces verwalten

    <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="Integration erstellen Modal" width="835" height="701" data-path="images/bitbucket_create_modal.png" />
    </Frame>

    Corgea validiert Ihre Zugangsdaten automatisch. Bei fehlerhaften Angaben erhalten Sie eine Fehlermeldung mit Hinweisen zur Korrektur.

    <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="Validierung" width="910" height="720" data-path="images/bitbucket_modal_validation.png" />
    </Frame>

    Nach erfolgreicher Validierung bestätigt eine Meldung, dass die Integration eingerichtet wurde. Die Webhooks werden dabei automatisch konfiguriert; eine manuelle Webhook-Einrichtung ist nicht erforderlich. Details zur Integration einschließlich des Webhook-Status finden Sie auf der Integrationsseite.

    <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="Erfolgsmeldung" width="1700" height="629" data-path="images/bitbucket_success_message.png" />
    </Frame>
  </Step>
</Steps>