# Jamf で Device Protection をデプロイする

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

{% hint style="info" %}
この手順は Jamf Pro を前提としています。Jamf School を使用している場合、メニューやペイロード名が異なる場合があります。
{% 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 %}
**アップロード前に `.mobileconfig` に署名する**

{% hint style="warning" %}
Jamf Pro にアップロードする前に、`.mobileconfig` に**必ず**署名してください。Jamf Pro は Aikido Device Protection が使用する新しい Apple ペイロードの一部をサポートしていないため、署名されていないプロファイルは正しくデプロイされません。
{% endhint %}

Jamf Pro の組み込み CA の署名証明書を使用して、ダウンロードした `.mobileconfig` に署名します。Jamf のガイドに従ってください：[Creating a Signing Certificate Using Jamf Pro's Built-in CA](https://learn.jamf.com/r/en-US/technical-articles/Creating_a_Signing_Certificate_Using_Jamf_Pros_Built-in_CA_to_Use_for_Signing_Configuration_Profiles_and_Packages)。
{% endstep %}

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

1. Jamf Pro で、**アップロード**機能を使用して macOS 用の**構成プロファイル**として追加します。
2. 署名済みの `.mobileconfig` ファイルをアップロードします。
3. 対象デバイスにスコープを設定します。

{% hint style="info" %}
Jamf Pro の **VPN** ペイロードで **Server** のホスト名または IP アドレスを求めるエラーが表示された場合は、`127.0.0.1` を入力してください。これは Jamf Pro の既知の制限で、Aikido Device Protection が使用するプロキシペイロードを完全にはサポートしていないためです。
{% endhint %}

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

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

1. Jamf Pro で、**Settings** → **Packages** に移動します。
2. Aikido Device Protection の `.pkg` をアップロードします。
3. ポリシーで使用する前に、パッケージの処理が完了していることを確認します。
{% endstep %}

{% step %}
**インストールポリシーを作成する**

1. Jamf Pro で、**Computers** → **Policies** に移動します。
2. 同じデバイスをスコープとする新しいポリシーを作成します。
3. アップロードした Aikido Device Protection パッケージをポリシーに追加します。
4. ポリシーの **Execution Frequency** を **Once per computer** に設定します。

{% hint style="warning" %}
**Execution Frequency** を **Ongoing** のままにすると、定期的なチェックインのたびにポリシーがパッケージを再インストールし、古いビルドが再デプロイされる可能性があります。パッケージはデバイスごとに 1 回だけインストールしてください。
{% endhint %}
{% endstep %}

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

1. **Aikido Device Protection** 構成プロファイルをデプロイします。
2. すべての対象デバイスに配布されたことを確認します。Jamf Pro コンソールでプロファイルのステータスを確認してください。
3. **Aikido Device Protection** インストールポリシーをデプロイします。
{% endstep %}

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

1. Jamf Pro で、**Computers** → **Policies** に移動し、新しいポリシーを作成します。
2. **Restart Options** ペイロードを追加し、**Restart** に設定します。
3. 同じ対象デバイスにスコープを設定し、エージェントパッケージのインストール後にトリガーされるようにします。

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

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

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

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

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

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

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


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