# AddigyでmacOSにAikido Device Protectionを展開する

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

## インストール

{% stepper %}
{% step %}
**必要なもの**

開始する前に、Aikido Device Protectionダッシュボードから以下を用意してください。

* **Aikido Device Protection `.mobileconfig`**（[Aikido Device Protectionダッシュボード](https://app.aikido.dev/endpoint-protection/devices)からダウンロード）
* **Aikido Device Protectionインストーラー**（`.pkg`ファイル、ダッシュボードからダウンロード）

いずれかが不足している場合は、[Aikido Device Protectionダッシュボード](https://app.aikido.dev/endpoint-protection/devices)に戻り、**Connect Device**をクリックして、事前準備の手順を完了してください。
{% endstep %}

{% step %}
**Aikido Device Protection構成プロファイルを追加する**

1. Addigyコンソールで、**Catalog** → **Device Settings**に移動します。
2. **New**をクリックし、**Custom Profile**を選択します。
3. `.mobileconfig`ファイルをアップロードし、プロファイルに名前を付けます（例：「Aikido Device Protection」）。
4. **Save**をクリックします。
5. プロファイルの横にある三点メニュー（**...**）をクリックし、**Assignments**を選択して、対象のポリシーを選び、**Save**をクリックします。

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

{% step %}
**Aikido Device Protectionインストーラーをアップロードして設定する**

1. Addigyコンソールで、**Catalog** → **Software** → **Smart Software**に移動します。
2. **New**をクリックし、項目に名前を付けます（例：「Aikido Device Protection」）。
3. **Select File(s)**をクリックしてFile Managerを開き、Aikido Device Protectionの`.pkg`をアップロードします。
4. アップロードしたファイルを選択して、項目に添付します。
5. **Install Command**の下にある**Auto-fill**をクリックします。Addigyがインストーラーコマンドを自動的に生成します。
6. **Save**をクリックします。
7. Smart Software項目の横にある三点メニュー（**...**）をクリックし、**Assignments**を選択して、同じ対象ポリシーを選び、**Save**をクリックします。
{% endstep %}

{% step %}
**デバイスに展開する**

1. **Aikido Device Protection**構成プロファイルがインストールされていることを確認します。**Catalog** → **Device Settings**でプロファイルを開き、割り当てステータスにすべての対象デバイスが表示されていることを確認してください。
2. **Aikido Device Protection** Smart Softwareをポリシーに割り当てて展開をトリガーします（または次回のポリシーチェックインの実行を待ちます）。
{% endstep %}

{% step %}
**インストール後にデバイスを再起動する**

エージェントのインストールが完了したら、対象デバイスを再起動してください。Addigyでは、**GoLive** → **Device Status** → **Device Commands** → **Restart**からデバイスごとに再起動できます。エージェントは次回の起動時に完全に有効化されます。
{% endstep %}

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

テストデバイスで、以下を確認します。

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

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

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

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


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