Aller au contenu principal

ggshield machine setup

Description​

Configurez la protection ggshield sur cette machine.

ggshield machine setup [OPTIONS]

Configure chaque protection en une seule exécution idempotente : le hook IA de ggshield pour chaque assistant de code IA détecté, les hooks git globaux pre-commit/pre-push, et un honeytoken pour détecter les intrusions sur les endpoints. Peut être réexécuté en toute sécurité — il ajoute ce qui manque et laisse les entrées existantes intactes.

Chaque protection est activée par défaut ; désactivez-en une avec --no-ai-hooks, --no-git-hooks ou --no-honeytokens. --agent / --exclude-agent restreignent les assistants qui reçoivent le hook IA. Lorsqu'il est exécuté en tant que root (ou avec --system), les hooks git sont installés à l'échelle de la machine pour chaque utilisateur.

Options​

  • --no-ai-hooks : Ne pas configurer les hooks des assistants IA.
  • --no-git-hooks : Ne pas installer les hooks git globaux.
  • --no-honeytokens : Ne pas planter de honeytoken sur cette machine.
  • --agent ASSISTANT : Configurer le hook IA uniquement pour ces assistants (répétable). Par défaut, tous les assistants détectés sur cette machine.
  • --exclude-agent ASSISTANT : Ignorer ces assistants lors de la configuration du hook IA (répétable).
  • --system : Installer les hooks git à l'échelle de la machine (tous les utilisateurs) au lieu de l'utilisateur actuel. Implicite lors de l'exécution en tant que root, par exemple sous un MDM.

Cette commande prend en charge toutes les options globales de ggshield.