# FileWave で Device Protection をデプロイする

FileWave を使用して、必要な権限を設定した状態で、管理対象の macOS デバイス全体に Aikido Device Protection をデプロイします。

{% hint style="info" %}
開始する前に、すべての Mac が FileWave のモバイルデバイス管理（MDM）に登録されている必要があります。FileWave は MDM を通じて構成プロファイルを配信するため、登録されていない Mac にはプロファイルが届きません。
{% endhint %}

## 前提条件

[Aikido アプリ](https://app.aikido.dev/endpoint-protection/devices)から以下をダウンロードしてください。

* **Aikido Device Protection の `.mobileconfig`**
* **Aikido Device Protection インストーラー**（`.pkg` ファイル）

これらのいずれかが不足している場合は、[Aikido アプリ](https://app.aikido.dev/endpoint-protection/devices)に移動し、**Connect Device** をクリックして、事前準備の手順を完了してください。

## Device Protection をデプロイする

{% stepper %}
{% step %}
### 構成プロファイルを追加する

1. FileWave Central で **Filesets** に移動します。
2. Finder から `.mobileconfig` ファイルを **Filesets** ビューにドラッグします。
3. 新しい Profile ファイルセットの名前を「Aikido Device Protection profile」に変更します。

{% hint style="warning" %}
FileWave の Profile エディターでプロファイルを再作成したり編集したりしないでください。このエディターは Apple の定義済みペイロードしか認識せず、認識できないキーを含むプロファイルを変更してしまう可能性があります。ファイルをドラッグして追加すれば、内容は変更されません。
{% endhint %}

このプロファイルにより、Aikido Device Protection のシステム拡張機能がユーザーへの確認なしに読み込まれ、ネットワークコンテンツフィルターが有効になり、ユーザーがシステム設定 → ログイン項目でバックグラウンドサービスを無効にできなくなります。
{% endstep %}

{% step %}
### インストーラーを追加する

1. **Filesets** で、Aikido Device Protection の `.pkg` をビューにドラッグするか、**New Desktop Fileset** → **MSI / PKG** をクリックしてファイルを選択します。
2. 新しい PKG ファイルセットの名前を「Aikido Device Protection installer」に変更します。
3. アップロードが完了するまで待ちます。FileWave の下部バーに進行状況が表示されます。
{% endstep %}

{% step %}
### インストール後に再起動を強制する

1. **Aikido Device Protection installer** ファイルセットを選択し、**Properties** をクリックします。
2. **Force reboot** にチェックを入れて保存します。

FileWave は、インストーラーの実行から 2 分後に Mac を再起動します。エージェントは次回の起動時に完全に有効になります。
{% endstep %}

{% step %}
### デバイスにデプロイする

インストーラーの実行時にシステム拡張機能がすでに承認されているよう、先にプロファイルをデプロイします。

1. FileWave Central で **Deployments** に移動し、「Aikido Device Protection」という名前で新しいデプロイメントを作成します。
2. **Clients** の横にある **+** をクリックし、対象の Mac またはグループを選択します。
3. **Filesets** の横にある **+** をクリックし、**Aikido Device Protection profile** ファイルセットを追加します。
4. **OK** をクリックし、ツールバーの **Update Model** をクリックしてデプロイメントをデバイスに送信します。
5. 対象の Mac の **Client Info** → **Filesets Status** を開き、プロファイルがインストールされていることを確認します。
6. デプロイメントを編集し、**Filesets** の横にある **+** をクリックして、**Aikido Device Protection installer** ファイルセットを追加します。
7. **OK** をクリックし、再度 **Update Model** をクリックします。

まずは 1 台のテスト用 Mac から始めてください。次の手順の確認に合格したら、残りのデバイスをデプロイメントに追加して **Update Model** をクリックします。
{% endstep %}

{% step %}
### デプロイメントを確認する

FileWave Central で、テスト用 Mac の **Client Info** → **Filesets Status** を開き、両方のファイルセットがアクティブになっていることを確認します。

テスト用 Mac で、以下を確認します。

1.  システム拡張機能が有効になっていること:

    ```bash
    systemextensionsctl list | grep aikido
    ```

    拡張機能が `[activated enabled]` と表示されていることを確認します。
2. **システム設定** → **一般** → **ログイン項目と機能拡張** を開き、Aikido Device Protection の項目をオフに切り替えられないことを確認します。
{% endstep %}
{% endstepper %}

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


| 問題                                              | 対処法                                                                                                  |
| ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| ユーザーにポップアップが引き続き表示される                            | 構成プロファイルのスコープが正しく設定され、パッケージポリシーの実行前にインストールされていることを確認してください |
| 拡張機能がユーザーの承認待ちになっている               | System Extensions ペイロードを確認し、チーム ID とバンドル ID が完全に一致していることを確認してください              |
| パッケージはインストールされるが、デバイスが接続されない | パッケージのインストール前にトークンスクリプトが実行され、トークンが正しくコピーされていることを確認してください      |
| 拡張機能のエントリが重複して表示される                   | デバイスを再起動してください                                                                                    |
| コンテンツフィルタがサイレントで承認されない          | `.mobileconfig` プロファイルを再アップロードし、デバイスにインストールされていることを確認してください                       |