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

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

{% hint style="info" %}
開始する前に、すべてのデバイスが Rippling Device Management for Windows に登録されている必要があります。
{% endhint %}

## インストール

{% stepper %}
{% step %}
**必要なもの**

開始する前に、Aikido Device Protection ダッシュボードから以下を用意してください。

* **PowerShell インストールコマンド**（ダッシュボードのユーザーグループセレクターからコピーしたもの。トークンとインストーラーのダウンロードが含まれます）

お持ちでない場合は、[Aikido Device Protection ダッシュボード](https://app.aikido.dev/endpoint-protection/devices)に戻り、**Connect Device** をクリックしてください。
{% endstep %}

{% step %}
**管理対象デバイスでインストールコマンドを実行する**

1. Rippling で **IT** → **Device Management** → **Scripts**（Windows 用の PowerShell スクリプトライブラリ）に移動します。
2. **New script** をクリックし、スクリプトの種類として **PowerShell** を選択します。
3. **Name** を設定します（例: 「Install Aikido Device Protection」）。
4. インストーラーが Program Files への書き込みとサービスの登録を行う権限を持てるように、**Run as** コンテキストを **SYSTEM** に設定します。
5. 対象の各デバイスでスクリプトが 1 回だけ実行されるように、**Schedule** を **Run once** に設定します。
6. Aikido Device Protection ダッシュボードからコピーした PowerShell インストールコマンドをスクリプト本文に貼り付けます。
7. **Save** をクリックし、次に **Deploy** をクリックして、対象の従業員またはデバイスグループを選択します。

{% hint style="info" %}
PowerShell コマンドには Device Protection トークンが含まれており、最新のインストーラーをダウンロードしてサイレントインストールします。追加の MSI をアップロードする必要はありません。
{% endhint %}
{% endstep %}

{% step %}
**ロックダウンポリシーを適用する**

1. Rippling で **IT** → **Device Management** → **Scripts** に移動し、**New script** をクリックします。
2. **PowerShell** を選択し、**Run as** を **SYSTEM** に、**Schedule** を **Run once** に設定します。
3. 次のスクリプトを本文に貼り付けます。

```powershell
$tmp = "$env:TEMP\aikido-applocker.xml"
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/AikidoSec/safechain-internals/refs/heads/main/docs/aikido-applocker-deny-mdm.xml" -OutFile $tmp
Set-AppLockerPolicy -XmlPolicy $tmp -Merge
Remove-Item $tmp -Force
```

4. **Save** をクリックし、次に同じデバイスグループに **Deploy** します。
{% endstep %}

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

Rippling のデバイス一覧には、Windows 用のワンクリック再起動アクションがありません。短いスクリプトで再起動を実行してください。

1. Rippling で **IT** → **Device Management** → **Scripts** に移動し、**New script** をクリックします。
2. **PowerShell** を選択し、**Run as** を **SYSTEM** に、**Schedule** を **Run once** に設定します。
3. 次の内容をスクリプト本文に貼り付けます。

```powershell
shutdown.exe /r /t 60 /c "Restarting to activate Aikido Device Protection"
```
4. **Save** をクリックし、次にインストーラーを配布したのと同じデバイスグループに **Deploy** します。

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

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


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