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

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

始める前に

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

設定

1. 1

   Aikido アカウントを作成する

   GitLab サーバーを接続するには、まず Google または Microsoft を使用して Aikido にサインアップまたはログインします。サインアップ画面で Google / Microsoft をクリックします。

2. 2

   GitLab のセットアップを開始する

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

   

3. 3

   Broker アクセスを有効にする

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

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

   

4. 4

   Broker を設定する

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

   内部アプリケーション向け Aikido Broker

   

5. 5

   GitLab サーバーのセットアップを完了する

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

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

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

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

   

6. 6

   Broker URL を入力する

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

   

7. 7

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

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

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

   他のユーザーと同様に、接続したい GitLab グループにサービスアカウントを追加してください。詳しくは GitLab のドキュメント「グループメンバー」を参照してください。

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

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

   

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

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

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

8. 8

   インストールを完了する

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

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