# GitLab Free: MRスキャンのセットアップ

{% hint style="warning" %}
このセットアップは、 **GitLab Free** Service Accounts が利用できず、代わりに専用ユーザーを使用するプラン向けです。

もしご利用中のプランが **GitLab Premium、GitLab Ultimate、または GitLab Server**、次のものを使用します [**サービスアカウント**](https://help.aikido.dev/docs/docs-ja/pr-and-release-gating/gitlab-mr-gating/gitlab-server-ci-mr-gating-via-aikido-dashboard-with-a-service-account-token) ユーザーベースのセットアップの代わりに。
{% endhint %}

## GitLab MR スキャンを設定する

{% stepper %}
{% step %}
**専用の GitLab ユーザーを作成する**

次のような専用ユーザーを作成します `AikidoSecurity[YourCompany]`。Aikido 専用で使用してください。

見分けやすくするために、 [Aikido のロゴ](https://www.aikido.dev/press-kit) をプロフィール画像に使用します。

<div data-with-frame="true"><figure><img src="https://help.aikido.dev/_assets/60e1cdb0bf94/Screenshot-2026-03-02-at-13.12.14-1.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**個人アクセストークンを作成する**

新しいユーザーとしてログインします。

次へ移動します： **設定** → [**個人アクセストークン**](https://gitlab.com/-/user_settings/personal_access_tokens).

新しいトークンを追加:

* 名前: 例 `Aikido Scans`
* 有効期限: ローテーションポリシーに合った有効期限を設定します
* スコープ: `api`

<div data-with-frame="true"><figure><img src="https://help.aikido.dev/_assets/c7beb4885c6f/Screenshot-2026-03-02-at-13.56.26.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**トークンを保存**

今すぐトークンをコピーしてください。GitLab では再表示されません。

ステップ 6 で Aikido に貼り付けます。

<div data-with-frame="true"><figure><img src="https://help.aikido.dev/_assets/4e1cc6ec3ccb/Screenshot-2026-03-02-at-13.58.27.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Aikido ユーザーをグループに招待する**

自分の GitLab アカウントで再度ログインします。

次へ移動します： [**グループ**](https://gitlab.com/dashboard/groups).

有効にしたい各グループで、そのグループを開きます。

次へ移動します： **管理** → **メンバー** → **メンバーを招待**.

専用の Aikido ユーザーを招待します。

<div data-with-frame="true"><figure><img src="https://help.aikido.dev/_assets/f727747aae12/Screenshot-2026-03-02-at-13.47.09.png" alt=""><figcaption></figcaption></figure></div>

少なくとも **メンテナー** の権限を付与します。

<div data-with-frame="true"><figure><img src="https://help.aikido.dev/_assets/cd01424b1883/Screenshot-2026-03-02-at-16.16.56.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

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

Aikido で、次を開きます: [連携](https://app.aikido.dev/settings/integrations?section=ci) ページ。次に、 **GitLab CI** 以下の **MR 品質ゲート**.

<div data-with-frame="true"><figure><img src="https://help.aikido.dev/_assets/febd420de006/Screenshot-2026-03-02-at-15.11.44.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**個人アクセストークンを貼り付ける**

ステップ 3 で作成したトークンを貼り付けます。

クリックします **トークンを更新**.

Aikido はグループへのアクセスと必要な権限を検証します。

<div data-with-frame="true"><figure><img src="https://help.aikido.dev/_assets/33df72c18af7/Screenshot-2026-03-02-at-15.02.03.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

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

認証後、Aikido は次を開きます: [GitLab MR チェック](https://app.aikido.dev/settings/integrations/gitlab/checks) ページ上で使用します。

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

<div data-with-frame="true"><figure><img src="https://help.aikido.dev/_assets/422eaf66de52/Screenshot-2026-03-02-at-15.17.32.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

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

設定したリポジトリで新しいマージリクエスト（MR）を開きます。

その後、チェックが次の場所で実行されていることを確認します **パイプライン** タブを選択します。

<div data-with-frame="true"><figure><img src="https://help.aikido.dev/_assets/909bde500970/Screenshot-2026-03-02-at-15.20.37.png" alt=""><figcaption></figcaption></figure></div>

コメントは専用ユーザーとして表示されるはずです。たとえば、 `@AikidoSecurity[YourCompany]`.

<div data-with-frame="true"><figure><img src="https://help.aikido.dev/_assets/ee9a495553f4/Screenshot-2026-03-02-at-15.28.18.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**スキャンの成功を必須にする**

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

GitLab で次へ移動します **\[リポジトリ]** → **設定** → **マージリクエスト**。チェックを有効にします `パイプラインは成功する必要があります`.

<div data-with-frame="true"><figure><img src="https://help.aikido.dev/_assets/4b09d83d694c/Screenshot-2026-03-02-at-15.56.26.png" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://help.aikido.dev/_assets/a8ef28153ba3/Screenshot-2026-03-02-at-15.57.29.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

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

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

<div data-with-frame="true"><figure><img src="https://help.aikido.dev/_assets/5964fdea6d9d/Screenshot-2026-03-02-at-15.36.19.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

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

右上で、次を開きます: `アクション` and select `新しいリポジトリのデフォルトを設定` また、今後追加されるリポジトリに対して自動設定を有効にします。

UI の手順ガイドが必要ですか？こちらをご覧ください [新しいリポジトリに対するデフォルトのPR/MRゲーティング設定](https://help.aikido.dev/docs/docs-ja/pr-and-release-gating/aikido-ci-gating-functionality/default-pr-mr-gating-configuration-for-new-repositories).
{% endstep %}
{% endstepper %}

## MR コメントから直接問題を無視する <a href="#ignore-issues-directly-from-mr-comments" id="ignore-issues-directly-from-mr-comments"></a>

Aikido が検出結果に対してインラインの MR コメントを投稿した場合、コメントに次のように返信することで GitLab から直接その問題を無視できます:

`@AikidoSecurity[YourCompany] ignore: [無視する理由を入力]`

例:

`@AikidoSecurity[YourCompany] ignore: このシークレットはテスト専用で使用されます。`

置き換えてください `@AikidoSecurity[YourCompany]` ステップ 1 で作成した専用の GitLab ユーザーのユーザー名を使用します。

これは、Aikido プラットフォームで手動で問題を無視するのと同じ操作です:

* 問題は Aikido で無視済みとしてマークされます。
* 無視理由が保存されます。
* すべてのブロッキングな問題が解決または無視されると、MR ゲーティングは緑になります。

{% hint style="info" %}
この返信は、あなたがその **課題を無視可能** 権限です。その権限がない場合、Aikido は無視が許可されていないと応答し、指摘は未解決のまま残ります。
{% endhint %}