Installer l'agent de bureau avec votre propre assistant IA

Collez cette consigne dans l'assistant de programmation que vous utilisez déjà (Claude Code, Codex, Cursor ou autre), sur le poste qui fera tourner l'agent Badgeye. Il installe l'agent, l'inscrit et vérifie le résultat étape par étape.

Il vous faut

Un jeton d'invitation et l'adresse de l'API fournis par votre administrateur Badgeye (elle se termine par /api).
Les droits d'administrateur sur le poste et un accès HTTPS sortant.

Ce qu'il ne fera pas

Il ne vous demande jamais de coller le jeton, un mot de passe ou une clé dans la conversation : vous saisissez le jeton vous-même dans un champ masqué.
Il ne désactive ni l'antivirus, ni le pare-feu, ni Gatekeeper, ni SmartScreen, ni la vérification des certificats.
Il vérifie la somme de contrôle et la signature de l'installateur avant de l'exécuter, puis termine avec badgeye-agent doctor, une analyse en lecture seule qui ne modifie rien.

Consigne d'installation (tout sélectionner et copier)

Vous aidez un administrateur TI à installer l'agent de bureau Badgeye sur CE poste. Procédez par petites étapes, exécutez chaque vérification et rapportez le résultat en une ligne avant de passer à la suite. Règles à respecter :

1. Ne demandez jamais à l'administrateur de coller le jeton d'invitation, un mot de passe, une clé d'API ou une graine TOTP dans cette conversation, et n'en écrivez jamais dans un fichier, un argument de commande, un historique de shell ou un journal. Quand l'agent a besoin du jeton, dites à l'administrateur d'exécuter lui-même la commande d'inscription dans son propre terminal et de saisir le jeton dans le champ masqué (ou de le placer dans l'environnement de cette seule commande). Si vous voyez un secret dans une sortie, arrêtez-vous, dites-le et ne le répétez pas.
2. Ne désactivez ni l'antivirus, ni le pare-feu, ni Gatekeeper, ni SmartScreen, ni un proxy, ni la vérification TLS. Si un téléchargement ou un certificat échoue, rapportez-le et arrêtez-vous ; n'utilisez ni `--insecure`, ni `-k`, ni `curl | sh`, ni une version non signée. Seule exception : un essai local sur `http://localhost`, et seulement si l'administrateur dit que c'est un essai.
3. Ne faites aucune modification en dehors des étapes ci-dessous. Demandez avant d'installer quoi que ce soit qui n'y figure pas.

Étape 1. Détectez le poste. Rapportez le système et sa version, le processeur (arm64/x86_64), si vous avez les droits d'administrateur, l'espace disque libre (au moins 2 Go) et si l'horloge est synchronisée. Arrêtez-vous si le système n'est ni macOS, ni Windows 10/11 x64, ni Linux avec systemd.

Étape 2. Vérifiez le réseau (HTTPS sortant seulement, aucun port entrant). Avec l'adresse de l'API que l'administrateur vous donne, confirmez que le nom d'hôte se résout et que `https://<hôte>` répond avec un certificat valide. Si un proxy d'entreprise est utilisé, indiquez à l'administrateur les variables de proxy ou `BADGEYE_WORKSTATION_LINK_CA_FILE` dont il pourrait avoir besoin, et arrêtez-vous jusqu'à sa confirmation.

Étape 3. Obtenez l'installateur UNIQUEMENT depuis la page de versions Badgeye de l'administrateur ou la version GitHub officielle qu'il vous indique. Vérifiez son SHA-256 avec `SHA256SUMS.txt` de la même version et, sur macOS et Windows, confirmez la signature (`pkgutil --check-signature`, ou l'onglet Signatures numériques / `Get-AuthenticodeSignature`). Rapportez la somme et le signataire. Arrêtez-vous si l'un des deux ne correspond pas.

Étape 4. Installez.
- macOS : ouvrez le `.pkg`. Il installe `/usr/local/badgeye`, la commande `badgeye-agent` et un LaunchAgent par utilisateur.
- Windows : exécutez le `.msi` (ou `msiexec /i <fichier> /qn` avec le jeton fourni par l'administrateur comme propriété masquée, non saisi par vous).
- Linux : décompressez l'archive et exécutez `./install.sh` pour une unité systemd par utilisateur.
Puis exécutez `badgeye-agent --version` et rapportez le résultat.

Étape 5. Inscription. Dites à l'administrateur d'exécuter, dans son propre terminal, `badgeye-agent enrol --url https://<hôte>/api` et de saisir le jeton à l'invite (ou de l'avoir dans `BADGEYE_ENROL_TOKEN` pour cette seule commande). Ne l'exécutez pas à sa place avec un jeton dans la commande. Puis exécutez `badgeye-agent status` et rapportez l'identifiant de l'agent et celui de l'organisation (ce ne sont pas des secrets).

Étape 6. Navigateur. Exécutez `badgeye-agent install-browser` (téléchargement unique de Chromium, environ 150 Mo vers `~/.badgeye-agent/browsers`). Rapportez la réussite. Si le réseau bloque le CDN de Playwright, parlez à l'administrateur de `PLAYWRIGHT_DOWNLOAD_HOST` (un miroir) et arrêtez-vous.

Étape 7. Démarrage à l'ouverture de session. Confirmez que le service est enregistré (macOS : `launchctl list | grep badgeye` ; Windows : `schtasks /Query /TN BadgeyeAgent` ; Linux : `systemctl --user status badgeye-agent`). Démarrez-le s'il ne tourne pas.

Étape 8. Vérifiez avec l'analyseur intégré. Exécutez `badgeye-agent doctor` (lecture seule, il ne modifie rien). Rapportez chaque ligne marquée WARN ou FAIL avec le correctif proposé. Le code de sortie 0 veut dire tout va bien, 1 des avertissements, 2 des échecs. N'essayez pas de corriger un FAIL en modifiant à la main la base de données ou la configuration de l'agent ; appliquez le correctif affiché ou arrêtez-vous et rapportez. Exécutez aussi `badgeye-agent doctor --json` et gardez la sortie pour le billet (elle ne contient que des identifiants et des totaux, aucun secret).

Étape 9. Confirmez dans la console. Demandez à l'administrateur d'ouvrir la console Badgeye, d'aller à la page des agents et de vérifier que ce poste apparaît en ligne avec la version que vous avez vue. Ne vous connectez pas à la console à sa place.

Pannes connues, à vérifier d'abord en cas d'échec :
- L'inscription dit que le jeton est invalide ou expiré : les jetons durent 24 heures et servent une seule fois ; demandez-en un nouveau.
- L'inscription refuse l'adresse : elle doit commencer par `https://` et se terminer par `/api`.
- « clock skew » dans doctor : activez l'heure automatique ; les approbations signées et les sessions en dépendent.
- macOS demande l'accès au trousseau de session : autorisez-le ; la clé du coffre s'y trouve (service `badgeye-vault`).
- Chromium ne se télécharge pas : proxy ou blocage du CDN (voir l'étape 6).
- L'agent apparaît hors ligne après un redémarrage : exécutez `badgeye-agent doctor`, puis lisez le journal du service ; ne réinstallez pas avant d'avoir lu le résultat de doctor.
- Les applications d'intranet sont inaccessibles par conception. Seuls les noms d'hôte ou adresses IP exacts listés dans `BADGEYE_BROWSER_INTRANET_ALLOW` (défini par l'administrateur) sont permis ; jamais de caractères génériques, ni d'adresses de bouclage ou de métadonnées infonuagiques.

À la fin, donnez à l'administrateur un court résumé : version, identifiant de l'agent, résultat de doctor et ce qui nécessite encore une personne. N'y mettez aucun secret.

Vous préférez installer à la main ? Les étapes sont dans le guide d'installation de l'agent.

Vous voulez d'abord le voir travailler ?

← Badgeye