> For the complete documentation index, see [llms.txt](https://help.aikido.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aikido.dev/docs/docs-ja/prtorirsunogtingu/gitlab-mr-gating/gitlab-free-mr-scans-setup.md).
# GitLab Free: MR スキャンのセットアップ
Aikido の問題に関する MR スキャン結果とコメントを公開します。パイプラインコードは不要です。
{% hint style="warning" %}
この設定は、 **GitLab Free** Service Accounts が利用できず、代わりに専用ユーザーを使用するプラン向けです。
次を利用している場合は **GitLab Premium、GitLab Ultimate、または GitLab Server**、代わりに [**サービスアカウント**](/docs/docs-ja/prtorirsunogtingu/gitlab-mr-gating/gitlab-server-ci-mr-gating-via-aikido-dashboard-with-a-service-account-token.md) ユーザーベースのセットアップの代わりに使用します。
{% endhint %}
## GitLab MR スキャンを設定する
{% stepper %}
{% step %}
**専用の GitLab ユーザーを作成**
次のような専用ユーザーを作成 `AikidoSecurity[YourCompany]`。Aikido 専用に使用してください。
見分けやすくするために、 [Aikido のロゴ](https://www.aikido.dev/press-kit) をプロフィール画像に使用してください。
{% endstep %}
{% step %}
**Personal Access Token を作成**
新しいユーザーとしてログインします。
次へ **設定** → [**Personal Access Token**](https://gitlab.com/-/user_settings/personal_access_tokens).
新しいトークンを追加:
* 名前: 例 `Aikido スキャン`
* 有効期限: ローテーション ポリシーに合った有効期限を設定します
* スコープ: `api`
{% endstep %}
{% step %}
**トークンを保存する**
今すぐトークンをコピーしてください。GitLab では再表示されません。
手順 6 で Aikido に貼り付けます。
{% endstep %}
{% step %}
**Aikido ユーザーをグループに招待**
ご自身の GitLab アカウントで再度ログインします。
次へ [**グループ**](https://gitlab.com/dashboard/groups).
有効にしたい各グループを開きます。
次へ **管理** → **メンバー** → **メンバーを招待**.
専用の Aikido ユーザーを招待します。
少なくとも **メンテナー** 権限を付与します。
{% endstep %}
{% step %}
**連携を有効化**
Aikido で、次を開きます: [連携](https://app.aikido.dev/settings/integrations?section=ci) ページを開き、次に選択します: **GitLab CI** の下に **MR 品質ゲート**.
{% endstep %}
{% step %}
**Personal Access Token を貼り付け**
手順 3 で作成したトークンを貼り付けます。
クリック **トークンを更新**.
Aikido はグループへのアクセスと必要な権限を検証します。
{% endstep %}
{% step %}
**最初のリポジトリを設定**
認可後、Aikido は次を開きます: [GitLab MR チェック](https://app.aikido.dev/settings/integrations/gitlab/checks) ページ。
から始める **1 つのリポジトリ** を最初に対象にします。広く展開する前に、すべてが正常に動作することを確認してください。
{% endstep %}
{% step %}
**新しい MR で確認する**
設定したリポジトリで新しいマージ リクエスト（MR）を開きます。
その後、次の場所でチェックが実行されていることを確認します **パイプライン** タブを選択します。
コメントは専用ユーザーとして表示されるはずです。たとえば、 `@AikidoSecurity[YourCompany]`.
{% endstep %}
{% step %}
**スキャンの成功を必須にする**
スキャンが成功するまでマージをブロックしたい場合は、次を設定します: **マージ チェック** GitLab で。
GitLab で、次へ移動します **\[Repository]** → **設定** → **マージ リクエスト**。チェックを有効にし `パイプラインは成功する必要があります`.
{% endstep %}
{% step %}
**すべてのリポジトリで有効化**
結果に満足したら、次に戻ります: [GitLab MR チェック](https://app.aikido.dev/settings/integrations/gitlab/checks) ページに戻り、残りのリポジトリでチェックを有効にします。
{% endstep %}
{% step %}
**新しいリポジトリのデフォルトを設定**
右上で次を開きます: `アクション` して、 `新しいリポジトリのデフォルトを設定` 今後追加されるリポジトリに対する自動設定も有効にします。
UI の手順が必要ですか？こちらを参照: [新しいリポジトリ向けの既定の PR/MR ゲーティング設定](/docs/docs-ja/prtorirsunogtingu/aikido-ci-gating-functionality/default-pr-mr-gating-configuration-for-new-repositories.md).
{% endstep %}
{% endstepper %}
## MR コメントから直接問題を無視する
Aikido が検出結果についてインラインの MR コメントを投稿した場合、コメントに次のように返信することで、GitLab からその問題を直接無視できます:
`@AikidoSecurity[YourCompany] ignore: [無視する理由]`
例：
`@AikidoSecurity[YourCompany] ignore: このシークレットはテストでのみ使用されます。`
置き換えてください `@AikidoSecurity[YourCompany]` ステップ 1 で作成した専用 GitLab ユーザーのユーザー名を使用します。
これは、Aikido プラットフォームで手動でその問題を無視するのと同じ操作です：
* その問題は Aikido で無視済みとしてマークされます。
* 無視の理由が保存されます。
* すべてのブロック中の問題が解決または無視されると、MR ゲートは緑になります。
{% hint style="info" %}
無視権限がない場合、このコメントは次の場所にリクエストを作成します： [承認受信箱](/docs/docs-ja/me/core-functionalities/approval-inbox-for-ignored-issues.md) すぐに問題を無視する代わりに。管理者が承認または却下するまで、その検出結果はフィードに残ります。
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.aikido.dev/docs/docs-ja/prtorirsunogtingu/gitlab-mr-gating/gitlab-free-mr-scans-setup.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
