Factorial IT peut installer le capteur CrowdStrike Falcon sur les appareils macOS, Windows et Ubuntu. Ce guide explique le déploiement et comment vérifier que chaque capteur est réellement activé dans ton tenant CrowdStrike.
Fonctionnement
Vue d'ensemble
| macOS | Windows | Linux | iOS / iPadOS | Android |
|---|---|---|---|---|
| ✅ | ✅ | ✅ (Ubuntu et autres distributions basées sur Debian, package .deb) |
CrowdStrike Falcon n'est pas déployé automatiquement. Tu télécharges les installateurs depuis la console CrowdStrike, tu les charges et tu ajoutes à chaque package un script contenant ton CustomerID (CID). Sans le CID, le capteur s'installe quand même, mais il ne s'active jamais dans ton tenant CrowdStrike.
Étapes
1. Télécharger les installateurs et copier ton CID
- Ouvre la console d'administration CrowdStrike et va dans Host setup and management > Deploy > Sensor downloads.
- Télécharge les installateurs dont tu as besoin :
.pkgpour macOS,.exepour Windows et.debpour Ubuntu (choisis celui qui correspond à l'architecture CPU de tes appareils). - Dans le panneau How to install, copie ton CID. Tu en auras besoin à l'étape 4.
2. Charger le profil de configuration (macOS uniquement)
Va dans MDM > Contrôles, ouvre ton contrôle macOS et charge le mobileconfig ci-dessous en tant que Fichier personnalisé.
Fais-le avant de charger l'installateur. macOS n'exécute pas l'extension système de Falcon tant qu'elle n'est pas approuvée, et ce profil l'approuve à l'avance. Le profil configure aussi l'accès complet au disque, les notifications, l'élément d'ouverture géré et le filtre réseau. Si le capteur arrive sur un appareil avant le profil, son extension système reste en attente d'approbation jusqu'à l'arrivée du profil.
<?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. Charger les installateurs en tant que logiciel personnalisé
Pour chaque installateur :
- Va dans MDM > Logiciel, clique sur Ajouter, puis sur Charger un package personnalisé, et charge le fichier.
- Active Installer automatiquement. Factorial IT crée alors la politique qui installe Falcon sur les appareils ciblés qui ne l'ont pas encore.
- Pour un
.exeou un.deb, remplace le contenu de Requête de détection d'installation par la requête de cette plateforme (ci-dessous). Factorial IT pré-remplit ce champ avec une estimation basée sur le nom du fichier. - Dans Ciblage, choisis Tous les appareils ou Par groupe d'appareils. Aucune cible est l'option par défaut : avec elle, Installer automatiquement n'installe le capteur nulle part.
- Ajoute les scripts d'activation (étape 4), puis clique sur Ajouter.
Requête de détection d'installation par plateforme :
-
macOS : rien à modifier. Pour un
.pkg, Factorial IT génère la requête. -
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';
Chaque .deb est compilé pour une seule architecture CPU. Cible-le uniquement sur les appareils de cette architecture, par exemple via un groupe d'appareils utilisant le filtre Architecture CPU.
Pour installer Falcon dès qu'un appareil est provisionné, active Installer pendant la configuration zero-touch sur chaque package. Combine-le avec les vérifications d'activation décrites plus bas : lors du déploiement zero-touch, le script de post-installation peut s'exécuter avant que le compte de la personne n'existe.
4. Ajouter les scripts d'activation
Ouvre les Paramètres avancés de chaque package (ils sont déjà ouverts quand tu ajoutes un .exe) et ajoute les scripts de cette plateforme. Sur macOS et Ubuntu, ne touche pas au Script d'installation : il est vide quand tu ajoutes le package, donc le script d'installation par défaut est utilisé. Remplace l'espace réservé par ton CID.
macOS
Colle ceci dans Script de post-installation. Il active le capteur avec ton CID juste après l'installation et ne fait rien sur un appareil où le capteur est déjà activé.
#!/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 1Lorsque le script de post-installation échoue, l'installation est marquée comme échouée et l'agent tente de supprimer le logiciel. Si une installation macOS échoue, vérifie d'abord le CID.
Si ton tenant CrowdStrike exige un jeton de provisionnement, suis le guide de déploiement du capteur macOS de ta console Falcon pour le transmettre à falconctl.
Windows
Remplace les scripts d'installation et de désinstallation par ceux ci-dessous. Dans le script d'installation, remplace CustomerID par ton CID.
Script d'installation :
$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 ton tenant CrowdStrike exige un jeton de provisionnement, ajoute-le après le CID dans ArgumentList : CID=CustomerID ProvToken=YourToken.
Script de désinstallation :
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
Colle ceci dans Script de post-installation. Il reproduit le script d'installation Linux de CrowdStrike : il définit ton CID puis démarre le service falcon-sensor. Sur un appareil où le capteur est déjà en cours d'exécution, il ne fait rien.
#!/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 0Définis PROVISIONING_TOKEN uniquement si ton tenant CrowdStrike en exige un ; sinon, laisse-le vide.
Une fois activé, le capteur peut mettre quelques minutes à apparaître dans ta console CrowdStrike.
Si le script se termine par une erreur, l'installation est marquée comme échouée et l'agent exécute le script de désinstallation, qui supprime le capteur. Si une installation Ubuntu échoue, vérifie d'abord le CID.
Si tu modifies un package ajouté précédemment, clique sur Enregistrer.
Vérifier que le capteur est activé
Un capteur peut être installé sans être activé. Sans CID valide, il ne remonte rien à ton tenant CrowdStrike, mais la requête de détection d'installation le considère quand même comme installé. Les vérifications ci-dessous couvrent macOS et Ubuntu.
Crée ces politiques dans Fleet (Politiques > Ajouter une politique) pour repérer les appareils à corriger :
-
CrowdStrike activated échoue lorsque le capteur n'a pas d'ID d'agent ou pas de 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 échoue lorsque le capteur a son CID mais ne s'exécute pas. Sur macOS, cela signifie généralement que l'extension système n'a pas été approuvée :
SELECT 1 FROM crowdstrike_falcon WHERE sensor_loaded = 'true'; -
CrowdStrike full protection échoue lorsque le capteur est en mode de fonctionnalités réduites, avec une protection moindre. Cela arrive généralement après une mise à jour du système d'exploitation ou du noyau que la version installée du capteur ne prend pas encore en charge :
SELECT 1 FROM crowdstrike_falcon WHERE reduced_functionality_mode = 'false'; -
CrowdStrike system extension active (macOS uniquement) échoue lorsque l'extension système de Falcon n'est pas activée et autorisée, par exemple tant qu'elle attend encore une approbation :
SELECT 1 FROM system_extensions WHERE identifier = 'com.crowdstrike.falcon.Agent' AND team = 'X9E956P446' AND state = 'activated_enabled';
La table crowdstrike_falcon nécessite fleetd 1.50 ou une version ultérieure. Elle est disponible sur macOS et Linux, mais pas sur Windows.
Pour relancer l'activation automatiquement, associe le script de post-installation de la plateforme concernée à la politique CrowdStrike activated en tant qu'automatisation de script (voir le guide de Fleet : https://fleetdm.com/guides/policy-automation-run-script). Utilise une politique distincte par plateforme. Fleet exécute le script lorsqu'un appareil commence à échouer à la politique et réessaie jusqu'à trois fois tant que le script renvoie une erreur. Les deux scripts laissent intact un capteur déjà activé ou en cours d'exécution : les nouvelles tentatives sont donc sans risque.
Conseils et bonnes pratiques
- Charge le profil macOS avant l'installateur. Sinon, l'extension système attend une approbation et le capteur ne s'exécute pas.
- Définis toujours le CID. Un capteur installé sans CID semble correct dans Factorial IT, mais ne remonte rien à CrowdStrike.
- Choisis une cible. Aucune cible est l'option par défaut et n'installe le capteur sur aucun appareil.
-
Associe chaque
.debà son architecture CPU. Utilise un groupe d'appareils avec le filtre Architecture CPU. - Ajoute les politiques d'activation. C'est le seul moyen de distinguer un capteur installé d'un capteur activé.
Résolution des problèmes et FAQ
Résolution des problèmes
- Une installation macOS ou Ubuntu est marquée comme échouée. Le script de post-installation a renvoyé une erreur, l'agent a donc supprimé le capteur. Vérifie d'abord le CID.
- Le capteur est installé mais n'apparaît pas dans CrowdStrike. Il a probablement été installé sans CID valide. La politique CrowdStrike activated signale ces appareils. Juste après l'activation, laisse quelques minutes pour l'enregistrement.
- Le capteur a son CID mais ne s'exécute pas sur un Mac. L'extension système attend généralement une approbation. Vérifie que le profil de configuration est installé. La politique CrowdStrike system extension active affiche les appareils concernés.
- Le capteur fonctionne en mode de fonctionnalités réduites. Cela fait généralement suite à une mise à jour du système d'exploitation ou du noyau que ta version du capteur ne prend pas encore en charge. Vérifie que ta version du capteur prend en charge le nouveau système ou noyau.
- Rien ne s'installe alors qu'Installer automatiquement est activé. Vérifie Ciblage : avec Aucune cible sélectionné, aucun appareil ne reçoit le capteur.
FAQ
-
Où trouver mon CID ?
Dans la console CrowdStrike, dans le panneau How to install sous Host setup and management > Deploy > Sensor downloads.
-
Mon tenant exige un jeton de provisionnement. Où dois-je le mettre ?
Sur Windows, après le CID dansArgumentList. Sur Ubuntu, dansPROVISIONING_TOKEN. Sur macOS, suis le guide de déploiement du capteur de ta console Falcon.
-
Les vérifications d'activation fonctionnent-elles sur Windows ?
Non. La tablecrowdstrike_falconn'existe que sur macOS et Linux.
-
Peut-on relancer les scripts d'activation sans risque ?
Oui. Ils ne modifient rien sur un appareil déjà activé ou en cours d'exécution.