# GitLab Self-Managed サーバーの接続（Broker セットアップ）

Aikido では、セルフマネージドの GitLab インスタンスを接続して、コードをスキャンし保護できます。以下の手順に従って、GitLab サーバーを Aikido に接続してください。

### 始める前に

* セットアップを行う担当者は、GitLab インスタンス**と**接続したい GitLab グループの両方へのアクセス権が必要です。

{% hint style="warning" %}
Aikido のワークスペースは、常に単一の GitLab グループに対応します。

すべてのサブグループを含むトップレベル（ルート）グループに Aikido を接続することをお勧めします。ルートグループがない場合は、GitLab グループごとに 1 つのワークスペースを作成してください。最初のワークスペースを作成した後、左上のドロップダウンの「Add another workspace」から作成できます。
{% endhint %}

## 設定

{% stepper %}
{% step %}
**Aikido アカウントを作成する**

GitLab サーバーを接続するには、まず Google または Microsoft を使用して Aikido にサインアップまたはログインします。[サインアップ画面](https://app.aikido.dev/login)で **Google / Microsoft** をクリックします。
{% endstep %}

{% step %}
**GitLab のセットアップを開始する**

認証が完了したら、GitLab セクションの **Self-Managed** をクリックして新しいワークスペースを作成します。

<figure><img src="https://help.aikidogov.us/_assets/bc4b25ebacf6/image-411.png" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Broker アクセスを有効にする**

「Advanced Connection Options」セクションのトグルをクリックして、**Aikido broker** を有効にします。

**Create Group** をクリックして続行します。

<figure><img src="https://help.aikidogov.us/_assets/75700246ec89/image-412.png" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Broker を設定する**

以下のガイドに従って Broker を設定します。デプロイが完了したら、ここに戻って GitLab のセットアップを完了してください。

{% content-ref url="../../../miscellaneous-info/aikido-broker-for-internal-applications.md" %}
[aikido-broker-for-internal-applications.md](https://help.aikidogov.us/docs/docs-ja/miscellaneous-info/aikido-broker-for-internal-applications)
{% endcontent-ref %}

<figure><img src="https://help.aikidogov.us/_assets/a6f4a50ab13b/Screenshot-2025-12-22-at-10.48.21.png" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**GitLab サーバーのセットアップを完了する**

Broker を作成して環境にデプロイしたら、GitLab のセットアップを完了できます。

まず、**Broker URL** をコピーします。次のような形式です：

```
https://55673-355dsfwea68cb.aikidobroker.com
```

次に、**Complete GitLab Server Setup** をクリックします。

<figure><img src="https://help.aikidogov.us/_assets/1f86ec5d7c84/Broker_Clients_-_Gitlab_Server_EVAfKobo3u_-_Aikido_Security_.png" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Broker URL を入力する**

前のステップで取得した Broker リソース URL を、「server URL」の入力フィールドに貼り付けます。

<figure><img src="https://help.aikidogov.us/_assets/b591c3dccfbc/Scherm-afbeelding-2026-01-27-om-15.16.49.png" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**GitLab のパーソナルアクセストークン（PAT）を作成する**

次に、パーソナルアクセストークン（PAT）を作成します。専用のサービスアカウントを使用することをお勧めします。




* GitLab サーバーにログインします
* 管理エリア（`/admin`）に移動します
* **Settings** → **Service accounts** に移動します
* **Add service account** をクリックし、名前を入力して保存します

{% hint style="warning" %}
他のユーザーと同様に、接続したい GitLab グループにサービスアカウントを追加してください。詳しくは GitLab のドキュメント「[グループメンバー](https://docs.gitlab.com/ee/user/group/members/)」を参照してください。
{% endhint %}

サービスアカウントが作成されたら、三点リーダーをクリックして「**Manage access tokens**」を選択し、そのアカウント用の PAT を作成できます。

* 「**Add new token**」をクリックします
* トークンの名前を入力します。例：`Aikido Security Access Token`
* 社内ポリシーに合わせて有効期限を設定します。有効期限が切れる前にトークンをローテーションしてください。
* 以下のスコープを選択する必要があります：
  * **read\_user**
  * **read\_api**
  * **read\_repository**
* フォーム下部の **Create token** ボタンをクリックします。

<figure><img src="https://help.aikidogov.us/_assets/41a984a98deb/Scherm-afbeelding-2025-08-11-om-15.00.51.png" alt=""><figcaption></figcaption></figure>

* 画面に表示されたトークンをコピーし、入力フィールドに入力します。

**重要：** この画面を離れると、トークンを再度表示することはできません。続行する前にコピーしてください。

Aikido が GitLab サーバーへの接続を確認します。失敗した場合は、サーバー URL とトークンを再確認してください。
{% endstep %}

{% step %}
**インストールを完了する**

**Next, Connect Group** をクリックした後、最初に接続するグループを選択します。グループは後からいつでも追加で接続できます。

最後のステップで、Aikido に監視させたいリポジトリを選択します。
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Broker を介して GitLab コンテナレジストリもスキャンしますか？レジストリは通常、独自のホスト上で稼働しているため、別の Broker リソースが必要です。[GitLab Self Managed Container Registry](https://help.aikidogov.us/docs/docs-ja/container-image-scanning/standalone-registries/gitlab-self-managed-container-registry#connect-a-registry-on-an-internal-network-broker) を参照してください。
{% endhint %}