Installer sur Windows

Sous Windows, l'agent tourne comme service Windows natif. Il vous faut une invite de commandes administrateur et le jeton de l'agent, copié lorsque vous avez créé l'agent dans Onagre.

1. Télécharger l'agent#

Dans un PowerShell administrateur, téléchargez-le dans C:\Program Files\Onagre\ et vérifiez-le :

New-Item -ItemType Directory -Force "C:\Program Files\Onagre" | Out-Null
Invoke-WebRequest https://d.onag.re/agent-win-x64.exe -OutFile "C:\Program Files\Onagre\agent.exe"
$expected = (Invoke-WebRequest https://d.onag.re/agent-win-x64.exe.sha256).Content.Split(' ')[0].Trim()
(Get-FileHash "C:\Program Files\Onagre\agent.exe" -Algorithm SHA256).Hash -eq $expected

La dernière commande doit répondre True.

2. Lui donner son jeton#

L'agent lit son jeton dans la variable d'environnement TOKEN. Définissez-la au niveau de la machine, pour que le service la voie :

setx TOKEN "<YOUR_TOKEN>" /M

Une variable définie au niveau de la machine est lisible par les utilisateurs locaux du serveur : installez l'agent sur un serveur où c'est acceptable.

3. Créer le service#

Dans une invite de commandes administrateur :

sc.exe create OnagreAgent binPath= "\"C:\Program Files\Onagre\agent.exe\"" start= auto DisplayName= "Onagre Agent"
sc.exe failure OnagreAgent reset= 86400 actions= restart/5000/restart/5000/restart/5000
sc.exe start OnagreAgent

Le service tourne sous LocalSystem, démarre avec Windows et redémarre après une défaillance. Après quelques secondes, l'agent apparaît Connected dans Configuration → Agents.

Pour l'exécuter plutôt sous un compte dédié, donnez à ce compte le droit Read & execute sur C:\Program Files\Onagre\ et l'accès aux ressources à contrôler, puis : sc.exe config OnagreAgent obj= "DOMAIN\svc-onagre" password= "<PASSWORD>".

Le vérifier#

sc.exe query OnagreAgent
curl http://127.0.0.1:27520/ready

Les endpoints de santé n'écoutent que sur 127.0.0.1 : rien n'est exposé sur le réseau.

Logs#

L'agent écrit un fichier de log par jour (4 conservés) sous %LOCALAPPDATA%\Onagre\ — pour le compte LocalSystem, C:\Windows\System32\config\systemprofile\AppData\Local\Onagre\. Définissez une variable LOG au niveau de la machine pour l'écrire ailleurs. Les échecs de démarrage du service apparaissent dans Event Viewer → Windows Logs → System.

Mettre à jour#

sc.exe stop OnagreAgent
rem replace C:\Program Files\Onagre\agent.exe with the new version, checked as above
sc.exe start OnagreAgent

Changer le jeton#

Après Revoke and regenerate dans Onagre, exécutez setx TOKEN "<NEW_TOKEN>" /M, puis redémarrez le service.

Proxy et pare-feu#

L'agent a besoin d'un accès HTTPS sortant (port 443) vers api.onagre.io et vers le Hub. Si un proxy est obligatoire, configurez-le pour la machine ou pour le compte du service.

Désinstaller#

sc.exe stop OnagreAgent
sc.exe delete OnagreAgent
reg delete "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v TOKEN /f

Supprimez ensuite C:\Program Files\Onagre\.