ローカルコードスキャンのためのLinuxセットアップ

目次:

• 要件
• 一時フォルダ​
• Local Scanningのセットアップ方法
  • 1. 認証トークンを取得する
  • 2. Local Scannerをプロジェクトに追加する
  • 3. Local Scannerを実行する
  • 4. スキャン結果を確認する

ローカルコードスキャンのためのLinuxセットアップ

Aikido Security Local Scannerは、お使いの環境内でAikido Securityのスキャンを実行できるツールであり、コードが社外に出ることはありません。スキャンはローカルで行われ、その結果がAikido Securityプラットフォームにアップロードされます。このセットアップにより、ご自身のマシン上で任意のリポジトリをローカルにスキャンできます。

要件

現在、x86_64およびARM64のオペレーティングシステムアーキテクチャをサポートしています。

一時フォルダ​

スキャナーは、特定の処理を実行するためにローカルの一時フォルダ(デフォルトは .aikidotmp)を作成します:

• 効率的なスキャンを実行するために、特定のロックファイルをコピーします。
• スキャナーの結果を書き込みます。

このフォルダはスキャン終了後にクリーンアップされます。

また、一部のファイルは一時作業ディレクトリにコピーされます。十分な空き容量があることを確認してください。最低10GBを推奨します。​

Local Scanningのセットアップ方法

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

1. Local Scannerセットアップページに移動します
2. 認証トークンを生成してコピーします。このトークンは一度しか表示できないことに注意してください。
3. プロジェクトでLocal Scannerを実行する際に、このトークンを引数 --apikey として追加します。

2. Local Scannerをプロジェクトに追加する

Aikido UIからローカルスキャナーのバイナリをダウンロードします。

3. Local Scannerを実行する

あとは、スキャンしたいディレクトリに対してスキャナーを実行するだけです。

./aikido-local-scanner scan path_to_my_repository --apikey AIK_CI_xxx --repositoryname DemoApp --branchname main

デフォルトではすべてのスキャナーが実行されます。一部のスキャナーのみを実行したい場合は、--scanners オプションでスキャナー名を指定してください。CLIオプションの詳細はこちらをご覧ください。

または、Docker HubやAWS Elastic Container Registryにある当社のDockerイメージを使用してリポジトリをスキャンすることもできます。続行する前に、Dockerがインストールされていることを確認してください。まずスキャンしたいディレクトリに移動し、次のようなコマンドでスキャンを実行します:

docker run --rm -v "$(pwd):/my-app" aikidosecurity/local-scanner scan /my-app --apikey AIK_CI_xxx --repositoryname RepoName --branchname main

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

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