# Scalefusion を使用して macOS に Aikido Device Protection をデプロイする

Scalefusion を使用して、必要な権限を設定した状態で、管理対象の 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. Scalefusion Dashboard で、**Device Profiles & Policies** → **Device Profiles** に移動し、対象とする macOS Device Profile を編集します。
2. プロファイル内で **Advanced Configurations** セクションを開き、ペイロードエディターにアクセスします。
3. `.mobileconfig` の内容をペイロードエディターに貼り付けるか、**IMPORT FILES** を使用して `.mobileconfig` を直接アップロードします。
4. **VALIDATE** をクリックし、緑色のチェックマークを確認します。
5. **SAVE** をクリックして、プロファイル内のデバイスにペイロードをプッシュします。

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

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

1. Scalefusion Dashboard で、**Enterprise** → **My Apps** → **Enterprise Store** に移動します。
2. **Upload New App** → **Upload macOS App** をクリックします。
3. Aikido Device Protection の `.pkg` ファイルをアップロードします（またはクラウドストレージでホストされているファイルへのリンクを指定します）。
4. **App Name**、**Bundle ID**、**App Version** を確認し、**SAVE** をクリックします。

{% hint style="warning" %}
Scalefusion は**署名済み**の PKG ファイルのみを配布します。ダッシュボードからダウンロードした Aikido Device Protection インストーラーは署名済みのため、そのままアップロードしてください。再パッケージ化や再署名はしないでください。
{% endhint %}
{% endstep %}

{% step %}
**デバイスにデプロイする**

1. 前の手順の **Advanced Configurations** ペイロードが、対象の macOS Device Profile 内のすべてのデバイスに適用されていることを確認します。
2. **Enterprise Store** に戻り、アップロードした Aikido Device Protection アプリを選択します。
3. **PUBLISH** をクリックし、同じ Device Profile を選択します。
4. もう一度 **PUBLISH** をクリックして確定します。
{% endstep %}

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

1. Scalefusion Dashboard で **Devices** に移動し、対象の各デバイスを選択します。
2. **Actions** をクリックし、**Restart** を選択します。

{% hint style="info" %}
Restart アクションを使用するには、デバイスが監視対象（supervised）である必要があります。デバイスが監視対象でない場合は、`sudo reboot` を実行するスクリプトジョブで再起動をトリガーしてください。
{% endhint %}

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

{% step %}
**デプロイを確認する**

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

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

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

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

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


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