Local Image ScanningのBitBucketパイプラインセットアップ

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

イメージのLocal Scanningをセットアップする方法

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

Local Scanner Imageのセットアップページにアクセスします
認証トークンを生成してコピーします。このトークンは一度しか表示されない点にご注意ください。
パイプラインで使用できるように、認証トークンをBitbucketのRepository variablesに追加します。そのためには、Repository Settingsに移動し、Pipelines > Repository variablesに進みます。そこで、キーにAIKIDO_API_KEY、値にコピーしたトークンの内容を指定して認証トークンを追加できます。

2. Local Scannerを実行する

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

image: docker:25.0.3

pipelines:
  default:
    - step:
        name: Build Docker Image
        image: docker:25.0.3
        services:
          - docker
        script:
          - export PATH=/usr/bin:$PATH
          - docker build -t my-image .
          - docker save --output my-image.tar my-image
        artifacts:
          - my-image.tar
    - step:
        name: Scan Docker Image
        image: aikidosecurity/local-scanner
        script:
          - aikido-local-scanner image-scan my-image.tar --image-name my-image --apikey $AIKIDO_API_KEY

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

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