Guide d’intégration de Pheidix

Pheidix, abréviation de Pheidippides (Phidippide), a couru le premier marathon de l’histoire en Grèce antique. Il est l’inspiration derrière l’agent d’appareil (endpoint) d’Hector, responsable de collecter les informations sur les appareils de votre organisation et de les synchroniser en tant qu’actifs, maintenant ainsi votre inventaire à jour.

Dans ce guide, vous découvrirez comment configurer Pheidix dans votre environnement.

Limitations

• L’agent d’appareil est disponible pour les systèmes d’exploitation suivants :
  • Windows 11
  • macOS (bientôt disponible)
  • Linux (bientôt disponible)

Exigences de déploiement

• Avoir accès aux fichiers exécutables Pheidix d’Hector.
• Disposer de droits d’administrateur dans SCCM, Intune ou de droits administratifs pour créer des objets de stratégie de groupe (GPO).
• Disposer de droits de système local/administrateur sur les appareils pour les besoins de l’installation.
• Avoir la permission de déployer l’exécutable sur un partage réseau.
• Avoir la permission d’autoriser l’adresse IP dans le pare-feu.
• Avoir la permission de télécharger et d’enregistrer le certificat de l’application.
• Les appareils doivent avoir accès à Internet (port 443) pour signaler leur état une fois par jour.

Sécurité

• L’exécutable est signé par un certificat pour éviter toute altération.
• L’agent peut se mettre à jour automatiquement, ce qui lui permet de modifier sa clé de démarrage automatique HKLM.
• L’agent s’exécute avec le moins de privilèges possible / autorisations de lecture seule.
• L’agent n’apporte aucune modification au système d’exploitation ou au matériel.
• L’agent dispose d’un fichier de paramètres pour ses besoins internes.

Empreinte du système

• L’agent est léger et s’exécute en mode efficacité pour économiser les ressources.
• L’utilisation du processeur (CPU) sera d’environ 0 % à 1 % sur les appareils de bureau typiques.
• L’utilisation de la mémoire variera entre 30 Mo et 40 Mo.
• L’utilisation du disque est de 300 Mo.

Premiers pas

Étape 1 – Téléchargement

Obtenez une copie de l’agent et de l’outil de déploiement en accédant à la section Paramètres > Intégrations > Pheidix -> Téléchargement.

Étape 2 – Configuration

• Copiez la clé de jeton (token).
  • La clé est générée automatiquement et permet au fichier EXE de pointer vers votre environnement.
  • Ne partagez pas cette clé d’installation en dehors de votre organisation.
• Catégorie
  • Une catégorie par défaut permettra aux appareils d’être synchronisés vers une catégorie spécifique basée sur le numéro de série et/ou le fabricant/modèle de l’appareil. S’il est trouvé dans Hector, il sera automatiquement attribué à l’actif.
  • Vous pouvez également cocher « Utiliser le champ Type de châssis » afin que le type de châssis soit utilisé pour créer des catégories telles que Ordinateurs portables, Ordinateurs de bureau, Tablettes, Serveurs, etc. (lorsque l’actif n’existe pas déjà).
• Emplacement
  • Lors de l’importation de nouveaux actifs, l’application a besoin d’un emplacement par défaut pour stocker les actifs avant qu’ils ne soient déplacés vers leur destination finale. Nous recommandons un emplacement appelé « Triage », ce qui permettra de distinguer les appareils importés des activités quotidiennes.
• Champs
  • Vous pouvez sélectionner les champs que vous souhaitez synchroniser en fonction de vos besoins.
  • Si vous souhaitez ajouter des champs supplémentaires, n’hésitez pas à contacter notre équipe de support.

Une fois que vous avez terminé, vous pouvez cliquer sur le bouton Enregistrer pour finaliser cette partie du guide de configuration.

Déploiement manuel

Après avoir téléchargé l’application, vous pouvez l’installer manuellement sur un appareil en double-cliquant sur le fichier EXE. Une fois l’application ouverte, saisissez le jeton copié lors des étapes précédentes. Ce jeton est le même que celui qui sera installé sur tous les appareils.

Si une erreur survient avec le jeton saisi, Pheidix affichera un message d’erreur. Vous pouvez agir en conséquence selon le message d’erreur, ou contacter notre équipe de support pour plus d’informations.

Si tout a fonctionné correctement, vous verrez une liste de propriétés et d’informations. Vous pouvez choisir de synchroniser ces informations à la demande, ou de laisser la synchronisation automatique s’effectuer chaque jour ou lors de la mise sous tension de l’appareil.

Pheidix a une empreinte très faible et s’exécute dans la zone de notification (system tray). Il est non invasif et la plupart des utilisateurs ne sauront pas qu’il est installé ou en cours d’exécution. Il a besoin d’un accès

Déploiement automatisé

Si vous êtes administrateur système, vous pouvez déployer massivement Pheidix sur des milliers de machines à l’aide de vos outils de gestion existants (Microsoft Intune, SCCM/Configuration Manager ou Stratégie de groupe). Toutes les méthodes reposent sur les deux mêmes éléments : l’installateur pour l’ensemble de la machine et la clé de jeton de votre environnement.

Ce que vous déployez

Pour un déploiement de masse, utilisez toujours l’installateur pour l’ensemble de la machine Hector.Pheidix-win-DeploymentTool.msi. Il s’installe dans %ProgramFiles%\Hector.Pheidix\ pour tous les utilisateurs et nécessite une élévation de privilèges. (Le fichier Hector.Pheidix-win-Setup.exe est l’installateur par utilisateur destiné uniquement aux installations manuelles sur une seule machine — ne l’utilisez pas pour le déploiement sur un parc de machines.)

La clé de jeton est fournie séparément, en plaçant un fichier settings.json dans %ProgramData%\Hector.Pheidix\ :

{
  "PheidixKey": "VOTRE_CLÉ_D_ENVIRONNEMENT"
}

Ce dossier est intentionnellement en lecture seule pour les utilisateurs standards afin que la clé, essentielle à la confiance du système, ne puisse pas être altérée. Le script de déploiement ci-dessous crée le dossier, applique les bonnes autorisations, installe le MSI et inscrit la clé — le tout en une seule étape.

Étape 1 — Héberger les fichiers sur un partage réseau

Placez le MSI et le script de déploiement sur un chemin UNC que les machines cibles peuvent lire au moment du démarrage (ex. : \\Serveur\Deploy$). Pour les scripts de démarrage de stratégie de groupe (GPO), assurez-vous que le groupe Ordinateurs du domaine dispose d’un accès en lecture au partage.

Étape 2 — Utiliser ce script de déploiement

Enregistrez le code suivant sous le nom Deploy-Pheidix.ps1 aux côtés du fichier MSI sur votre partage. Il peut être exécuté en toute sécurité à chaque démarrage : si Pheidix est déjà installé, il s’arrête immédiatement. Remplacez la clé par celle de votre environnement Hector (Paramètres > Intégrations > Pheidix), ou passez-la avec le paramètre -Key.

#Requires -RunAsAdministrator
param([Parameter(Mandatory)][string]$Key)

# Garde d'idempotence — sauter si déjà installé (sécuritaire pour les GPO au démarrage)
if (Test-Path "$env:ProgramFiles\Hector.Pheidix\Pheidix.exe") { return }

# Exécuter le MSI depuis le partage où se trouve ce script
$share    = Split-Path -Parent $MyInvocation.MyCommand.Path
$dataPath = Join-Path $env:ProgramData "Hector.Pheidix"
New-Item -ItemType Directory -Path $dataPath -Force | Out-Null

# Verrouiller le dossier de configuration : seuls SYSTEM/Admins peuvent écrire ; les utilisateurs standards peuvent lire
icacls $dataPath /inheritance:r `
    /grant:r "SYSTEM:(OI)(CI)F" "BUILTIN\Administrators:(OI)(CI)F" "BUILTIN\Users:(OI)(CI)RX" | Out-Null

# Installer pour l'ensemble de la machine, de manière silencieuse
Start-Process msiexec -Wait -ArgumentList "/i","`"$share\Hector.Pheidix-win-DeploymentTool.msi`"","/quiet"

# Inscrire la clé d'environnement
$settingsPath = Join-Path $dataPath "settings.json"
@{ PheidixKey = $Key } | ConvertTo-Json | Out-File $settingsPath -Encoding utf8 -Force

Étape 3 — Cibler vos machines

Outil	Comment déployer
Microsoft Intune	Packagez Hector.Pheidix-win-DeploymentTool.msi et Deploy-Pheidix.ps1 en tant qu’application Win32, attribuez-la à vos groupes d’appareils et définissez la commande d’installation sur : powershell.exe -ExecutionPolicy Bypass -File Deploy-Pheidix.ps1 -Key "VOTRE_CLÉ" Intune exécute cela en tant que SYSTEM et le script inscrit la clé localement.
SCCM / Configuration Manager	Créez une application ou un package qui exécute Deploy-Pheidix.ps1 -Key "VOTRE_CLÉ" de manière silencieuse sur vos regroupements d’appareils.
Stratégie de groupe (GPO)	Sous Configuration ordinateur > Stratégies > Paramètres Windows > Scripts, ajoutez Deploy-Pheidix.ps1 en tant que Script de démarrage avec le paramètre -Key "VOTRE_CLÉ". Utilisez la Configuration ordinateur (et non la Configuration utilisateur) pour que le MSI s’installe correctement sur l’ensemble de la machine.

Étape 4 — Prérequis et vérification

• Assurez-vous que le certificat de signature de l’agent est approuvé sur vos appareils (voir la section Exigences ci-dessus).
• Autorisez le trafic HTTPS sortant (port 443) vers Hector afin que l’agent puisse envoyer son rapport une fois par jour. Si vous filtrez par destination, ajoutez l’hôte de votre environnement Hector à la liste d’autorisation.
• Vérifiez le déploiement à grande échelle en observant l’augmentation du nombre d’appareils dans le tableau de bord Pheidix, plutôt qu’en vérifiant les machines individuellement.
• Pour vérifier une seule machine au besoin, confirmez que le processus Pheidix.exe est en cours d’exécution et que le fichier %ProgramData%\Hector.Pheidix\settings.json contient votre clé.

Mise à jour de l’agent

L’application est configurée pour se mettre à jour automatiquement dès qu’une nouvelle version est publiée par l’équipe d’Hector. Si une nouvelle version est détectée, l’application la téléchargera, se fermera, effectuera la mise à jour et se rouvrira. Cette étape est transparente et ne nécessite aucune action spécifique de la part des utilisateurs.

Récapitulatif

Dans ce guide, vous avez appris à configurer l’agent Pheidix pour collecter les informations des appareils et les synchroniser dans Hector. Cependant, vous n’êtes pas obligé de le faire seul ! Notre équipe a l’habitude de mettre en place des intégrations et nous pouvons vous aider à éviter les pièges en organisant des ateliers et en vous expliquant en détail comment configurer correctement l’agent pour collecter autant de données que nécessaire. Contactez notre équipe des ventes pour plus d’informations ou pour planifier votre prochain atelier.