# WSL2 におけるデバイス保護

Windows Subsystem for Linux (WSL) 内でのパッケージのインストールは、Windows エージェントの管理外にある独自の Linux 環境で実行されます。これにより **WSL2 を保護** をオンにすると、Windows のデバイス保護が各デバイスで実行中の WSL2 ディストロを検出し、そこに Linux エージェントをインストールします。これにより `npm`, `pip`、および WSL 内のその他のパッケージマネージャーも、Windows と同じ方法で検査されます。

{% hint style="info" %}
WSL2 保護はリクエストに応じて利用できます。 [サポートに連絡する](https://help.aikidogov.us/docs/docs-ja/miscellaneous-info/contact-support) ワークスペースで有効にするには。
{% endhint %}

## 前提条件

* WSL2。WSL1 のディストロはスキップされます。
* `curl` または `wget` 各ディストロ内、および送信先への HTTPS で `github.com` インストーラーをダウンロードするために。

## WSL2 保護をオンにする

1. 次へ移動します： [**デバイス保護** → **設定**](https://app.aikido.dev/endpoint-protection/settings).
2. 次の項目の下で **デバイス設定**、オンにします **WSL2 を保護**.

<figure><img src="https://help.aikidogov.us/_assets/320f16b6bb6b/device-protection-device-settings-wsl2.png" alt="Device Settings card with the Protect Containers and Protect WSL2 toggles"><figcaption></figcaption></figure>

この設定はワークスペース内のすべての Windows デバイスに適用されます。デバイスは次回のチェックイン時に 3 分以内にこれを取得し、その後最初のインストール前に最大 10 分のランダムな遅延を待つため、大規模なフリートでも一斉にすべてへインストールされることはありません。

## 仕組み

Windows エージェントは、そのデバイスにサインインしているユーザーの WSL2 ディストロを監視し、実行中の各ディストロを 10 分ごとに確認します。これは、保護がオンで、かつエージェントが Windows 上で通常どおり実行されている間だけ行われます。

* **実行中のディストロのみが対象です。** Aikido は停止中のディストロを起動しません。後で起動したディストロは数分以内に検出されます。
* **Linux エージェントは、見つからないか破損している場合にインストールされます。** Aikido は、ディストロ内で root として標準の Linux インストールスクリプトを実行し、 `--headless`Windows デバイスのトークンを使用します。すでに正常なパッケージがあるディストロはそのままにされます。
* **一度に 1 つのディストロずつ。** インストールには数分かかる場合があるため、各チェックでは最大 1 つのディストロにインストールし、次のチェックで次のものに進みます。
* **ディストロは自動で最新の状態を保ちます。** インストール後、Linux エージェントは他の Linux デバイスと同様に、ディストロ内で自動更新されます。
* **各ディストロはそれ自体が 1 つのデバイスです。** 保護されたディストロには独自のマシン ID があるため、Aikido には別個の Linux デバイスとして報告されます。

これらのディストロはスキップされます：

| ディストロ                                                      | 理由                                                                                                                                                                                              |
| ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| WSL1 のディストロ                                                | 非対応                                                                                                                                                                                             |
| `docker-desktop`, `rancher-desktop`、および `podman-machine-*` | ベンダー提供のイメージであり、ワークスペースではありません。コンテナを保護するには、 **コンテナを保護** 代わりに。参照 [Docker コンテナのデバイス保護](https://help.aikidogov.us/docs/docs-ja/aikido-device-protection/deploying-aikido-endpoint/device-protection-in-docker-containers) |
| インストール中、変換中、またはエクスポート中のディストロ                               | Aikido はそれらが通常の状態になるまで待ちます                                                                                                                                                                      |

オフにすると **WSL2 を保護** オフにすると、新規インストールは停止します。すでにエージェントがあるディストロからは削除されません。削除するには、次の Linux の手順に従ってください： [Device Protection をアンインストールする](https://help.aikidogov.us/docs/docs-ja/aikido-device-protection/deploying-aikido-endpoint/uninstall-aikido-endpoint) ディストロ内で。

## 動作確認

ディストロ内で次を実行します：

```shell
sudo aikidoctl version
```

インストール済みのバージョン、サービスの状態、およびディストロが登録されているかどうかを表示します。コマンドが見つからない場合は、まだインストールされていません。ディストロが実行中であることを確認し、次のチェックを待ってください。

## トラブルシューティング

| 問題                                             | 修正                                                                                                                                                                                                                                                                    |
| ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ディストロが保護されない                                   | WSL2 であることを確認してください（`wsl -l -v` PowerShell で表示される `VERSION 2`）、実行中であること、および上のスキップ対象リストに含まれていないことを確認してください                                                                                                                                                             |
| インストールは次の理由で失敗します `curl も wget もインストールされていません` | インストール `curl` ディストロ内で、たとえば `sudo apt-get install curl`                                                                                                                                                                                                                |
| インストールが失敗し続ける                                  | Aikido は再試行の間隔を徐々に延ばして再試行し、試行間隔は最大 30 分になります。Windows エージェントのログ、 `%ProgramData%\AikidoSecurity\EndpointProtection\logs\EndpointProtection.log`には、各試行のインストーラー出力が次で始まる行に記録されています： `WSL:`。そのログを次へ送ってください [サポートに連絡する](https://help.aikidogov.us/docs/docs-ja/miscellaneous-info/contact-support) |
| 誰もサインインしていない間は何も起こりません                         | 想定どおりです。Aikido は、そのデバイスにサインインしているユーザーのディストロに対してのみ動作します                                                                                                                                                                                                                |

## 関連

{% content-ref url="device-protection-mdm-guides/linux/install-device-protection-for-linux/" %}
[Linux 用 Device Protection をインストールする](https://help.aikidogov.us/docs/docs-ja/aikido-device-protection/deploying-aikido-endpoint/device-protection-mdm-guides/linux/install-device-protection-for-linux)
{% endcontent-ref %}

{% content-ref url="device-protection-mdm-guides/linux/device-protection-in-containers.md" %}
[コンテナ内の Device Protection](https://help.aikidogov.us/docs/docs-ja/aikido-device-protection/deploying-aikido-endpoint/device-protection-mdm-guides/linux/device-protection-in-containers)
{% endcontent-ref %}