Discuter de ce sujet avec une IA

Vous obtenez une réponse tirée de la documentation et la page d'où elle vient.

Installation et exploitation

Installer l'agent poison0 sur macOS

Installer, déployer, vérifier et retirer l'agent poison0 sur un Mac.

~4 min de lecture · Installation et exploitation

Prérequis

PrérequisDétails
ProcesseurApple M2 ou plus récent, ou un Mac Intel avec AVX2 (Intel Haswell, 2013, ou plus récent). Apple M1 n'est pas pris en charge.
DroitsDes droits administrateur. L'installeur s'exécute en root via sudo.
Clé d'installationUne clé d'installation de la console, sous Appareils → Déployer plusieurs appareils avec une clé.
Agents IAAu moins un agent IA parmi les agents pris en charge.

Installer un Mac

Lancez cette commande dans le Terminal.

bashTerminal
curl -fsSL https://poisonzero.com/install.sh | sudo PZ_ENROLL_CODE="<install-key>" sh

L'installeur vérifie le programme avec SHA256SUMS et s'arrête en cas d'écart. Puis il installe le service et enregistre le Mac. Dans un terminal, l'installeur demande s'il faut envoyer le nom de l'appareil à la console. Vous répondez Oui ou Non, il n'y a pas de valeur par défaut. Oui envoie le nom d'ordinateur du Mac, Non n'envoie aucun nom. Avec Jamf, Intune et les scripts sans terminal, il ne demande rien et n'envoie aucun nom.

Pour changer les valeurs par défaut, définissez les variables d'environnement sous Référence.

Vérifier le Mac

  1. Lancez launchctl print system/com.poisonzero.daemon. Le service doit tourner.
  2. Lancez poison0 doctor dans votre session de bureau. Il nomme ce qui ne va pas.
  3. Ouvrez la console. Le Mac apparaît sous Appareils.

poison0 répond aussi à p0 et pz. Si un autre programme utilise déjà l'un de ces noms, cet alias n'est pas créé.

Après la première installation, le modèle se télécharge en arrière-plan. Les règles fixes protègent tout de suite.

Déployer sur plusieurs Mac

Utilisez le paquet avec le profil de votre locataire ou, en alternative, un script de stratégie Jamf ou un script shell Intune. Tous s'exécutent en root.

Paquet et profil (Intune, Jamf)

C'est la méthode recommandée, elle n'exige aucun script. Vous attribuez aux mêmes Mac deux fichiers : le paquet poisonzero-<version>.pkg et le profil de votre locataire <slug>-poisonzero-macos.mobileconfig. Le paquet est signé (Developer ID Jon Knoll (RYR9QUYGWV)), notarisé par Apple et identique pour tous les clients. Le profil contient la clé d'installation de votre locataire et le réglage indiquant si le nom de l'ordinateur est envoyé comme nom d'appareil.

  1. Dans la console, ouvrez Appareils, déroulez Déployer plusieurs appareils avec une clé et choisissez Télécharger le paquet Intune. Sélectionnez l'onglet macOS.
  2. Facultatif : cochez Utiliser le nom de l'ordinateur comme nom d'appareil avant de télécharger le profil.
  3. Sous 1. Télécharger le paquet, téléchargez le paquet avec le lien.
  4. Sous 2. Télécharger le profil, téléchargez le profil avec Télécharger.

Étapes dans Intune :

  1. Ouvrez Applications → macOS → Ajouter, choisissez Application métier et chargez le paquet.
  2. Attribuez l'application à un groupe d'appareils sous Obligatoire.
  3. Ouvrez Appareils → macOS → Configuration → Créer → Nouvelle stratégie. Choisissez le type de profil Modèles → Personnalisé et le canal de déploiement Canal de l'appareil. Chargez le fichier .mobileconfig.
  4. Attribuez le profil au même groupe d'appareils.

Étapes dans Jamf Pro :

  1. Chargez le paquet sous Settings → Computer Management → Packages.
  2. Sous Computers → Policies, créez une stratégie qui installe le paquet (Packages → Install). Choisissez un trigger, par exemple Recurring Check-in, et définissez le scope sur vos Mac.
  3. Sous Computers → Configuration Profiles → Upload, chargez le fichier .mobileconfig.
  4. Définissez le scope du profil sur les mêmes Mac.

Paquet et profil vont aux mêmes Mac, dans n'importe quel ordre. Dès que les deux sont sur un Mac, il s'inscrit auprès de votre locataire. Si le profil arrive plus tard, un service en arrière-plan le détecte et inscrit alors le Mac. Sans le profil, le Mac ne se connecte pas à votre locataire. Vous voyez si PoisonZero fonctionne dans la console, sous Appareils.

Le profil contient une clé d'installation que voit tout administrateur autorisé à lire les profils dans votre MDM. La console la liste comme Intune macOS profile avec la date. Elle est valable un an, révoquez-la après le déploiement.

Pour retirer PoisonZero, lancez la désinstallation de Désinstaller. Pour une installation par paquet, elle supprime aussi le reçu du paquet. Retirez ensuite le paquet et le profil de l'attribution dans votre MDM. Le profil est aussi disponible par l'API d'administration : POST /v1/intune/macos-profile, voir API d'administration.

Installer l'agent

Jamf et Intune lancent le script sans terminal. Passez donc la clé en variable d'environnement. Dans Intune, ajoutez le script sous Appareils → macOS → Scripts shell et réglez Exécuter le script en tant qu'utilisateur connecté sur Non. Intune conserve le texte du script avec la clé : révoquez donc la clé dans la console après le déploiement. Nom de l'appareil : sans votre choix, PoisonZero n'envoie aucun nom et la console affiche un espace réservé. PZ_DEVICE_NAME_FROM_HOSTNAME=1 dans le script ci-dessous envoie le nom d'ordinateur de chaque Mac (Réglages Système → Général → Informations → Nom, le nom qu'Intune affiche). Retirez la variable pour n'envoyer aucun nom. Les variantes PZ_DEVICE_NAME et PZ_DEVICE_NAMES_CSV sont sous Référence. Le nom n'est défini qu'à la première inscription. Les exécutions suivantes du script ne le modifient pas : renommez alors le Mac dans la console.

bashJamf ou Intune, en root
#!/bin/sh
PZ_ENROLL_CODE="<install-key>" PZ_DEVICE_NAME_FROM_HOSTNAME=1 sh -c "$(curl -fsSL https://poisonzero.com/install.sh)"

PoisonZero configure lui-même la protection des agents d'IA après l'installation, dans chaque compte utilisateur et pour tous les agents pris en charge. Vous n'avez rien à faire.

Intune (macOS)

En alternative, la console vous fournit le script prêt à l'emploi avec la clé d'installation de votre locataire. Vous ne saisissez rien dans Intune.

  1. Dans la console, ouvrez Appareils, choisissez Télécharger le paquet Intune et l'onglet macOS. Déroulez Autres méthodes et téléchargez le script.
  2. Dans Intune, ajoutez un script sous Appareils → macOS → Scripts → Ajouter et chargez le fichier.
  3. Réglez Exécuter le script en tant qu'utilisateur connecté sur Non, pour qu'il s'exécute en root. Laissez la fréquence sur Non configuré et indiquez par exemple 3 pour Nouvelles tentatives en cas d'échec.
  4. Affectez le script à un groupe d'appareils.

Prérequis : macOS 12 ou plus récent, le Mac est inscrit dans Intune et accède à internet sans proxy. Intune installe lui-même l'agent Intune dès qu'un script est affecté au Mac. L'agent récupère les nouveaux scripts environ toutes les 8 heures. Dans le Portail d'entreprise, Vérifier les paramètres accélère la récupération.

Le script n'enregistre pas une seconde fois un Mac déjà enregistré. Intune n'affiche par Mac que le succès ou l'échec. Pour savoir si PoisonZero fonctionne, consultez la console sous Appareils.

Le script contient une clé d'installation que voient tous les administrateurs Intune ayant un accès en lecture aux scripts. La console la liste sous le nom Intune macOS avec la date. Elle est valable un an ; révoquez-la après le déploiement.

Mac privés : configuration signée

Un Mac privé ne reçoit aucun paramètre du cloud. Il lit un client-config.json signé.

  1. Dans la console, ouvrez le profil et choisissez Exporter pour les privés.
  2. Passez le fichier à l'installeur avec PZ_CONFIG, comme ci-dessous.
  3. Ou placez-le avec le script Jamf que la console affiche après l'export.
bashTerminal
curl -fsSL https://poisonzero.com/install.sh | sudo \
  PZ_ENROLL_CODE="<install-key>" PZ_CONFIG="./client-config.json" sh

L'installeur vérifie le fichier avec poison0 config verify et le place dans /Library/Application Support/PoisonZero/client-config.json, lisible uniquement par root.

Mise à jour

Les appareils cloud se mettent à jour eux-mêmes. Pour le désactiver par appareil, utilisez Settings → Protection et appareils → Mises à jour dans la console. Les appareils privés ne se mettent pas à jour eux-mêmes.

Pour une mise à jour manuelle, relancez la commande d'installation. Elle garde les identifiants. Plus d'informations dans Mises à jour et cycle de vie.

À partir de cette version, le fichier du programme est /usr/local/bin/poison0. poisonzero pointe vers lui et continue de fonctionner, et les exclusions de dossiers restent valables. Pour les exclusions de fichiers ou de processus, ajoutez poison0 et gardez poisonzero, car les hooks des agents l'appellent encore.

Désinstaller

bashTerminal
curl -fsSL https://poisonzero.com/install.sh | sudo sh -s -- --uninstall

La désinstallation retire d'abord les hooks d'agent de tous les utilisateurs et s'arrête si cela échoue. Ensuite, elle retire le service, le notifier, les commandes, le programme et le répertoire de données.

Pour une installation Homebrew, retirez d'abord les hooks :

bashHomebrew
poison0 remove-agent-integration && brew uninstall poisonzero
Ne supprimez pas le programme à la main. Des hooks Claude Code qui pointent vers un programme absent bloquent chaque appel d'outil.

Cas de quarantaine ouverts

La désinstallation liste chaque cas de quarantaine ouvert avec son chemin d'origine, la copie en quarantaine (*.infection.pz) et la façon de le restaurer. Une copie reste dans /Library/Application Support/PoisonZero-quarantine, lisible uniquement par root.

Mettez PZ_UNINSTALL_SKIP_QUARANTINE_COPY=1 pour ne pas conserver cette copie. Rien n'est restauré automatiquement. Vérifiez chaque fichier avant de le restaurer.

La désinstallation abandonne les modifications retenues qui attendent encore une vérification. Pour en garder une, approuvez-la d'abord : listez-les avec poison0 quarantine pending, puis lancez poison0 quarantine pending approve <id>.

Dépannage

SymptômeCauseCorrection
poison0 doctor indique que le téléchargement du modèle a échoué.Le téléchargement en arrière-plan après la première installation n'a pas abouti.Lancez sudo poison0 model pour réessayer tout de suite. poison0 doctor affiche la raison.
poison0 exec0 status indique que Claude Code n'appelle pas le hook exec0.Les paramètres Claude Code viennent d'un profil MDM (domaine com.anthropic.claudecode) ou de la console d'administration de claude.ai. Claude Code ignore alors 50-poisonzero-exec0.json.Définissez "managedSourcesBehavior": "merge" dans cette source (Claude Code 2.1.242 ou plus récent), ou copiez-y le contenu du fichier.
poison0 doctor signale que les hooks gérés sont désactivés.Les paramètres gérés de Claude Code définissent "disableAllHooks": true. Cela désactive aussi les hooks gérés de l'agent.Retirez le réglage là où il est défini : dans managed-settings.json, un autre fichier de managed-settings.d/, le profil MDM ou la console d'administration de claude.ai. L'agent ne modifie jamais ces sources.
L'installation s'arrête après l'enregistrement, et la configuration signée n'est pas placée.poison0 config verify a rejeté client-config.json. Un fichier existant reste en place.Cherchez le code de sortie sous Référence.
La désinstallation s'arrête et ne retire rien.Elle n'a pas pu retirer les hooks d'agent de tous les utilisateurs.Mettez PZ_UNINSTALL_FORCE=1 et retirez à la main les entrées restantes.

Référence

Variables d'environnement

Définissez-les avant le lancement de l'installeur. Un flag, passé après sh -s --, l'emporte sur sa variable.

VariableEffet
PZ_ENROLL_CODELa clé d'installation de la console. Sur un Mac enregistré, une nouvelle clé l'enregistre à nouveau.
PZ_APP_IDSeulement pour un code à usage unique fourni avec un App ID.
PZ_HEADLESSLe traitement des demandes de confirmation quand aucun utilisateur de bureau ne peut répondre. none (par défaut) suit l'utilisateur connecté, standard traite toujours le Mac comme sans bureau, strict est le plus strict. Flag : --headless.
PZ_DEVICE_NAMELe nom de l'appareil dans la console, 63 caractères au maximum, seulement a-z, 0-9 et -. Sans nom, la console affiche un espace réservé. À la place, PZ_DEVICE_NAME_FROM_HOSTNAME=1 envoie le nom d'ordinateur du Mac (Réglages Système → Général → Informations → Nom), ou PZ_DEVICE_NAMES_CSV (fichier ou URL https, en-tête hostname,name) cherche le Mac par nom d'ordinateur, nom d'hôte local ou nom d'hôte et n'envoie que le nom du CSV. Si plusieurs sont définies, PZ_DEVICE_NAME l'emporte, puis le CSV. Elles ne jouent qu'à la première inscription. Plus dans l'onboarding.
PZ_SETUP_AGENTSAjoute la commande locale de statistiques /poison0 aux agents indiqués, par exemple claude,codex.
PZ_SETUP_STATUSLINEMettez 1 pour ajouter la ligne d'état à Claude Code. Une ligne d'état existante est conservée.
PZ_SETUP_EXEC0Mettez off pour garder exec0 désactivé, aussi après les mises à jour. Les autres valeurs sont ignorées. Activez-le dans le profil de la console ou avec sudo poison0 exec0 observe ou enforce.
PZ_SETUP_LEAK0Appareils privés uniquement. Définit le mode leak0 : enforce, observe ou off. Sans la variable et sans terminal, leak0 reste désactivé.
PZ_BACKENDcpu (par défaut) ou gpu. Le profil de la console définit si le Mac utilise le GPU.
PZ_TIERenterprise (par défaut) ou ultra. Avec ultra, l'installeur s'arrête avec une erreur. Définissez donc Ultra dans le profil de la console.
PZ_NO_SHORT_ALIASMettez 1 pour ne pas créer la commande courte p0.
PZ_FETCH_ONLYMettez 1 pour seulement télécharger et vérifier le programme, sans service ni droits administrateur. Il va dans ./poison0 ou dans PZ_FETCH_DEST.
PZ_DRY_RUNMettez 1 pour afficher le mode d'installation et quitter avant toute modification.
POISONZERO_DATA_DIRChange le répertoire de données de l'installeur et de l'agent.
PZ_CONFIGChemin d'un client-config.json signé pour un Mac privé. Flag : --config.
PZ_QUARANTINE_RETENTION_DAYSAppareils privés uniquement. Nombre de jours de conservation d'un cas de quarantaine, de 1 à 3650. Flag : --quarantine-retention-days.
PZ_AUDIT_MAX_MBAppareils privés uniquement. Taille en Mo à partir de laquelle le journal d'audit tourne, de 1 à 1024. Flag : --audit-max-mb.

Chemins et service

ÉlémentEmplacement
Le programme et ses commandes./usr/local/bin/poison0. Les commandes poisonzero, p0 et pz pointent vers lui.
Le répertoire de données./Library/Application Support/PoisonZero, propriétaire root:wheel. Il contient les identifiants, le fichier enroll, les journaux et la quarantaine.
Le service.Le LaunchDaemon com.poisonzero.daemon. Il démarre au boot et s'exécute en root.
Le notifier des demandes de confirmation.Le LaunchAgent com.poisonzero.notifier dans chaque session utilisateur. Sans utilisateur connecté, il démarre à la prochaine connexion.
Le journal du service.daemon.log dans le répertoire de données. Il tourne à 5 Mo.
Les hooks exec0 pour Claude Code./Library/Application Support/ClaudeCode/managed-settings.d/50-poisonzero-exec0.json. Une installation Homebrew sous un préfixe de l'utilisateur utilise ~/.claude/settings.json.

Hooks exec0 dans Claude Code

L'agent ne modifie jamais votre managed-settings.json ni les autres fichiers de managed-settings.d/. Pour désactiver ou activer exec0 pour Claude Code :

bashexec0 pour Claude Code
# turn off
sudo poison0 setup-claude --toolgate-off
# turn on
sudo poison0 setup-claude --toolgate

Codes de sortie de la configuration signée

poison0 config verify renvoie ces codes. L'installeur place le fichier seulement pour 0 ou 6.

Code de sortieSignification
0Le fichier est valide.
6La licence n'est pas encore là. Le service vérifie le fichier au démarrage.
1Le fichier est illisible.
3Le fichier n'est pas signé pour cet appareil.
4Le fichier est périmé ou a expiré.
5Le fichier est invalide ou trop récent pour cette version de l'agent.
7Le Mac est un appareil cloud, qui ignore le fichier.

À lire ensuite

Autres systèmes d'exploitation : vue d'ensemble de l'installation. Matériel : Configuration requise. Protection par agent : Agents pris en charge.