How Does Device Protection Work?
Aikido Device Protection installs a lightweight Layer 4 proxy on each device. It only inspects supported package manager traffic. Everything else bypasses it.
Decisions happen on the device
All allow and block decisions happen locally. Aikido does not receive your traffic, browsing history, or downloaded files.
The agent downloads only the data it needs to enforce policy:
Allowlists and blocklists
Malware signatures
Policy rules and exceptions
After that sync, the device can enforce rules on its own.
What data Aikido receives and when
Package contents stay on the device, and general browsing stays invisible to Aikido. The agent only reports install outcomes and installed packages:
Allowed installs
Blocked installs
Flagged installs
Installed packages
Installed packages are compiled into an SBOM (a software bill of materials, the inventory of packages in use), generated and synced once a day. Install outcomes are reported immediately, and the agent sends a heartbeat every 10 minutes so you know it's online.
The agent needs outbound internet access to reach Aikido. Allowlist *.aikido.dev over HTTPS on port 443.
It only intercepts supported ecosystems
The proxy is not a general web filter. It only intercepts supported package ecosystems. All other traffic passes through unchanged.
Supported package managers use HTTPS. To inspect that traffic, the agent uses a local Certificate Authority (CA) on the device. It is only used for the ecosystems Aikido monitors.
These are the domains Aikido Device Protection intercepts. The list contains package registries, developer tool marketplaces, and Aikido's own protection endpoints.
How the CA works
Aikido uses a two-tier CA model:
Intermediate CA: deployed to the device via MDM, or generated locally by the agent. This CA is unique per customer and its private key is stored in Apple's protected storage (Secure Enclave / Keychain), which prevents the key from being read or exported even by the device owner.
Short-lived proxy CA: signed by the root CA at runtime. This is the CA the proxy uses to inspect package manager traffic. It is valid for a maximum of 4 days. If it is ever extracted from memory, it expires quickly and cannot be used to sign further CAs (intermediate-only enforcement is applied at signing time).
The root CA never leaves the device. The proxy CA is re-signed automatically before it expires.
CA file location on macOS:
/Library/Application Support/AikidoSecurity/EndpointProtection/run/endpoint-protection-combined-ca.pem
Limitations
Aikido Device Protection is not a virus scanner. It does not inspect files, processes, or your system for existing threats. Instead, it works by blocking malware before it can reach your device. This means that if malware is already present on a device, Aikido Device Protection will not detect or remove it, and the device should be considered compromised.
Aikido Device Protection currently does not support Docker or Podman on macOS
Last updated
Was this helpful?