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

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

{% hint style="info" %}
開始する前に、すべてのデバイスをRippling MDMに登録しておく必要があります。
{% 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. Ripplingで **IT** → **Device Management** → **Configurations** に移動し、**macOS** タブを選択します。
2. **Upload** をクリックします。
3. **Policy name** を入力します（例：「Aikido Device Protection」）。
4. **Platform** を **macOS** に設定します。
5. `.mobileconfig` ファイルをドロップまたは選択します。
6. **Save & continue** をクリックします。

{% hint style="info" %}
Ripplingでは、`.mobileconfig` のアップロードをMacから行う必要があります。他のオペレーティングシステムからアップロードすると、エラーが表示されずに失敗する場合があります。
{% endhint %}

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

{% step %}
**構成プロファイルを展開する**

1. **Configurations** で **Everything Else** タブに切り替えます。
2. 作成したプロファイルを見つけます。
3. 右側の **三点メニュー** をクリックし、**Deploy** を選択します。
4. 対象の従業員またはデバイスを選択し、**Save** をクリックします。
{% endstep %}

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

1. Ripplingで **IT** → **Software** に移動します。
2. **Upload Software** をクリックします。
3. 以下のフィールドに入力します。
   * **Name:** Aikido Device Protection
   * **Operating System:** macOS
   * **Description:** Aikido Device Protection
4. **Upload Installer File** で、Aikido Device Protectionの `.pkg` ファイルをドロップまたは選択します。
5. **Submit** をクリックします。
7. 新しく作成されたソフトウェア項目の **Add** をクリックし、**Finished Selecting** をクリックします。
{% endstep %}

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

1. **Aikido Device Protection** 構成プロファイルがテストデバイスにインストールされていることを確認します。
2. **IT** → **Software** で **Aikido Device Protection** ソフトウェア項目を見つけ、**Edit** をクリックし、対象の従業員またはデバイスを選択して **Save** をクリックします。

{% hint style="info" %}
Ripplingで新しく作成されたソフトウェア項目は、展開可能になるまで数分間「Pending」ステータスのままになる場合があります。
{% endhint %}
{% endstep %}

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

1. Ripplingで **IT** → **Devices** に移動します。
2. 対象のデバイスを選択し、一括操作メニューから **Restart** を選択します（または個別のデバイスを開き、デバイス操作から **Restart** を選択します）。

エージェントは次回の起動時に完全に有効になります。
{% endstep %}

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

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

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

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

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

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


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