Installer l'agent poison0 sur macOS
Installer, déployer, vérifier et retirer l'agent poison0 sur un Mac.
Prérequis
| Prérequis | Détails |
|---|---|
| Processeur | Apple 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. |
| Droits | Des droits administrateur. L'installeur s'exécute en root via sudo. |
| Clé d'installation | Une clé d'installation de la console, sous Appareils → Déployer plusieurs appareils avec une clé. |
| Agents IA | Au moins un agent IA parmi les agents pris en charge. |
Installer un Mac
Lancez cette commande dans le Terminal.
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
- Lancez
launchctl print system/com.poisonzero.daemon. Le service doit tourner. - Lancez
poison0 doctordans votre session de bureau. Il nomme ce qui ne va pas. - 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.
- 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.
- Facultatif : cochez Utiliser le nom de l'ordinateur comme nom d'appareil avant de télécharger le profil.
- Sous 1. Télécharger le paquet, téléchargez le paquet avec le lien.
- Sous 2. Télécharger le profil, téléchargez le profil avec Télécharger.
Étapes dans Intune :
- Ouvrez Applications → macOS → Ajouter, choisissez Application métier et chargez le paquet.
- Attribuez l'application à un groupe d'appareils sous Obligatoire.
- 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. - Attribuez le profil au même groupe d'appareils.
Étapes dans Jamf Pro :
- Chargez le paquet sous Settings → Computer Management → Packages.
- 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.
- Sous Computers → Configuration Profiles → Upload, chargez le fichier
.mobileconfig. - 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.
#!/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.
- 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.
- Dans Intune, ajoutez un script sous Appareils → macOS → Scripts → Ajouter et chargez le fichier.
- 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.
- 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é.
- Dans la console, ouvrez le profil et choisissez Exporter pour les privés.
- Passez le fichier à l'installeur avec
PZ_CONFIG, comme ci-dessous. - Ou placez-le avec le script Jamf que la console affiche après l'export.
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
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 :
poison0 remove-agent-integration && brew uninstall poisonzero
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ôme | Cause | Correction |
|---|---|---|
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.
| Variable | Effet |
|---|---|
PZ_ENROLL_CODE | La clé d'installation de la console. Sur un Mac enregistré, une nouvelle clé l'enregistre à nouveau. |
PZ_APP_ID | Seulement pour un code à usage unique fourni avec un App ID. |
PZ_HEADLESS | Le 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_NAME | Le 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_AGENTS | Ajoute la commande locale de statistiques /poison0 aux agents indiqués, par exemple claude,codex. |
PZ_SETUP_STATUSLINE | Mettez 1 pour ajouter la ligne d'état à Claude Code. Une ligne d'état existante est conservée. |
PZ_SETUP_EXEC0 | Mettez 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_LEAK0 | Appareils privés uniquement. Définit le mode leak0 : enforce, observe ou off. Sans la variable et sans terminal, leak0 reste désactivé. |
PZ_BACKEND | cpu (par défaut) ou gpu. Le profil de la console définit si le Mac utilise le GPU. |
PZ_TIER | enterprise (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_ALIAS | Mettez 1 pour ne pas créer la commande courte p0. |
PZ_FETCH_ONLY | Mettez 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_RUN | Mettez 1 pour afficher le mode d'installation et quitter avant toute modification. |
POISONZERO_DATA_DIR | Change le répertoire de données de l'installeur et de l'agent. |
PZ_CONFIG | Chemin d'un client-config.json signé pour un Mac privé. Flag : --config. |
PZ_QUARANTINE_RETENTION_DAYS | Appareils privés uniquement. Nombre de jours de conservation d'un cas de quarantaine, de 1 à 3650. Flag : --quarantine-retention-days. |
PZ_AUDIT_MAX_MB | Appareils 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ément | Emplacement |
|---|---|
| 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 :
# 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 sortie | Signification |
|---|---|
| 0 | Le fichier est valide. |
| 6 | La licence n'est pas encore là. Le service vérifie le fichier au démarrage. |
| 1 | Le fichier est illisible. |
| 3 | Le fichier n'est pas signé pour cet appareil. |
| 4 | Le fichier est périmé ou a expiré. |
| 5 | Le fichier est invalide ou trop récent pour cette version de l'agent. |
| 7 | Le 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.