Skip to main content

Deploy Endpoint Protection

GitGuardian Endpoint Protection requires the deployment of ggshield onto each machine so it runs scheduled scans, and deploy Honeytokens. The outcome you validate in GitGuardian is visibility: fleet coverage and discovered secrets in the GitGuardian's Endpoints Protection section. Plan for both the MDM rollout and how your team will use that dashboard after the first scans complete.

The recommended and currently validated approach is an MDM scheduled script. The table below summarizes all supported deployment approaches.

OptionBest fitGuidance
MDM scheduled scriptManaged macOS or Linux endpointsRecommended starting point; this is the approach validated in the current implementation.
MDM install + local scheduleEndpoints that need to scan even when MDM does not trigger jobs reliablyUse launchd on macOS or systemd on Linux; validate in your environment before broad rollout.
Config managementServer or mixed fleetsTools like Ansible, Puppet, Chef, or Salt can install ggshield and create the recurring job.

Regardless of the approach, the core setup steps are the same: deploy ggshield at scale with a service account token.