Deploy Device Protection with Ivanti
Use Ivanti Neurons for MDM to deploy Aikido Device Protection across your managed macOS fleet with the required permissions in place.
All Macs must be enrolled in Ivanti Neurons for mobile device management (MDM) before you begin. Custom configurations need an Ivanti Silver license or higher.
#Prerequisites
Download the following from the Aikido app:
- The Aikido Device Protection
.mobileconfig - The Aikido Device Protection installer (
.pkgfile)
If you're missing any of these, go to the Aikido app, click Connect Device, and complete the pre-flight steps.
#Deploy Device Protection
#Add the configuration profile
- In Ivanti Neurons for MDM, go to Configurations and click + Add.
- Type "custom" in the search field, then click Custom.
- Enter a name, for example "Aikido Device Protection profile".
- Under Choose OS, click the macOS icon.
- Drag the
.mobileconfigfile into the drop box, or click Choose File to select it. - Click Next.
- Set Who does this configuration apply to to Device Wide.
- Select a distribution with your test Mac, then click Done.
Upload the
.mobileconfigunchanged. Don't rebuild it with Ivanti's built-in macOS configurations, and keep Device Wide selected.This profile allows the Aikido Device Protection system extension to load silently, enables the network content filter, and stops users from disabling background services in System Settings → Login Items.
#Add the installer
Deploy the profile first so the system extension is already approved when the installer runs.
- Go to Apps → App Catalog and click Add.
- Under Select the platforms to upload file, select Apple Apps, then select macOS.
- Drag the Aikido Device Protection
.pkginto the drop box, or click Choose File to select it, then click Confirm. - Click Next and step through the description pages without changes.
- Select a distribution with your test Mac.
- Expand Advanced Options & App Configuration and enable Install on Device.
- Click Done.
Upload the signed
.pkgfrom the Aikido app as-is. Don't repackage it with MobileIron Packager.#Restart the Mac
The agent fully activates on the next boot.
- Go to Devices and click the test Mac in the Name column.
- Click Actions → Restart/Shutdown device.
- Select Restart Device, then click Send to Device.
To restart several Macs at once, select them in the Devices list and click Actions → Restart/Shutdown Device.
#Verify the deployment
On the test Mac, confirm:
-
The system extension is activated:
systemextensionsctl list | grep aikidoExpect to see the extension marked
[activated enabled]. -
Open System Settings → General → Login Items & Extensions and confirm the Aikido Device Protection entries can't be toggled off.
Once the test Mac passes, change the distribution of the configuration and the app to the rest of your fleet.
-
#Troubleshooting
| Problem | Fix |
|---|---|
| Users still see the popup | Make sure the configuration profile is scoped correctly and installed before the package policy runs |
| Extension is waiting for user approval | Check the System Extensions payload and confirm the team ID and bundle ID match exactly |
| The package installs but the device does not connect | Confirm the token script ran before the package install and that the token was copied correctly |
| Duplicate extension entries appear | Reboot the device |
| The content filter is not approved silently | Re-upload the .mobileconfig profile and verify it is installed on the device |