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

Ivanti Neurons for MDM を使用して、必要な権限を設定したうえで、管理対象の Windows デバイス全体に Aikido Device Protection をデプロイします。

{% hint style="info" %}
開始する前に、すべてのデバイスが Ivanti Neurons のモバイルデバイス管理（MDM）に登録されている必要があります。PowerShell スクリプトの実行には Ivanti Bridge が必要です。Ivanti Bridge は Ivanti Secure UEM パッケージ（旧 Gold）に含まれています。Ivanti Bridge は Windows 10 Home をサポートしていません。
{% endhint %}

## 前提条件

* [Aikido アプリ](https://app.aikido.dev/endpoint-protection/devices?regionRedirect=1)の **PowerShell インストールコマンド**。**Connect Device** をクリックしてコピーします。
* 対象デバイスにインストールされた Ivanti Bridge。Ivanti はデフォルトで Bridge アプリを **App Catalog** に追加し、すべてのデバイスに配布します。**Apps** → **App Catalog** にあり、デバイスに配布されていることを確認してください。

## Device Protection をデプロイする

{% stepper %}
{% step %}
### インストールスクリプトを保存する

1. Aikido アプリの PowerShell インストールコマンドを `aikido-install.ps1` として保存します。
2. Ivanti Neurons for MDM で、**Admin** → **Scripts** → **All Scripts** に移動し、**+ Add** をクリックします。
3. 名前を入力します（例：「Aikido Device Protection install」）。
4. **Platform type** で **Windows** を選択し、**Script Type** を **ps1** に設定します。
5. **Import code from a Script** をクリックし、`aikido-install.ps1` を選択して **Import** をクリックします。
6. **Save** をクリックします。
{% endstep %}

{% step %}
### Ivanti Bridge でスクリプトを実行する

1. **Configurations** に移動し、**+ Add** をクリックします。
2. **Ivanti Bridge for Windows Scripts and Actions Configuration** を選択します。
3. 名前を入力します（例：「Aikido Device Protection install」）。
4. **Configure Ivanti Bridge** セクションで **Select scripts from Scripts Library** を選択し、「Aikido Device Protection install」スクリプトを選択します。
5. **Next** をクリックします。
6. テストデバイスを含むディストリビューションを選択し、**Done** をクリックします。

スクリプトはインストーラーをダウンロードし、ユーザーグループトークンに対してデバイスを登録し、サイレントインストールを実行します。結果はデバイスの詳細ページの **Logs** タブで確認できます。
{% endstep %}

{% step %}
### AppLocker でアンインストールをブロックする

1. **Configurations** に移動し、**+ Add** をクリックして検索フィールドに「custom」と入力し、**Custom** をクリックします。
2. 名前を入力します（例：「Aikido Device Protection uninstall block」）。
3. **Choose OS** で Windows アイコンをクリックし、**Custom CSP OMA-URI Schema Node** を選択します。
4. **ACTIONS** で **+** をクリックし、以下を設定します：
   * **Description**：`Aikido AppLocker uninstall block`
   * **OMA-URI**：`./Vendor/MSFT/AppLocker/ApplicationLaunchRestrictions/Aikido/MSI/Policy`
   * **Data type**：**CHARACTER**
   * **Value**：[aikido-applocker-deny-mdm.xml](https://raw.githubusercontent.com/AikidoSec/safechain-internals/refs/heads/main/docs/aikido-applocker-deny-mdm.xml) の内容を貼り付けます（リンクを開き、XML テキスト全体をコピーしてここに貼り付けます）
   * **Access Type**：**Add**
5. **Save & Close** をクリックし、**Next** をクリックします。
6. インストールスクリプトと同じディストリビューションを選択し、**Done** をクリックします。

{% hint style="info" %}
エンドユーザーがローカル管理者の場合、AppLocker ルールを回避できます。より強力に適用するには、このポリシーを App Control for Business（WDAC）およびローカル管理者権限の削除と組み合わせてください。
{% endhint %}
{% endstep %}

{% step %}
### デバイスを再起動する

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

1. **Devices** に移動し、**Name** 列のテストデバイスをクリックします。
2. **Actions** → **Restart/Shutdown device** をクリックします。
3. **Restart Device** を選択し、**Send to Device** をクリックします。

複数のデバイスを一度に再起動するには、**Devices** リストでデバイスを選択し、**Actions** → **Restart/Shutdown Device** をクリックします。

テストデバイスで問題がなければ、両方の構成のディストリビューションを残りのデバイス全体に変更します。
{% endstep %}
{% endstepper %}

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


| 問題 | 対処法 |
| ------- | --- |
| スクリプトの実行後、デバイスがダッシュボードに表示されない | デバイスを再起動してください。エージェントは次回の起動時に登録が完了します |
| MDM コンソールでスクリプトがエラーで終了する | テストホスト上でスクリプトを SYSTEM として手動で実行し、エラーの詳細を確認してください。また、デバイスがインストーラーをダウンロードするためにインターネットにアクセスできることを確認してください |
| エージェントサービスが実行されていない | デバイスを再起動してください。それでもサービスが存在しない場合は、インストールスクリプトを再実行してください |
| スクリプトが実行ポリシーによってブロックされる | MDM 経由で実行されるスクリプトは SYSTEM として実行されるため、ユーザーレベルの実行ポリシーによる制限を受けません。MDM がスクリプトの実行を制限する追加のポリシーを適用していないことを確認してください |
| インストール後、デバイスが非アクティブと表示される | エージェントを完全に有効化するには再起動が必要です。再起動後にもう一度確認してください |
