Factorial IT puede instalar el sensor de CrowdStrike Falcon en dispositivos macOS, Windows y Ubuntu. Esta guía explica la implementación y cómo confirmar que cada sensor está realmente activado en su tenant de CrowdStrike.
Funcionalidad
Descripción general
| macOS | Windows | Linux | iOS / iPadOS | Android |
|---|---|---|---|---|
| ✅ | ✅ | ✅ (Ubuntu y otras distribuciones basadas en Debian, paquete .deb) |
CrowdStrike Falcon no se implementa automáticamente. Usted descarga los instaladores desde la consola de CrowdStrike, los sube y agrega un script con su CustomerID (CID) a cada paquete. Si omite el CID, el sensor se instala de todos modos, pero nunca se activa en su tenant de CrowdStrike.
Cómo usar
1. Descargue los instaladores y copie su CID
- Abra la consola de administración de CrowdStrike y vaya a Host setup and management > Deploy > Sensor downloads.
- Descargue los instaladores que necesite:
.pkgpara macOS,.exepara Windows y.debpara Ubuntu (elija el que corresponda a la arquitectura de CPU de sus dispositivos). - En el panel How to install, copie su CID. Lo necesitará en el paso 4.
2. Suba el perfil de configuración (solo macOS)
Vaya a MDM > Controles, abra su control de macOS y suba el siguiente mobileconfig como Archivo personalizado.
Hágalo antes de subir el instalador. macOS no ejecuta la extensión del sistema de Falcon hasta que se aprueba, y este perfil la aprueba de antemano. El perfil también configura el acceso total al disco, las notificaciones, el elemento de inicio administrado y el filtro de red. Si el sensor llega a un dispositivo antes que el perfil, su extensión del sistema queda pendiente de aprobación hasta que llega el perfil.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>PayloadContent</key>
<array>
<dict>
<key>AllowedSystemExtensions</key>
<dict>
<key>X9E956P446</key>
<array>
<string>com.crowdstrike.falcon.Agent</string>
</array>
</dict>
<key>NonRemovableFromUISystemExtensions</key>
<dict>
<key>X9E956P446</key>
<array>
<string>com.crowdstrike.falcon.Agent</string>
</array>
</dict>
<key>PayloadDescription</key>
<string>Allows the CrowdStrike Falcon system extension without user approval.</string>
<key>PayloadDisplayName</key>
<string>System Extensions - Crowdstrike</string>
<key>PayloadIdentifier</key>
<string>com.fleet.systemextensions</string>
<key>PayloadOrganization</key>
<string>CrowdStrike Inc.</string>
<key>PayloadType</key>
<string>com.apple.system-extension-policy</string>
<key>PayloadUUID</key>
<string>6527669C-0C1F-4B84-998F-33902DBFEB86</string>
<key>PayloadVersion</key>
<integer>1</integer>
</dict>
<dict>
<key>PayloadDescription</key>
<string>Grants Full Disk Access to the CrowdStrike Falcon processes.</string>
<key>PayloadDisplayName</key>
<string>Full Disk Access - Crowdstrike</string>
<key>PayloadIdentifier</key>
<string>com.fleet.privacy</string>
<key>PayloadOrganization</key>
<string>CrowdStrike Inc.</string>
<key>PayloadType</key>
<string>com.apple.TCC.configuration-profile-policy</string>
<key>PayloadUUID</key>
<string>C7B25543-8A46-4782-B5F1-FABF2CC07934</string>
<key>PayloadVersion</key>
<integer>1</integer>
<key>Services</key>
<dict>
<key>SystemPolicyAllFiles</key>
<array>
<dict>
<key>Allowed</key>
<true/>
<key>CodeRequirement</key>
<string>identifier "com.crowdstrike.falcon.Agent" and anchor apple generic and certificate 1[field.1.2.840.113635.100.6.2.6] /* exists */ and certificate leaf[field.1.2.840.113635.100.6.1.13] /* exists */ and certificate leaf[subject.OU] = X9E956P446</string>
<key>Identifier</key>
<string>com.crowdstrike.falcon.Agent</string>
<key>IdentifierType</key>
<string>bundleID</string>
<key>StaticCode</key>
<false/>
</dict>
<dict>
<key>Allowed</key>
<true/>
<key>CodeRequirement</key>
<string>identifier "com.crowdstrike.falcon.App" and anchor apple generic and certificate 1[field.1.2.840.113635.100.6.2.6] /* exists */ and certificate leaf[field.1.2.840.113635.100.6.1.13] /* exists */ and certificate leaf[subject.OU] = X9E956P446</string>
<key>Identifier</key>
<string>com.crowdstrike.falcon.App</string>
<key>IdentifierType</key>
<string>bundleID</string>
<key>StaticCode</key>
<false/>
</dict>
</array>
</dict>
</dict>
<dict>
<key>FilterDataProviderBundleIdentifier</key>
<string>com.crowdstrike.falcon.Agent</string>
<key>FilterDataProviderDesignatedRequirement</key>
<string>identifier "com.crowdstrike.falcon.Agent" and anchor apple generic and certificate 1[field.1.2.840.113635.100.6.2.6] and certificate leaf[field.1.2.840.113635.100.6.1.13] and certificate leaf[subject.OU] = "X9E956P446"</string>
<key>FilterGrade</key>
<string>inspector</string>
<key>FilterPackets</key>
<false/>
<key>FilterSockets</key>
<true/>
<key>FilterType</key>
<string>Plugin</string>
<key>Organization</key>
<string>CrowdStrike Inc.</string>
<key>PayloadDescription</key>
<string>Enables the CrowdStrike Falcon network filter.</string>
<key>PayloadDisplayName</key>
<string>Web Content Filter</string>
<key>PayloadIdentifier</key>
<string>com.fleet.webfilter</string>
<key>PayloadType</key>
<string>com.apple.webcontent-filter</string>
<key>PayloadUUID</key>
<string>E63C7607-408B-485F-BF2F-0900AAE6797F</string>
<key>PayloadVersion</key>
<integer>1</integer>
<key>PluginBundleID</key>
<string>com.crowdstrike.falcon.App</string>
<key>UserDefinedName</key>
<string>CrowdStrike</string>
</dict>
<dict>
<key>PayloadDescription</key>
<string>Manages the CrowdStrike Falcon login item.</string>
<key>PayloadDisplayName</key>
<string>Service Management</string>
<key>PayloadIdentifier</key>
<string>com.fleet.servicemanagement</string>
<key>PayloadOrganization</key>
<string>CrowdStrike Inc.</string>
<key>PayloadType</key>
<string>com.apple.servicemanagement</string>
<key>PayloadUUID</key>
<string>A7C1E2B4-5D3F-4E8A-9B6C-1F2E3D4C5B6A</string>
<key>PayloadVersion</key>
<integer>1</integer>
<key>Rules</key>
<array>
<dict>
<key>Comment</key>
<string>Falcon UserAgent</string>
<key>RuleType</key>
<string>BundleIdentifier</string>
<key>RuleValue</key>
<string>com.crowdstrike.falcon.UserAgent</string>
</dict>
<dict>
<key>Comment</key>
<string>All CrowdStrike login items</string>
<key>RuleType</key>
<string>TeamIdentifier</string>
<key>RuleValue</key>
<string>X9E956P446</string>
</dict>
</array>
</dict>
<dict>
<key>NotificationSettings</key>
<array>
<dict>
<key>AlertType</key>
<integer>1</integer>
<key>BundleIdentifier</key>
<string>com.crowdstrike.falcon.UserAgent</string>
<key>CriticalAlertEnabled</key>
<false/>
<key>NotificationsEnabled</key>
<true/>
<key>ShowInLockScreen</key>
<false/>
<key>ShowInNotificationCenter</key>
<true/>
</dict>
</array>
<key>PayloadDescription</key>
<string>Configures notifications for the CrowdStrike Falcon UserAgent.</string>
<key>PayloadDisplayName</key>
<string>Notifications</string>
<key>PayloadIdentifier</key>
<string>com.fleet.notifications</string>
<key>PayloadType</key>
<string>com.apple.notificationsettings</string>
<key>PayloadUUID</key>
<string>F5E94A3F-6E76-4A28-AF32-068455731244</string>
<key>PayloadVersion</key>
<integer>1</integer>
</dict>
</array>
<key>PayloadDescription</key>
<string>CrowdStrike Falcon - Full configuration (System Extensions, Full Disk Access, Web Filter, Service Management, Notifications)</string>
<key>PayloadDisplayName</key>
<string>CrowdStrike Falcon Configuration</string>
<key>PayloadIdentifier</key>
<string>com.factorialit.crowdstrike</string>
<key>PayloadOrganization</key>
<string>Factorial IT</string>
<key>PayloadScope</key>
<string>System</string>
<key>PayloadType</key>
<string>Configuration</string>
<key>PayloadUUID</key>
<string>D269B6A4-2E8D-4EC1-B818-ADAE81B8CF0B</string>
<key>PayloadVersion</key>
<integer>1</integer>
</dict>
</plist>3. Suba los instaladores como software personalizado
Para cada instalador:
- Vaya a MDM > Software, haga clic en Agregar y luego en Subir paquete personalizado, y suba el archivo.
- Active Instalar automáticamente. Factorial IT crea entonces la política que instala Falcon en los dispositivos objetivo que todavía no lo tienen.
- Para un
.exeo un.deb, reemplace el contenido de Consulta de detección de instalación por la consulta de esa plataforma (a continuación). Factorial IT completa este campo de antemano con una estimación basada en el nombre del archivo. - En Segmentación, elija Todos los dispositivos o Por grupo de dispositivos. Sin objetivo es la opción predeterminada y, con ella, Instalar automáticamente no instala el sensor en ningún lugar.
- Agregue los scripts de activación (paso 4) y haga clic en Agregar.
Consulta de detección de instalación por plataforma:
-
macOS: no hay nada que cambiar. Para un
.pkg, Factorial IT genera la consulta. -
Windows:
SELECT 1 FROM programs WHERE name LIKE 'CrowdStrike Windows Sensor%'; -
Ubuntu:
SELECT 1 FROM deb_packages WHERE name = 'falcon-sensor' AND status = 'install ok installed';
Cada .deb está compilado para una sola arquitectura de CPU. Asígnelo solo a dispositivos con esa arquitectura, por ejemplo mediante un grupo de dispositivos con el filtro Arquitectura de CPU.
Para instalar Falcon en cuanto se configura un dispositivo, active Instalar durante la configuración Zero Touch en cada paquete. Combínelo con las comprobaciones de activación que encontrará más abajo: durante la implementación zero-touch, el script de postinstalación puede ejecutarse antes de que exista la cuenta del empleado.
4. Agregue los scripts de activación
Abra Configuración avanzada en cada paquete (ya está abierta cuando agrega un .exe) y agregue los scripts de esa plataforma. En macOS y Ubuntu, no modifique Script de instalación: está vacío cuando agrega el paquete, así que se usa el script de instalación predeterminado. Reemplace el marcador de posición por su CID.
macOS
Pegue esto en Script de postinstalación. Activa el sensor con su CID justo después de la instalación y no hace nada en un dispositivo donde el sensor ya está activado.
#!/bin/bash
CUSTOMER_ID="YOUR-CUSTOMER-ID-HERE"
FALCONCTL="/Applications/Falcon.app/Contents/Resources/falconctl"
if [ -z "$CUSTOMER_ID" ] || [ "$CUSTOMER_ID" = "YOUR-CUSTOMER-ID-HERE" ]; then
echo "No customer ID set"
exit 1
fi
if [ ! -x "$FALCONCTL" ]; then
echo "falconctl not found at $FALCONCTL"
exit 1
fi
if "$FALCONCTL" stats agent_info 2>/dev/null | grep -q "agentID:.*[0-9a-fA-F]"; then
echo "Already activated"
exit 0
fi
if "$FALCONCTL" license "$CUSTOMER_ID"; then
echo "Activation completed"
exit 0
fi
echo "Activation failed"
exit 1Cuando el script de postinstalación falla, la instalación se marca como fallida y el agente intenta eliminar el software. Si una instalación en macOS falla, revise primero el CID.
Si su tenant de CrowdStrike necesita un token de aprovisionamiento, siga la guía de implementación del sensor para macOS de su consola de Falcon para pasárselo a falconctl.
Windows
Reemplace los scripts de instalación y desinstalación por los siguientes. En el script de instalación, reemplace CustomerID por su CID.
Script de instalación:
$exeFilePath = "${env:INSTALLER_PATH}"
try {
$processOptions = @{
FilePath = "$exeFilePath"
ArgumentList = "/install /quiet /norestart CID=CustomerID"
PassThru = $true
Wait = $true
}
$process = Start-Process @processOptions
$exitCode = $process.ExitCode
Write-Host "Install exit code: $exitCode"
Exit $exitCode
} catch {
Write-Host "Error: $_"
Exit 1
}Si su tenant de CrowdStrike necesita un token de aprovisionamiento, colóquelo después del CID en ArgumentList: CID=CustomerID ProvToken=YourToken.
Script de desinstalación:
try {
$regPaths = @(
"HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall",
"HKLM:\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall"
)
$app = $regPaths |
ForEach-Object { Get-ChildItem $_ -ErrorAction SilentlyContinue } |
Get-ItemProperty |
Where-Object { $_.DisplayName -like "CrowdStrike Windows Sensor*" } |
Select-Object -First 1
if (-not $app) {
Write-Host "CrowdStrike Falcon not found, nothing to uninstall"
Exit 0
}
$processOptions = @{
FilePath = $app.UninstallString
ArgumentList = "/quiet /norestart"
PassThru = $true
Wait = $true
}
$process = Start-Process @processOptions
$exitCode = $process.ExitCode
Write-Host "Uninstall exit code: $exitCode"
Exit $exitCode
} catch {
Write-Host "Error: $_"
Exit 1
}Ubuntu
Pegue esto en Script de postinstalación. Reproduce el script de instalación para Linux de la propia CrowdStrike: configura su CID y luego inicia el servicio falcon-sensor. En un dispositivo donde el sensor ya se está ejecutando, no hace nada.
#!/bin/bash
CUSTOMER_ID="YOUR-CUSTOMER-ID-HERE"
PROVISIONING_TOKEN="" # only if your Falcon console requires one
FALCONCTL="/opt/CrowdStrike/falconctl"
if [ -z "$CUSTOMER_ID" ] || [ "$CUSTOMER_ID" = "YOUR-CUSTOMER-ID-HERE" ]; then
echo "No customer ID set"
exit 1
fi
if [ ! -x "$FALCONCTL" ]; then
echo "falconctl not found at $FALCONCTL"
exit 1
fi
if pgrep -u root falcon-sensor >/dev/null 2>&1; then
echo "Sensor already running"
exit 0
fi
ARGS="--cid=$CUSTOMER_ID"
if [ -n "$PROVISIONING_TOKEN" ]; then
ARGS="$ARGS --provisioning-token=$PROVISIONING_TOKEN"
fi
# shellcheck disable=SC2086
if ! "$FALCONCTL" -s -f $ARGS; then
echo "Activation failed"
exit 1
fi
if command -v systemctl >/dev/null 2>&1; then
systemctl restart falcon-sensor || { echo "Sensor start failed"; exit 1; }
else
service falcon-sensor restart || { echo "Sensor start failed"; exit 1; }
fi
echo "Activation completed"
exit 0Configure PROVISIONING_TOKEN solo si su tenant de CrowdStrike lo necesita; de lo contrario, déjelo vacío.
Una vez activado, el sensor puede tardar unos minutos en aparecer en su consola de CrowdStrike.
Si el script termina con un error, la instalación se marca como fallida y el agente ejecuta el script de desinstalación, que elimina el sensor. Si una instalación en Ubuntu falla, revise primero el CID.
Si está editando un paquete que agregó antes, haga clic en Guardar.
Compruebe que el sensor está activado
Un sensor puede estar instalado sin estar activado. Sin un CID válido no envía nada a su tenant de CrowdStrike, pero la consulta de detección de instalación lo sigue dando por correcto. Las siguientes comprobaciones cubren macOS y Ubuntu.
Cree estas políticas en Fleet (Políticas > Agregar Política) para detectar los dispositivos que hay que corregir:
-
CrowdStrike activated falla cuando el sensor no tiene ID de agente o no tiene CID:
SELECT 1 FROM crowdstrike_falcon WHERE agent_id IS NOT NULL AND agent_id != '' AND cid IS NOT NULL AND cid != ''; -
CrowdStrike sensor loaded falla cuando el sensor tiene su CID pero no se está ejecutando. En macOS, normalmente significa que la extensión del sistema no se ha aprobado:
SELECT 1 FROM crowdstrike_falcon WHERE sensor_loaded = 'true'; -
CrowdStrike full protection falla cuando el sensor está en modo de funcionalidad reducida, con una protección más débil. Suele ocurrir tras una actualización del sistema operativo o del kernel que la versión instalada del sensor todavía no admite:
SELECT 1 FROM crowdstrike_falcon WHERE reduced_functionality_mode = 'false'; -
CrowdStrike system extension active (solo macOS) falla cuando la extensión del sistema de Falcon no está activada y habilitada, por ejemplo mientras sigue pendiente de aprobación:
SELECT 1 FROM system_extensions WHERE identifier = 'com.crowdstrike.falcon.Agent' AND team = 'X9E956P446' AND state = 'activated_enabled';
La tabla crowdstrike_falcon necesita fleetd 1.50 o posterior. Está disponible en macOS y Linux, pero no en Windows.
Para reintentar la activación automáticamente, asocie el script de postinstalación de la plataforma correspondiente a la política CrowdStrike activated como automatización de script (consulte la guía de Fleet: https://fleetdm.com/guides/policy-automation-run-script). Use una política distinta para cada plataforma. Fleet ejecuta el script cuando un dispositivo empieza a no cumplir la política y lo vuelve a intentar hasta tres veces mientras el script devuelva un error. Ambos scripts dejan intacto un sensor que ya está activado o en ejecución, así que los reintentos son seguros.
Consejos y Mejores Prácticas
- Suba el perfil de macOS antes que el instalador. De lo contrario, la extensión del sistema queda pendiente de aprobación y el sensor no se ejecuta.
- Configure siempre el CID. Un sensor instalado sin CID parece correcto en Factorial IT, pero no envía nada a CrowdStrike.
- Elija un objetivo. Sin objetivo es la opción predeterminada y no instala el sensor en ningún dispositivo.
-
Haga coincidir cada
.debcon su arquitectura de CPU. Use un grupo de dispositivos con el filtro Arquitectura de CPU. - Agregue las políticas de activación. Son la única forma de distinguir un sensor instalado de uno activado.
Solución de problemas y FAQ
Solución de problemas
- Una instalación en macOS o Ubuntu se marca como fallida. El script de postinstalación devolvió un error, así que el agente eliminó el sensor. Revise primero el CID.
- El sensor está instalado pero no aparece en CrowdStrike. Probablemente se instaló sin un CID válido. La política CrowdStrike activated detecta estos dispositivos. Justo después de la activación, espere unos minutos a que se registre.
- El sensor tiene su CID pero no se ejecuta en una Mac. Normalmente la extensión del sistema está pendiente de aprobación. Compruebe que el perfil de configuración está instalado. La política CrowdStrike system extension active muestra los dispositivos afectados.
- El sensor funciona en modo de funcionalidad reducida. Suele ocurrir después de una actualización del sistema operativo o del kernel que su versión del sensor todavía no admite. Compruebe que su versión del sensor admite el nuevo sistema operativo o kernel.
- No se instala nada aunque Instalar automáticamente está activado. Revise Segmentación: con Sin objetivo seleccionado, ningún dispositivo recibe el sensor.
FAQ
-
¿Dónde encuentro mi CID?
En la consola de CrowdStrike, en el panel How to install dentro de Host setup and management > Deploy > Sensor downloads.
-
Mi tenant necesita un token de aprovisionamiento. ¿Dónde lo coloco?
En Windows, después del CID enArgumentList. En Ubuntu, enPROVISIONING_TOKEN. En macOS, siga la guía de implementación del sensor de su consola de Falcon.
-
¿Las comprobaciones de activación funcionan en Windows?
No. La tablacrowdstrike_falconsolo existe en macOS y Linux.
-
¿Es seguro volver a ejecutar los scripts de activación?
Sí. No hacen ningún cambio en un dispositivo que ya está activado o en ejecución.