Skip to main content

Agent Secrets

Agent secrets authenticate Mac clients. Create the shared Orbit/osquery secret from Hosts > Enroll Hosts or the osquery overview. Santa and Munki secrets live on their integration overviews.

SecretUsed by
orbitOrbit and osquery enrollment
santaSanta sync
munkiMunki repository requests

Each secret must be at least 32 characters.

Orbit and osquery​

Orbit and osquery send the shared enrollment secret once. The server returns a node key for later requests. The other protocol's first enrollment attaches to the same host. Re-enrollment retains the host identity and dependent state while replacing that protocol's node key.

Santa and Munki​

Santa and Munki send their shared secret as a bearer token:

Authorization: Bearer <secret>

Agent secrets are separate from account passwords and API keys.