# IvantiでDevice Protectionを展開する

Ivanti Neurons for MDMを使用して、必要な権限を設定した状態で、管理対象のmacOSフリート全体にAikido Device Protectionを展開します。

{% hint style="info" %}
開始する前に、すべてのMacがIvanti Neuronsのモバイルデバイス管理（MDM）に登録されている必要があります。カスタム構成にはIvanti Silverライセンス以上が必要です。
{% endhint %}

## 前提条件

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

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

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

## Device Protectionを展開する

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

1. Ivanti Neurons for MDMで、**Configurations**に移動し、**+ Add**をクリックします。
2. 検索フィールドに「custom」と入力し、**Custom**をクリックします。
3. 名前を入力します（例：「Aikido Device Protection profile」）。
4. **Choose OS**で、macOSアイコンをクリックします。
5. `.mobileconfig`ファイルをドロップボックスにドラッグするか、**Choose File**をクリックして選択します。
6. **Next**をクリックします。
7. **Who does this configuration apply to**を**Device Wide**に設定します。
8. テスト用Macを含むディストリビューションを選択し、**Done**をクリックします。

{% hint style="warning" %}
`.mobileconfig`は変更せずにそのままアップロードしてください。Ivantiの組み込みmacOS構成で再作成せず、**Device Wide**を選択したままにしてください。
{% endhint %}

このプロファイルにより、Aikido Device Protectionのシステム拡張機能がサイレントに読み込まれ、ネットワークコンテンツフィルターが有効になり、ユーザーが**System Settings** → **Login Items**でバックグラウンドサービスを無効にすることを防ぎます。
{% endstep %}

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

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

1. **Apps** → **App Catalog**に移動し、**Add**をクリックします。
2. **Select the platforms to upload file**で、**Apple Apps**を選択し、次に**macOS**を選択します。
3. Aikido Device Protectionの`.pkg`をドロップボックスにドラッグするか、**Choose File**をクリックして選択し、**Confirm**をクリックします。
4. **Next**をクリックし、説明ページは変更せずに進めます。
5. テスト用Macを含むディストリビューションを選択します。
6. **Advanced Options & App Configuration**を展開し、**Install on Device**を有効にします。
7. **Done**をクリックします。

{% hint style="info" %}
Aikidoアプリから取得した署名済みの`.pkg`をそのままアップロードしてください。MobileIron Packagerで再パッケージ化しないでください。
{% endhint %}
{% endstep %}

{% step %}
### Macを再起動する

エージェントは次回の起動時に完全に有効化されます。

1. **Devices**に移動し、**Name**列でテスト用Macをクリックします。
2. **Actions** → **Restart/Shutdown device**をクリックします。
3. **Restart Device**を選択し、**Send to Device**をクリックします。

複数のMacを一度に再起動するには、**Devices**リストでそれらを選択し、**Actions** → **Restart/Shutdown Device**をクリックします。
{% endstep %}

{% step %}
### 展開を確認する

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

1.  システム拡張機能が有効化されていること：

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

    拡張機能が`[activated enabled]`と表示されていることを確認します。
2. **System Settings** → **General** → **Login Items & Extensions**を開き、Aikido Device Protectionの項目をオフに切り替えられないことを確認します。

テスト用Macで問題がなければ、構成とアプリのディストリビューションをフリートの残りのデバイスに変更します。
{% endstep %}
{% endstepper %}

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


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