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

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

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

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

1. 次へ移動し、 Local Scanner イメージのセットアップページ
2. 認証トークンを生成してコピーします。このトークンは一度しか表示できないので注意してください。
3. このトークンを引数として追加します --apikey プロジェクトでローカルスキャナーを実行する際に。
4. Jenkins にこのトークンを保存してください。これを行うには、Jenkins の設定で「Credentials」ページに移動します。

グローバルで使用する新しいシークレットテキスト資格情報を追加するための Jenkins インターフェース。

2. プロジェクトにローカルスキャナーを追加する

Aikido UI からローカルスキャナーのバイナリをダウンロードします。Jenkins では、ビルドノードに追加し、名前でアクセスできるように /usr/local/bin に追加します。バイナリが実行可能であることを確認してください（例: chmod +x -R aikido-local-scanner）。Docker がインストールされているランナーを使用している場合は、この手順を省略し、Local Scanner の Docker イメージを使用してスキャンを実行できます（下記参照）。

3. ローカルスキャナーを実行する

あとは、リポジトリでスキャナーを実行するだけです。 ​ ローカルスキャナーはデフォルトブランチでのみ起動されるようにしてください。Aikido では、デフォルトではリポジトリ内の 1 つのブランチについて依存関係とコードの問題をスキャンできます。通常は main ブランチまたは master ブランチです。そのため、Aikido プラットフォーム上でスキャン結果が混在しないように、ローカルスキャナーはそのブランチでのみ実行することを推奨します。Git を使用している場合は、これを次の ビルド対象のブランチ セクション。

Jenkins が 'main' ブランチのみをビルドするように設定しています。

次に、ビルド環境に追加して、プロジェクトで API キーを使用できるようにします。

ビルド環境で Aikido 用のシークレット API キーのバインディングを設定しています。

以下の内容でプロジェクトに「Execute shell」ステップを追加します。イメージ名を使用することも、イメージの tar アーティファクトへのパスを使用することもできます。

aikido-local-scanner image-scan your-image --apikey $AIKIDO_API_KEY

あるいは、当社の Docker イメージを使用している場合は

docker run --rm -v /var/run/docker.sock:/var/run/docker.sock aikidosecurity/local-scanner image-scan your-image --apikey $AIKIDO_API_KEY

レジストリにプッシュする前にリリースゲート付きスキャンを実行するには、 --fail-on critical 上記のコマンドに追加できます。重大度を、特定のゲート要件に合わせて調整してください。

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

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