Bitbucket

Corgea用の専用ユーザーを作成（任意）

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

APIトークンを発行するBitbucketアカウントは、ワークスペースの管理者である必要があります。Webhookのスコープには管理者権限が必要で、ユーザーは自身が持っている権限だけをトークンに付与できます。Corgea専用ユーザーを作成する場合は、先にそのユーザーをワークスペースの管理者にしてください。そうでない場合は、既存のワークスペース管理者アカウントでトークンを発行してください。

APIアクセストークンを生成する

Atlassian APIトークンのページに移動し、「スコープ付きのAPIトークンを作成」をクリックして開始してください。

APIトークンはワークスペーストークンとは異なります。 APIトークンはあなたのAtlassianユーザーアカウントに関連付けられています。上記のリンクから個人のAPIトークンを生成・管理できます。このトークンはワークスペースの管理者として発行してください。Bitbucketでは、アカウントにWebhookを管理する権限がある場合にのみ、Webhookのスコープを付与できます。

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

アプリケーションリストからBitbucketを選択し、Bitbucketにこのトークンへのアクセスを許可します。

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

• リポジトリ:「read:repository:bitbucket」、 「write:repository:bitbucket」
• プルリクエスト:「read:pullrequest:bitbucket」、 「write:pullrequest:bitbucket」
• Webhooks: 「read:webhook:bitbucket」, 「write:webhook:bitbucket」, 「delete:webhook:bitbucket」
• 一般情報:「read:user:bitbucket」、 「read:workspace:bitbucket」

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

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

Corgeaで統合Bitbucket設定

corgea.appまたは{your-instance}.corgea.appでCorgeaのダッシュボードにアクセスし、Settings → Automation → Integrations を開きます。

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

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

• ワークスペーススラッグ:あなたのBitbucketワークスペース識別子
• メールアドレス:APIトークンを生成するために使われたBitbucketアカウントに関連付けられたメールアドレス
• アクセストークン:前ステップでコピーしたAPIトークン
• 統合名 (任意):複数のBitbucketワークスペースを管理する場合にこの統合を識別するためのカスタム名前

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

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