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

> CorgeaとのBitbucket構成に関する包括的なガイド

CorgeaとのBitbucket連携により、Corgeaプラットフォームから直接プロジェクトをスキャンし、コード修正のためのプルリクエストを作成できます。

<Steps>
  <Step title="Corgea用の専用ユーザーを作成（任意）">
    必須ではありませんが、Corgeaと連携するために専用のBitbucketユーザーアカウントを作成することをお勧めします。これにより、Corgeaの自動操作とあなたの個人アカウント活動を区別し、監査しやすくなります。

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

  <Step title="APIアクセストークンを生成する">
    <a href="https://id.atlassian.com/manage-profile/security/api-tokens" target="_blank">Atlassian APIトークンのページ</a>に移動し、「スコープ付きのAPIトークンを作成」をクリックして開始してください。

    <Warning>
      **APIトークンはワークスペーストークンとは異なります。** APIトークンはあなたのAtlassianユーザーアカウントに関連付けられています。上記のリンクから個人のAPIトークンを生成・管理できます。
    </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トークンを作成" width="904" height="333" data-path="images/bitbucket_create_access_token.png" />
    </Frame>

    トークンの説明的な名前を付け、有効期限を今日から1年に設定してください。これにより、トークンは長期間有効でありながらセキュリティのベストプラクティスを維持できます。

    <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="トークン名と有効期限" width="813" height="839" data-path="images/bitbucket_token_name.png" />
    </Frame>

    アプリケーションリストから**Bitbucket**を選択し、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="アプリ Bitbucket 選択" width="789" height="673" data-path="images/bitbucket_app_selection.png" />
    </Frame>

    Corgeaとの統合に必要なスコープを設定してください。以下のスコープを有効にしてください:

    <div class="alert alert-info" role="alert">
      <strong>必要なスコープ:</strong>

      <ul class="mb-0 mt-2">
        <li><code>リポジトリ:「read:repository:bitbucket」、 「write:repository:bitbucket」</code></li>
        <li><code>プルリクエスト:「read:pullrequest:bitbucket」、 「write:pullrequest:bitbucket」</code></li>
        <li><code>Webhooks: 「read:webhook:bitbucket」, 「write:webhook:bitbucket」, 「delete:webhook:bitbucket」</code></li>
        <li><code>一般情報:「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="トークンスコープ" width="1022" height="787" data-path="images/bitbucket_token_scopes.png" />
    </Frame>

    設定を確認し、「トークン作成」をクリックしてアクセストークンを生成してください。

    <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="トークン作成" width="781" height="866" data-path="images/bitbucket_create_token.png" />
    </Frame>

    トークンが作成された後、コピーボタンをクリックしてトークンの値をコピーします。次のステップでこのトークンが必要で、今後表示されません。

    <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="コピートークン" width="691" height="798" data-path="images/bitbucket_copy_token.png" />
    </Frame>
  </Step>

  <Step title="Corgeaで統合Bitbucket設定">
    `corgea.app`または`{your-instance}.corgea.app`でCorgeaのダッシュボードにアクセスし、サイドバーまたは統合リンクから統合ページに移動します。

    <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 統合ページ" width="1897" height="840" data-path="images/bitbucket_integration_page.png" />
    </Frame>

    「Code Repository Integrations」セクションでBitbucketを探し、プラス(+)アイコンをクリックすると新しい統合が作成されます。

    <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="新しい統合" width="1675" height="457" data-path="images/bitbucket_new_integration.png" />
    </Frame>

    以下の情報を添えて統合フォームに記入してください:

    * **ワークスペーススラッグ**:あなたのBitbucketワークスペース識別子
    * **メールアドレス**:APIトークンを生成するために使われたBitbucketアカウントに関連付けられたメールアドレス
    * **アクセストークン**:前ステップでコピーしたAPIトークン
    * **統合名** (任意):複数の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="Create Integration Modal" width="835" height="701" data-path="images/bitbucket_create_modal.png" />
    </Frame>

    Corgeaは認証情報を自動的に検証します。情報に誤りがあれば、修正が必要な項目を含むエラーメッセージが表示されます。

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

    検証に成功すると、統合完了の確認メッセージが表示されます。Webhookはこのプロセス中に自動的に設定されるため、手動のWebhook設定は不要です。統合の詳細やWebhookの状態は、統合ページから確認できます。

    <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="成功メッセージ" width="1700" height="629" data-path="images/bitbucket_success_message.png" />
    </Frame>
  </Step>
</Steps>
