Installer l’agent

Un binaire statique pour amd64 et arm64, livré avec un service systemd renforcé. Les paquets et le script d’installation mettent en place le même programme, le même fichier de réglages et le même service, et le programme s’appelle gryphon-agent.

VERSION=1.1.45
BASE=https://github.com/gocodedotca/gryphon-agent/releases/download/v$VERSION
ARCH=$(dpkg --print-architecture)
curl -fLO $BASE/gryphon-agent_${VERSION}_$ARCH.deb
curl -fLO $BASE/SHA256SUMS
sha256sum --ignore-missing -c SHA256SUMS
sudo apt install ./gryphon-agent_${VERSION}_$ARCH.deb

VERSION=1.1.45
BASE=https://github.com/gocodedotca/gryphon-agent/releases/download/v$VERSION
ARCH=$(uname -m | sed 's/x86_64/amd64/; s/aarch64/arm64/')
curl -fLO $BASE/gryphon-agent_${VERSION}_$ARCH.rpm
curl -fLO $BASE/SHA256SUMS
sha256sum --ignore-missing -c SHA256SUMS
sudo dnf install ./gryphon-agent_${VERSION}_$ARCH.rpm

curl -fsSLO https://raw.githubusercontent.com/gocodedotca/gryphon-agent/main/deploy/agent/install.sh
less install.sh
sudo sh install.sh

VERSION=1.1.45
BASE=https://github.com/gocodedotca/gryphon-agent/releases/download/v$VERSION
ARCH=$(uname -m | sed 's/x86_64/amd64/; s/aarch64/arm64/')
curl -fLO $BASE/gryphon-agent_${VERSION}_linux_$ARCH.tar.gz
curl -fLO $BASE/SHA256SUMS
sha256sum --ignore-missing -c SHA256SUMS
tar -xzf gryphon-agent_${VERSION}_linux_$ARCH.tar.gz
read -rsp "Token: " TOKEN; echo
(umask 077; printf '%s\n' "$TOKEN" > agent_key); unset TOKEN
GWC_KEY_FILE=./agent_key ./gryphon-agent

sudo gryphon-agent enrol

systemctl status gryphon-agent
sudo journalctl -u gryphon-agent -n 50

Dès que la page de l’hôte dans Gryphon indique Connecté, ajoutez les vérifications de l’agent sous Services : disque, mémoire, CPU et charge, bases de données, Docker, scripts, fichiers, et HTTP, ping et TCP depuis l’intérieur de votre réseau.

Le même agent sous forme de service Windows, pour Windows 10 et 11 et Windows Server 2016 ou plus récent, sur x64 ou Arm. Une commande met en place le service et un dossier de réglages que seuls les administrateurs peuvent modifier, et une autre lui donne son jeton.

Utilisez une seule fenêtre PowerShell pour les deux étapes, ouverte en tant qu’administrateur : Démarrer, tapez PowerShell, puis choisissez Exécuter en tant qu’administrateur.

$ProgressPreference = "SilentlyContinue"
Set-Location $env:TEMP
$Version = "1.1.45"
$Arch = "amd64"
if ("$env:PROCESSOR_ARCHITECTURE $env:PROCESSOR_ARCHITEW6432" -match "ARM64") { $Arch = "arm64" }
$Base = "https://github.com/gocodedotca/gryphon-agent/releases/download/v$Version"
$Zip = "gryphon-agent_${Version}_windows_$Arch.zip"
Invoke-WebRequest "$Base/$Zip" -OutFile $Zip
Invoke-WebRequest "$Base/SHA256SUMS" -OutFile SHA256SUMS
$Want = (Select-String -Path SHA256SUMS -SimpleMatch $Zip).Line.Split(" ")[0]
if ((Get-FileHash $Zip).Hash -ne $Want) { throw "checksum mismatch" }
Expand-Archive $Zip -DestinationPath gryphon-agent -Force

.\gryphon-agent\gryphon-agent.exe service install

& 'C:\Program Files\Gryphon Agent\gryphon-agent.exe' enrol

Get-Service GryphonAgent
Get-WinEvent -FilterHashtable @{LogName="Application"; ProviderName="GryphonAgent"} -MaxEvents 20

Dès que la page de l’hôte dans Gryphon indique Connecté, ajoutez les vérifications de l’agent sous Services : disque, mémoire, CPU et charge, bases de données, Docker, scripts, fichiers, et HTTP, ping et TCP depuis l’intérieur de votre réseau.

Dépannage

L’inscription affiche « Gryphon refused this token »

Le jeton a été copié incomplet, ou il a été remplacé depuis. Copiez-le de nouveau, en entier, depuis la boîte de dialogue de l’étape 1 ; si elle est fermée, choisissez Remplacer le jeton sur la page de l’hôte et inscrivez l’agent avec le nouveau.

L’inscription affiche « Cannot reach Gryphon »

La machine ne parvient pas à établir la connexion sortante. Vérifiez le réseau : un pare-feu sortant, un proxy qui exige HTTPS_PROXY, ou aucune route vers Internet.

La page de l’hôte indique « En attente de la connexion de l’agent »

Le jeton a été émis et aucun agent ne l’a encore utilisé : l’étape 3 n’a pas été faite, ou l’agent ne fonctionne pas. Les dernières commandes de l’étape 3 indiquent pourquoi.

La page de l’hôte indique « Non connecté », et les vérifications affichent « Agent: not connected »

L’agent était connecté et s’est arrêté : la machine est éteinte ou en veille, l’agent a été arrêté, ou sa connexion sortante est bloquée. Il se reconnecte de lui-même dès qu’il le peut. Un Mac n’est surveillé que lorsqu’il est éveillé et que son agent est actif.

Le menu du Mac affiche « the token was refused »

Son jeton a été remplacé, ou son hôte supprimé. Choisissez Enter Token… avec un nouveau jeton obtenu sur la page de l’hôte.

La page de l’hôte indique que le jeton est utilisé sur plus d’une machine

Deux machines ont reçu le même jeton, et elles se prennent sans cesse la connexion l’une à l’autre. Chaque machine a besoin de son propre hôte dans Gryphon. Remplacez le jeton, donnez le nouveau à cette machine seulement, et ajoutez un hôte pour l’autre.

Une vérification affiche « update the agent »

La vérification est plus récente que l’agent de cette machine. Mettez-le à jour ; le jeton et les réglages sont conservés.