# MosyleでAikido Device Protectionを展開する

Mosyle Businessを使用して、必要な権限を設定した状態で、管理対象の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. Mosyle管理コンソールで、**Management** → **Manage** **macOS** → **Management Profiles（サイドバー）**に移動します。<br>
2. 「**Certificates / Custom Profiles**」をクリックし、名前を付けます（例：「Aikido Device Protection」）。
3. Select Fileから`.mobileconfig`ファイルをアップロードします。
4. **Add Assignment**で、**System**スコープを指定して対象のデバイスグループを選択します。
5. **Save**をクリックします。

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

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

1. ステップ3と同じ画面で、サイドバーの**Management Profiles**の下にある**Install PKG**をクリックします。
2. **「Already have a .PKG」**を選択します。
3. 「Host your .PKG file」で「**Automatically set App info**」を選択します。
4. 公開URL「[https://github.com/AikidoSec/safechain-internals/releases/latest/download/EndpointProtection.pkg](https://github.com/AikidoSec/safechain-internals/releases/latest/download/EndpointProtection.pkg)」を使用し、**「This app is Signed」**と**「Install as Managed」を有効に**します。「Add Enterprise App」で続行します。<br>
5. プロファイルに名前を付けます（例：「Aikido Device Protection - Pkg」）。
6. **Add Assignment**で、同じ対象デバイスグループを選択します。
7. **Save**をクリックします。
{% endstep %}

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

1. **Aikido Device Protection**構成プロファイルがインストールされていることを確認します。プロファイルを開いて**View Results**をクリックし、すべての対象デバイスが緑色で表示されていることを確認してください。
2. **Install PKG**展開プロファイルを保存して割り当てます。
{% endstep %}

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

エージェントパッケージのインストールを確認した後、対象デバイスを再起動してください。まずInstall PKGプロファイルの**View Results**を確認します。エージェントは次回起動時に完全に有効になります。
{% endstep %}

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

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

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

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

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

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


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