ローカルイメージスキャンのためのGitLab設定

Aikido Security Local Scanner は、Aikido Security のスキャンを自社環境内で実行できるツールです。これにより、データが外部に出ることはありません。スキャンはローカルで実行され、その結果は Aikido Security プラットフォームにアップロードされます。このセットアップにより、レジストリに送信される前に、自分のマシン上または CI/CD パイプライン内で任意のイメージをローカルにスキャンできます。

イメージのローカルスキャンを設定する方法

1. 認証トークンを取得する

1. 次へ移動し、 Local Scanner イメージのセットアップページ
2. 認証トークンを生成してコピーします。このトークンは一度しか表示できないので注意してください。
3. このトークンを引数として追加します --apikey プロジェクトでローカルスキャナーを実行する際に。
4. 認証トークンを Gitlab の CI/CD 変数に追加して、パイプラインで使用できるようにします。 これを行うには、グループの Settings ページに移動し、次に CI/CD サブページに移動します。

   

   GitLab CI/CD の設定ページ。変数、Runner、Auto DevOps の自動化を管理します。

   変数の横にある「Expand」をクリックし、「Add variable」をクリックします。次に、認証トークンを AIKIDO_LOCAL_SCANNER_TOKEN をキーとして、コピーしたトークンの内容を値として追加できます。

2. Local Scanner の実行

あとは、画像に対してスキャナーを実行するだけです。以下のサンプルファイルを参考にしてください:

既定値:
  image: docker:cli
  services:
    - docker:dind

run_aikido_selfscanner:
  script:
  - docker build ...
  - docker run --rm -v /var/run/docker.sock:/var/run/docker.sock aikidosecurity/local-scanner image-scan your-local-image-name --apikey $AIKIDO_LOCAL_SCANNER_TOKEN
    - if: $CI_COMMIT_BRANCH == "main"

CI でこれを実行する場合は、feature ブランチをベースにしたイメージに対してスキャンを実行しないよう注意してください。そうすることで、本番用と feature の結果が Aikido 内で混在するのを防げます。

レジストリにプッシュする前にリリースゲート付きのスキャンを実行するには、次のようなパイプラインを実行できます:

既定値:
  image: docker:cli
  services:
    - docker:dind

run_aikido_selfscanner:
  script:
  - docker build ...
  - docker run --rm -v /var/run/docker.sock:/var/run/docker.sock aikidosecurity/local-scanner image-scan your-local-image-name --apikey $AIKIDO_LOCAL_SCANNER_TOKEN --fail-on critical
  - docker push ...
    - if: $CI_COMMIT_BRANCH == "main"

次に指定する重大度を --fail-on を必要に合わせて調整してください。

4. スキャン結果を確認する

最初のスキャンが完了したら、Aikido Feed に移動して結果を確認できます。指定した名前のイメージが Aikido UI に作成され、スキャン結果がすべて含まれています。