Deploy Device Protection with ManageEngine
Use ManageEngine Endpoint Central to deploy Aikido Device Protection across your managed Windows fleet with the required permissions in place.
All devices must be enrolled in ManageEngine Endpoint Central Windows management before you begin.
Installation
What you'll need
Before starting, make sure you have the following from the Aikido Device Protection dashboard:
- Your PowerShell install command (copied from the user group selector on the dashboard, includes token + installer download)
If you're missing it, go back to the Aikido Device Protection dashboard, click Connect Device.
Run the install command on managed devices
- In Endpoint Central, go to Configurations → Add Configurations → Windows → Scripts → Custom Script.
- Give the script a name (e.g. "Aikido Device Protection install").
- Set Run as to System User so the installer has the privileges to write to Program Files and register the service.
- Set the execution frequency to Once so the script runs a single time on each target device.
- Paste the PowerShell install command copied from the Aikido Device Protection dashboard into the script body.
- Click Save and Publish, then assign the configuration to the target devices or device groups.
The PowerShell command bundles your Device Protection token, downloads the latest installer, and installs silently. There is no extra MSI to upload.
Apply the lockdown policy
Block uninstallation of the Aikido Device Protection application.
Block uninstallation via AppLocker
- Create a new Custom Script configuration using the same steps above.
- Give it a name (e.g. "Aikido - AppLocker uninstall block").
- Paste the following PowerShell script into the script body:
$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- Click Save and Publish and assign it to the target devices or device groups.
Reboot devices after installation
- In Endpoint Central, go to Tools → Shutdown/Restart.
- Select the target Windows devices from the list.
- Choose Restart and click Proceed.
The agent fully activates on the next boot.
Troubleshooting
| Problem | Fix |
|---|---|
| Device doesn't appear in the dashboard after the script runs | Reboot the device; the agent fully registers on the next boot |
| Script exits with an error in the MDM console | Run the script manually as SYSTEM on a test host to see the full error; confirm the device has internet access to download the installer |
| Agent service is not running | Reboot the device; if the service is still absent, re-run the install script |
| Script is blocked by execution policy | Scripts run via MDM execute as SYSTEM and bypass user-level execution policy restrictions; confirm the MDM is not applying an additional policy that restricts script execution |
| Device shows as inactive after installation | The agent needs a reboot to fully activate; check back after rebooting |