日本語

GitLab Self-Managedサーバーを接続

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

始める前に

  • GitLabがファイアウォールの内側にある場合は、AikidoがアクセスできるようにAikidoのIPアドレスを許可リストに追加してください。
  • セットアップを行う担当者は、GitLabインスタンスと接続したいGitLabグループの両方へのアクセス権が必要です。

Aikidoのワークスペースは、常に1つのGitLabグループに対応します。

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

設定

  1. Aikidoアカウントを作成する

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

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

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

  3. GitLabの詳細を入力する

    ワークスペースを作成するには、Aikidoが接続できるように、セルフマネージドGitLabインスタンスに関するいくつかの詳細を入力します。

    GitLabがファイアウォールの内側で稼働している場合は、AikidoがアクセスできるようにAikidoのIPアドレスを許可リストに追加してください。それが不可能な場合は、Brokerセットアップガイドを使用してください。

    最初の入力フィールドにGitLabサーバーのURLを入力します。

  4. 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とトークンを再確認してください。

  5. インストールを完了する

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

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