L'installation automatique nécessite une requête de détection qui reconnaît votre logiciel une fois qu'il est installé. Ce guide montre comment trouver le nom exact utilisé par Windows ou Linux, afin que la requête fonctionne.

Fonctionnalité

Aperçu

Lorsque vous activez l'installation automatique pour un package personnalisé (.exe, .ps1, .deb, .rpm, .sh ou .tar.gz), Factorial IT pré-remplit une osquery basée sur le nom du logiciel que vous avez entré. C'est une meilleure estimation.

La règle est simple : lorsque le logiciel est installé, la requête doit renvoyer au moins une ligne. Si elle ne renvoie rien, l'agent pense que le logiciel est manquant et réinstalle le package à chaque vérification.

Pour corriger cela, changez la valeur à l'intérieur de LIKE '%...%' afin qu'elle corresponde au nom que le système d'exploitation rapporte pour le logiciel installé, et non au nom de l'installateur.

Comment utiliser

1. Ouvrez le package personnalisé et activez l'installation automatique.
2. Regardez la requête pré-remplie.
3. Trouvez le nom exact installé avec la méthode pour votre type de package (ci-dessous).
4. Remplacez la valeur à l'intérieur de LIKE '%...%' par ce nom.
5. Ciblez d'abord un petit groupe d'appareils et vérifiez que l'installation se comporte comme prévu.
6. Déployez-le au reste de la flotte.

Windows (.exe, .ps1)

Requête pré-remplie :

SELECT 1 FROM programs WHERE name LIKE '%<software name>%'

Où trouver le nom exact :

• La liste des logiciels installés dans Détails de l'hôte de la flotte
• Applications et fonctionnalités dans les paramètres Windows
• PowerShell : Get-Package | Where-Object Name -Like '*<name>*'

Exemple : l'installateur est FalconSensor_Windows.exe, mais Windows répertorie le logiciel comme CrowdStrike Windows Sensor. La requête devient :

SELECT 1 FROM programs WHERE name LIKE '%CrowdStrike Windows Sensor%'

Linux .deb

Pour les packages Debian et Ubuntu.

Requête pré-remplie :

SELECT 1 FROM deb_packages WHERE name LIKE '%<software name>%'

Où trouver le nom exact :

• Exécutez dpkg -l | grep <name>. Le nom du package se trouve dans la première colonne.
• Utilisez le nom du package (par exemple google-chrome-stable), pas le nom d'affichage convivial.

Linux .rpm

Requête pré-remplie :

SELECT 1 FROM rpm_packages WHERE name LIKE '%<software name>%'

Où trouver le nom exact :

• Exécutez rpm -qa | grep <name>.
• Conservez uniquement le nom de package brut, sans suffixe de version ou d'architecture.

Scripts et archives (.sh, .tar.gz)

Pour les scripts d'installation et les archives Linux, ce qui se retrouve sur le disque dépend du script. Lisez le script ou son README pour découvrir :

• Si cela enregistre un package dans deb_packages ou rpm_packages. Si c'est le cas, interrogez cette table.
• Sinon, quel binaire ou répertoire il crée. Interrogez cela avec file ou osquery_info.

Dépannage et FAQ

Dépannage

• Le package se réinstalle à chaque vérification. La requête ne renvoie aucune ligne, donc le logiciel n'est jamais détecté. Vous utilisez probablement le nom du fichier d'installation. Remplacez-le par le nom que le système d'exploitation rapporte.
• La détection échoue après une mise à jour. Les jokers peuvent être manquants. Une correspondance exacte échoue lorsque un suffixe de version apparaît.
• Les appareils montrent le logiciel comme installé alors qu'il ne l'est pas. Le motif correspond à d'autres logiciels. Resserrez-le ou utilisez =.

FAQ

1. Pourquoi la requête doit-elle renvoyer une ligne ?
   C'est ainsi que l'installation automatique sait que le logiciel est présent. Pas de ligne signifie "non installé", donc il réinstalle.
    
2. Puis-je garder la requête Factorial IT pré-remplie ?
   Seulement si elle correspond déjà au nom que le système d'exploitation rapporte. C'est une meilleure estimation basée sur le nom que vous avez tapé, donc vérifiez-le.
    
3. Sur Linux, dois-je utiliser le nom d'affichage ?
   Non. Utilisez le nom du package, tel que google-chrome-stable, sans version ni architecture.
    
4. Qu'en est-il des .sh et .tar.gz installateurs ?
   Vérifiez ce que le script installe. Interrogez deb_packages ou rpm_packages s'il enregistre un package ; sinon, recherchez un fichier ou un dossier qu'il crée.