# ローカルコードスキャンのWindowsセットアップ

**目次:**

* [Local Scanningのセットアップ方法](https://help.aikido.dev/docs/docs-ja/code-scanning/local-code-scanning/windows-setup-for-local-code-scanning#how-to-set-up-local-scanning)
  * [1. 認証トークンを取得する](https://help.aikido.dev/docs/docs-ja/code-scanning/local-code-scanning/windows-setup-for-local-code-scanning#1-get-your-authentication-token)
  * [2. プロジェクトにLocal Scannerを追加する](https://help.aikido.dev/docs/docs-ja/code-scanning/local-code-scanning/windows-setup-for-local-code-scanning#2-adding-the-local-scanner-to-your-project)
  * [3. Local Scannerを実行する](https://help.aikido.dev/docs/docs-ja/code-scanning/local-code-scanning/windows-setup-for-local-code-scanning#3-running-the-local-scanner)
  * [4. スキャン結果を確認する](https://help.aikido.dev/docs/docs-ja/code-scanning/local-code-scanning/windows-setup-for-local-code-scanning#4-check-your-scanning-results)

## ローカルコードスキャンのWindowsセットアップ

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

### Local Scanningのセットアップ方法 <a href="#how-to-set-up-local-scanning" id="how-to-set-up-local-scanning"></a>

**前提条件**: Local Scanningが利用可能なアカウントを作成済みであることを確認してください。[Local Scanningアカウントの作成に関する詳細はこちら](https://help.aikido.dev/code-scanning/local-code-scanning/account-creation-for-local-scanning-on-aikido)。

#### 1. 認証トークンを取得する <a href="#id-1-get-your-authentication-token" id="id-1-get-your-authentication-token"></a>

1. [Local Scannerセットアップページ](https://app.aikido.dev/settings/integrations/localscan)に移動します。
2. 認証トークンを生成してコピーします。このトークンは一度しか表示されないことにご注意ください。
3. プロジェクトでLocal Scannerを実行する際に、このトークンを引数 `--apikey` として追加します。

#### 2. プロジェクトにLocal Scannerを追加する <a href="#id-2-adding-the-local-scanner-to-your-project" id="id-2-adding-the-local-scanner-to-your-project"></a>

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

#### 3. Local Scannerを実行する <a href="#id-3-running-the-local-scanner" id="id-3-running-the-local-scanner"></a>

あとはコンテナを起動してリポジトリをスキャンするだけです。リポジトリのルートに移動し、キー、リポジトリ名、ブランチ名を入力して次のコマンドを実行します。

```shellscript
aikido-local-scanner.exe scan . --apikey AIK_CI_xxx --repositoryname DemoApp --branchname main
```

または、[Dockerイメージ](https://hub.docker.com/r/aikidosecurity/local-scanner)を使用してリポジトリをスキャンすることもできます。続行する前に、[Dockerがインストールされている](https://docs.docker.com/desktop/)ことを確認してください。スキャンしたいディレクトリに移動し、次のようなコマンドでスキャンを実行します。

コマンドプロンプトを使用している場合:

```shellscript
docker run --rm -v "%cd%:/my-app" aikidosecurity/local-scanner scan /my-app --apikey AIK_CI_xxx --repositoryname RepoName --branchname main
```

Powershellを使用している場合:

```shellscript
docker run --rm -v "${PWD}:/my-app" aikidosecurity/local-scanner scan /my-app --apikey AIK_CI_xxx --repositoryname RepoName --branchname main
```

デフォルトではすべてのスキャナーが実行されます。一部のスキャナーのみを実行したい場合は、`--scanners` オプションでスキャナー名を指定してください。CLIオプションの詳細は[こちら](https://help.aikido.dev/code-scanning/local-code-scanning/cli-options-for-local-scanner)をご覧ください。

#### 4. スキャン結果を確認する <a href="#id-4-check-your-scanning-results" id="id-4-check-your-scanning-results"></a>

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