# Miradore を使用して macOS に Aikido Device Protection を展開する

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

{% hint style="info" %}
パッケージとスクリプトの展開には、Miradore の **Premium** または **Premium+** サブスクリプションが必要です。
{% endhint %}

## インストール

{% 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. Miradore 管理コンソールで、**Management** → **Configuration profiles** に移動します。
2. **Add** → **macOS** → **Advanced (custom)** をクリックします。
3. `.mobileconfig` ファイルをアップロードします。
4. **Save** をクリックします。

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

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

1. Miradore 管理コンソールで、**Management** → **Applications** に移動します。
2. **Add** → **macOS application** → **PKG (Uploaded)** → **Next** をクリックします。
3. **Select file** をクリックし、Aikido Device Protection の `.pkg` をアップロードします。
4. 必須フィールドを入力します。
   * **Application name**（例: 「Aikido Device Protection」）
   * **Bundle identifier**（例: `dev.aikido.endpoint`）
   * **Version**
5. **Create** をクリックし、パッケージの処理が完了するまで待ってから続行します。
{% endstep %}

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

エージェントのインストールが完了したら、対象デバイスを再起動してください。エージェントは次回の起動時に完全に有効化されます。
{% endstep %}

{% step %}
**Business Policy を使用して展開する**

Business Policy を使用して、3 つの項目すべてを展開します。

1. Miradore 管理コンソールで、**Management** → **Business policies** に移動します。
2. **Add** をクリックし、ポリシーに名前を付けて、ステータスを **Disabled** に設定します。
3. 構成プロファイル、`.pkg`、再起動スクリプトの 3 つの項目すべてをポリシーに追加します。
4. 再起動スクリプトを選択し、**Actions** → **Edit item dependency** をクリックして、`.pkg` を依存関係として設定します。これにより、エージェントのインストール後にのみデバイスが再起動されます。
5. タグを使用して、ポリシーを対象デバイスに割り当てます。
6. ポリシーのステータスを **Enabled** に設定します。
{% endstep %}

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

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

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

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

    拡張機能が `[activated enabled]` と表示されることを確認します。
2. **システム設定** → **一般** → **ログイン項目と機能拡張** を開き、Aikido Device Protection の項目をオフに切り替えられないことを確認します。
3. 展開ステータスを確認するには、**Management** → **Action log** に移動し、**Sender** フィールドで「Business policy」でフィルタリングします。
{% endstep %}
{% endstepper %}

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


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