# Bitbucket Pipes: コード経由でプルリクエストのゲーティングを設定する
> この機能の使用はもう推奨しません。代わりに Aikido Dashboard での PR gating を使用してください。CI 分を消費せず、一括管理もしやすく、エラーも起こりにくいためです。
Aikido の Bitbucket Pipes との連携により、リスクの高いコードがマージされるのをフラグ付けしたりブロックしたりできます。私たちの CI スキャンの対象は **IaC**, **SAST**、および **依存関係の問題**.
Aikido の Bitbucket Pipes 用連携を使って、Bitbucket のワークフローに Aikido を統合しましょう。私たちの [Bitbucket Pipe のソースコードはこちらです。](https://bitbucket.org/aikido-production/bitbucket-pipe/src)
## 前提条件
### リポジトリで pipelines を有効にする
連携を有効にするには、まず Bitbucket で保護したいリポジトリで pipelines が有効になっていることを確認する必要があります。これを行うには、次の手順に従ってください：
1. Bitbucket アカウントにログインします
2. pipelines を有効にしたいリポジトリに移動します
3. 左側のナビゲーションで「Repository settings」をクリックします
4. 左側のナビゲーションを「Pipelines」セクションまでスクロールし、「Settings」をクリックします
5. pipelines を有効にする
### Aikido CI 連携トークンを取得する
次に、Aikido の CI 連携があなたの Aikido アカウントに接続できるようにする必要があります。これは、Aikido アカウントで生成できる秘密の認証トークンを使って行います。
1. 当社の [CI Integrations ページ](https://app.aikido.dev/settings/integrations/continuous-integration).
2. 認証トークンを生成します。連携のために、これを CI 環境で使用できるようにする必要があります。トークンを必ずコピーして、安全な場所に保管してください。次の手順で必要になります。
3. Bitbucket Pipes をクリックします。\
## リポジトリで連携を設定する
最後に、認証トークンを pipelines で使用できるようにし、連携を実行する設定ファイルを作成します。
1. Bitbucket アカウントのリポジトリ設定に移動します
2. 左側のナビゲーションを「Pipelines」セクションまでスクロールし、「Repository variables」をクリックします
3. 前の手順で取得した認証トークンをリポジトリ変数として追加します。この記事では、これを `AIKIDO_API_KEY`と名付けますが、好きな名前で構いません。
4. 次の設定はオンのままにすることを推奨します。 `保護` チェックボックスをオンにして、pipelines でトークンがコンソールに出力されないようにしてください。
5. 「Add」をクリックします。\
次に、Bitbucket pipelines にどのチェックをいつ、どこで実行するかを伝える設定ファイルを作成する必要があります。次の名前のファイルを作成してください。 `bitbucket-pipelines.yml` をリポジトリのルートに置き、次の内容を追加します。
```
pipelines:
pull-requests:
'**':
- step:
name: Aikido Security Scan
script:
- pipe: aikido-production/bitbucket-pipe:1.0.5
variables:
AIKIDO_API_KEY: $AIKIDO_API_KEY
```
この設定により、Bitbucket には次のことが伝えられます：
* 各 pull request ごとにこの pipeline を実行する
* `'**'` はフィルターで、Bitbucket に特定の pipelines のみで実行するよう指定できます。この例では、すべての pull request で実行したいと考えています
* 「Aikido Security Scan」というステップを追加し、スクリプトを実行します
* 次を実行します。 `aikido-production/bitbucket-pipe` これは、当社の公式 Bitbucket Pipelines 連携のバージョン `1.0.5`。このバージョンは、要件を満たす最新バージョンに固定しておくことを推奨します
* 次の変数を公開します： `AIKIDO_API_KEY` 前の手順で追加した環境変数を Aikido の連携環境に渡し、Aikido アカウントに接続できるようにします
公式連携は、デフォルトでは pull request の最新コミットで重大な脆弱性を見つけると失敗します。この挙動は、ほかの変数などを通じて設定可能です。以下は、現在この連携に渡して挙動を制御できる変数の概要です。
| **name** | **kind** | **デフォルト** | **説明** |
| -------------------------- | -------- | ---------- | -------------------------------------------------------------------------------------------- |
| AIKIDO\_API\_KEY（必須） | 文字列 | NULL | Aikido CI 認証トークン |
| MINIMUM\_SEVERITY | 文字列 | 'CRITICAL' | 問題を検出したときに失敗させる重大度です。'CRITICAL'、'HIGH'、'MEDIUM'、'LOW' のいずれかにできます |
| FAIL\_ON\_TIMEOUT | 文字列 | false | スキャンが一定時間内に完了しない場合に pipeline を失敗させるかどうかを指定します。'true' または 'false' のいずれかにできます。 |
| FAIL\_ON\_DEPENDENCY\_SCAN | 文字列 | false | サードパーティの依存関係の問題が検出された場合に pipeline を失敗させるかどうかを指定します。'true' または 'false' のいずれかにできます。 |
| FAIL\_ON\_SAST\_SCAN | 文字列 | false | SAST の問題が検出された場合に pipeline を失敗させるかどうかを指定します。'true' または 'false' のいずれかにできます。 |
| FAIL\_ON\_IAC\_SCAN | 文字列 | false | Infrastructure as Code の問題が検出された場合に pipeline を失敗させるかどうかを指定します。'true' または 'false' のいずれかにできます。 |
この設定ファイルをリポジトリの main ブランチに push すると、pull request を main ブランチに同期する際に、各 push ごとに pipeline のチェックが実行されることがわかります。