# Bitbucket Premium: PRゲーティングのセットアップ

{% hint style="warning" %}
この設定は **Bitbucket Premium**.

次の場合に使用します: ～を介して認証したいとき **Workspace Access Token**。また、マージ前の必須チェック（PRゲーティング）もサポートします。

もしご利用中のプランが **Bitbucket Free または Standard**の場合は、 [**ユーザーベースの設定**](https://help.aikidogov.us/docs/docs-ja/pr-and-release-gating/bitbucket-pr-gating/bitbucket-ci-pr-gating-via-aikido-dashboard) の代わりに。
{% endhint %}

## Bitbucket PR Scanning を設定する <a href="#setting-up-bitbucket-ci" id="setting-up-bitbucket-ci"></a>

{% stepper %}
{% step %}
**Workspace Access Token を作成する**

Bitbucket で、次へ移動します: `ワークスペース設定 > アクセストークン`.

選択します **アクセス トークンを作成**.

<div data-with-frame="true"><figure><img src="https://help.aikidogov.us/_assets/eea2698ecec1/Screenshot-2026-02-27-at-11.50.37.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**適切なアクセス権を付与する**

トークンに名前を付けます（例: `AikidoSec`）。ローテーション ポリシーに合った有効期限を設定します。

次のスコープを有効にします:

* **リポジトリ:** 読み取りと書き込み
* **プルリクエスト:** 読み取りと書き込み
* **Webhook:** 読み取りと書き込み
* **Pipelines:** 読み取りと書き込み

<div data-with-frame="true"><figure><img src="https://help.aikidogov.us/_assets/914ca036e390/Screenshot-2026-02-27-at-12.25.21.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**アクセストークンをコピーする**

生成されたトークンをコピーし、手順5に貼り付けます。

トークンは一度しか表示されません。後から取得することはできません。

<div data-with-frame="true"><figure><img src="https://help.aikidogov.us/_assets/5f8b48a49a6d/Screenshot-2026-02-27-at-12.06.22.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**連携を有効にする**

Aikido で、次を開きます: [連携](https://app.aikido.dev/settings/integrations?section=ci) ページ。次に、 **Bitbucket** 以下の **PR Quality Gating**.

<div data-with-frame="true"><figure><img src="https://help.aikidogov.us/_assets/219759fae373/Screenshot-2026-02-26-at-16.57.41.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Aikido にトークンを追加する**

Workspace Access Token を Aikido に貼り付けます。Aikido がトークンとその権限を検証します。

<div data-with-frame="true"><figure><img src="https://help.aikidogov.us/_assets/01f806d9906e/Screenshot-2026-02-27-at-12.07.45.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**最初のリポジトリを設定する**

認証後、Aikido は次を開きます: [Bitbucket PR Checks](https://app.aikido.dev/settings/integrations/bitbucket/checks) ページ上で使用します。

まずは **1つのリポジトリ** を最初に設定します。全体に展開する前に、すべてが正しく動作することを確認してください。

<div data-with-frame="true"><figure><img src="https://help.aikidogov.us/_assets/66a4bbd364db/Screenshot-2026-02-26-at-17.02.36.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**新しいPRで確認する**

設定したリポジトリで新しいPRを開きます。次に、チェックが実行されることを確認します。

<div data-with-frame="true"><figure><img src="https://help.aikidogov.us/_assets/3d84077d0b74/Screenshot-2026-02-26-at-18.04.55.png" alt=""><figcaption></figcaption></figure></div>

コメントとチェックの更新は、Workspace Access Token のIDとして表示されるはずです（例: `AikidoSec`).

<figure><img src="https://help.aikidogov.us/_assets/d13349ff06d5/Screenshot-2026-02-26-at-18.09.19.png" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**マージチェックとしてスキャンを必須にする**

スキャンが成功するまでマージをブロックしたい場合は、 **必須チェック** を Bitbucket で設定します。

Bitbucket で、次へ移動します: `リポジトリ設定 > ワークフロー > ブランチ制限`。対象ブランチの制限を追加または更新します（例: `main`).

Atlassian の参考情報: [マージ前にチェックを提案または必須にする](https://support.atlassian.com/bitbucket-cloud/docs/suggest-or-require-checks-before-a-merge/).
{% endstep %}

{% step %}
**すべてのリポジトリで有効にする**

結果に満足したら、 [Bitbucket PR Checks](https://app.aikido.dev/settings/integrations/bitbucket/checks) ページに戻り、残りのリポジトリでチェックを有効にします。

<div data-with-frame="true"><figure><img src="https://help.aikidogov.us/_assets/879185d4678a/Screenshot-2026-02-26-at-18.13.59.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**新しいリポジトリのデフォルトを設定する**

右上で、次を開きます: `アクション` and select `新しいリポジトリのデフォルトを設定`.

参照 [新しいリポジトリに対するデフォルトのPR/MRゲーティング設定](https://help.aikidogov.us/docs/docs-ja/pr-and-release-gating/aikido-ci-gating-functionality/default-pr-mr-gating-configuration-for-new-repositories) UI の案内はこちら。
{% endstep %}
{% endstepper %}