La Instalación Automática necesita una consulta de detección que reconozca tu software una vez que esté instalado. Esta guía muestra cómo encontrar el nombre exacto que Windows o Linux utiliza para ello, para que la consulta funcione.

Funcionalidad

Descripción general

Cuando activas la Instalación Automática para un paquete personalizado (.exe, .ps1, .deb, .rpm, .sh o .tar.gz), Factorial IT pre-rellena una osquery basada en el nombre del software que ingresaste. Es una suposición informada.

La regla es simple: cuando el software está instalado, la consulta debe devolver al menos una fila. Si no devuelve nada, el agente piensa que el software está ausente e instala el paquete nuevamente en cada verificación.

Para solucionar esto, cambia el valor dentro de LIKE '%...%' para que coincida con el nombre que el sistema operativo informa para el software instalado, no con el nombre del instalador.

Cómo usar

1. Abre el paquete personalizado y activa Instalación Automática.
2. Mira la consulta pre-rellenada.
3. Encuentra el nombre exacto instalado con el método para tu tipo de paquete (a continuación).
4. Reemplaza el valor dentro de LIKE '%...%' con ese nombre.
5. Dirígete primero a un pequeño grupo de dispositivos y verifica que la instalación se comporte como se espera.
6. Despliega al resto de la flota.

Windows (.exe, .ps1)

Consulta pre-rellenada:

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

Dónde encontrar el nombre exacto:

• La lista de software instalado en Detalles del host de la flota
• Aplicaciones y características en la Configuración de Windows
• PowerShell: Get-Package | Where-Object Name -Like '*<name>*'

Ejemplo: el instalador es FalconSensor_Windows.exe, pero Windows lista el software como CrowdStrike Windows Sensor. La consulta se convierte en:

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

Linux .deb

Para paquetes de Debian y Ubuntu.

Consulta pre-rellenada:

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

Dónde encontrar el nombre exacto:

• Ejecuta dpkg -l | grep <name>. El nombre del paquete está en la primera columna.
• Usa el nombre del paquete (por ejemplo google-chrome-stable), no el nombre de visualización amigable.

Linux .rpm

Consulta pre-rellenada:

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

Dónde encontrar el nombre exacto:

• Ejecuta rpm -qa | grep <name>.
• Mantén solo el nombre del paquete, sin sufijo de versión o arquitectura.

Scripts y archivos (.sh, .tar.gz)

Para scripts de instalación de Linux y archivos, lo que termina en disco depende del script. Lee el script, o su README, para averiguarlo:

• Si registra un paquete en deb_packages o rpm_packages. Si lo hace, consulta esa tabla.
• Si no, qué binario o directorio crea. Consulta eso con file o osquery_info.

Solución de Problemas y FAQ

Solución de Problemas

• El paquete se reinstala en cada verificación. La consulta no devuelve filas, por lo que el software nunca se detecta. Probablemente estés utilizando el nombre del archivo del instalador. Reemplázalo con el nombre que informa el sistema operativo.
• La detección falla después de una actualización. Puede que falten los comodines. Una coincidencia exacta se rompe cuando aparece un sufijo de versión.
• Los dispositivos muestran el software como instalado cuando no lo está. El patrón coincide con otro software. Ajusta el patrón o usa =.

FAQ

1. ¿Por qué la consulta tiene que devolver una fila?
   Así es como la Instalación Automática sabe que el software está presente. Sin filas significa "no instalado", por lo que instala nuevamente.
    
2. ¿Puedo mantener la consulta Factorial IT pre-rellenada?
   Solo si ya coincide con el nombre que informa el sistema operativo. Es una suposición informada basada en el nombre que escribiste, así que revísalo.
    
3. ¿En Linux, debo usar el nombre de visualización?
   No. Usa el nombre del paquete, como google-chrome-stable, sin versión ni arquitectura.
    
4. ¿Qué pasa con .sh y .tar.gz instaladores?
   Verifica qué instala el script. Consulta deb_packages o rpm_packages si registra un paquete; de lo contrario, busca un archivo o carpeta que cree.