For the complete documentation index, see llms.txt. This page is also available as Markdown.

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:

  1. 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.

  2. 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?