> For the complete documentation index, see [llms.txt](https://help.aikido.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aikido.dev/docs/docs-ja/aikido-device-protection/deploying-aikido-endpoint/device-protection-mdm-guides/device-protection-mdm-for-macos/deploy-aikido-endpoint-with-miradore.md).

# Miradore でデバイス保護を展開

必要な権限を設定した状態で、Miradore を使用して管理対象の macOS フリート全体に Aikido Device Protection を展開します。

{% hint style="info" %}
パッケージとスクリプトの展開には Miradore の **プレミアム** または **プレミアム+** サブスクリプションが必要です。
{% 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 管理コンソールで、次へ移動します **管理** → **構成プロファイル**.
2. クリック **追加** → **macOS** → **高度（カスタム）**.
3. 次をアップロードします `.mobileconfig` ファイル。
4. クリック **保存**.

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

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

1. Miradore 管理コンソールで、次へ移動します **管理** → **アプリケーション**.
2. クリック **追加** → **macOS アプリケーション** → **PKG（アップロード済み）** → **次に**.
3. クリック **ファイルを選択** そして Aikido Device Protection をアップロードします `.pkg`.
4. 必要な項目を入力します：
   * **アプリケーション名** （例:「Aikido Device Protection」）
   * **バンドル識別子** （例： `dev.aikido.endpoint`)
   * **バージョン**
5. クリック **作成** そして、続行する前にパッケージの処理が完了するまで待ちます。
   {% endstep %}

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

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

{% step %}
**Business Policy を使用して正しい順序で展開する**

Business Policy を使用して、3 つの項目を正しい順序で展開します。

1. Miradore 管理コンソールで、次へ移動します **管理** → **ビジネスポリシー**.
2. クリック **追加**、ポリシーに名前を付け、ステータスを **無効**.
3. 3 つの項目すべてをポリシーに追加します: 設定プロファイル、 `.pkg`、そして再起動スクリプト。
4. 項目の依存関係を使用して展開順序を設定します:
   * 次を選択します: `.pkg`、次をクリックします: **アクション** → **項目の依存関係を編集**、設定プロファイルを依存先として設定します。
   * 再起動スクリプトを選択し、クリック **アクション** → **項目の依存関係を編集**、そして次を設定し `.pkg` を依存先として設定します。
5. タグを使用して、対象デバイスにポリシーを割り当てます。
6. ポリシーのステータスを **有効**.

{% hint style="info" %}
Miradore では、各項目につき依存先は 1 つのみサポートされています。チェーンは「設定プロファイル → パッケージ → 再起動スクリプト」である必要があります。
{% endhint %}
{% endstep %}

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

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

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

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

   拡張機能に次の表示があることを確認します： `[activated enabled]`.
2. 開く **システム設定** → **全般** → **ログイン項目と拡張機能** そして、Aikido Device Protection の項目をオフに切り替えられないことを確認します。
3. 展開状況を確認するには、 **管理** → **アクションログ** 「Business policy」で絞り込み、 **送信者** フィールドに貼り付けます。
   {% endstep %}
   {% endstepper %}

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

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.aikido.dev/docs/docs-ja/aikido-device-protection/deploying-aikido-endpoint/device-protection-mdm-guides/device-protection-mdm-for-macos/deploy-aikido-endpoint-with-miradore.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.