Bitbucket API トークン

はじめに

Kody が Bitbucket Cloud で自動コードレビューを実行できるようにするには、API トークンを生成する必要があります。このトークンにより、Kody は以下に記載された特定の権限で、リポジトリ、プルリクエスト、Webhook、イシュー、パイプラインなどにアクセスできます。

Atlassian API トークンページを直接開きます（または、Atlassian プロフィールから Security → API tokens に移動します）。
Create API token with scopes をクリックします。
トークンに名前（例：kody_code_review）を付け、有効期限を設定します。
プロンプトが表示された場合は、アプリケーションとして Bitbucket を選択します。
必要なスコープをすべて選択します（以下参照）。
選択内容を確認し、Create token をクリックします。
トークンをすぐにコピーして安全に保存してください — 作成後に再度表示することはできません。

Kody との完全な機能のために、トークンには以下のすべてのスコープが含まれている必要があります：

スコープ	目的 / 有効にするもの
`read:user:bitbucket`	ユーザーまたはアカウントの基本情報を読み取る。
`read:workspace:bitbucket`	ワークスペースに関する情報（プロジェクト、メンバー、リポジトリ）を読み取る。
`read:project:bitbucket`	プロジェクトのメタデータを読み取る。
`read:repository:bitbucket`	リポジトリのコード、ブランチ、ソースファイルを読み取る。
`write:repository:bitbucket`	必要に応じてリポジトリのコンテンツを変更する（コメント、ファイルの更新など）。
`admin:repository:bitbucket`	リポジトリの管理操作：Webhook の管理、権限、リポジトリ設定。
`read:pullrequest:bitbucket`	プルリクエスト、そのステータス、コメントを表示する。
`write:pullrequest:bitbucket`	プルリクエストのコメントを作成または変更し、PR を承認、拒否、またはマージする。
`read:issue:bitbucket`	イシュートラッカー情報を読み取る。
`read:webhook:bitbucket`	既存の Webhook とその設定を表示する。
`write:webhook:bitbucket`	Webhook を作成または更新する。
`read:pipeline:bitbucket`	リポジトリまたは PR に関連するパイプラインのステータス/ログを読み取る。

⚠️ 必要な権限のみを付与してください。セキュリティリスクを減らすために、必要以上の権限を付与しないでください。

必要なすべてのスコープでトークンが生成されたら、Bitbucket 統合を有効にする際に Kody 統合 / 自動化設定画面に貼り付けます。
Kody が Webhook を設定したりプルリクエストイベントをリッスンする必要がある場合は、トークンに admin:repository:bitbucket（または同等のもの）があることを確認してください。

トークンは作成時に一度だけ表示されます。安全に保存してください。再度表示することはできません。
トークンの有効期間を制限するために、可能であれば有効期限を設定してください。
トークンが侵害された場合は、すぐに失効させて新しいトークンを作成してください。
トークンとそのスコープを定期的に監査し、まだ必要で有効であることを確認してください。
Bitbucket のプラン/アカウントが上記のすべてのスコープを許可しているか確認してください。一部のスコープ（プロジェクト、ワークスペース、管理者）はサブスクリプション/権限に依存する場合があります。