O Factorial IT pode instalar o sensor CrowdStrike Falcon em dispositivos macOS, Windows e Ubuntu. Este guia explica a implementação e como confirmar que cada sensor está realmente ativado no seu tenant do CrowdStrike.
Funcionalidade
Visão Geral
| macOS | Windows | Linux | iOS / iPadOS | Android |
|---|---|---|---|---|
| ✅ | ✅ | ✅ (Ubuntu e outras distribuições baseadas em Debian, pacote .deb) |
O CrowdStrike Falcon não é implementado automaticamente. Transfere os instaladores a partir da consola do CrowdStrike, carrega-os e adiciona a cada pacote um script com o seu CustomerID (CID). Sem o CID, o sensor é instalado na mesma, mas nunca é ativado no seu tenant do CrowdStrike.
Como usar
1. Transfira os instaladores e copie o seu CID
- Abra a consola de administração do CrowdStrike e aceda a Host setup and management > Deploy > Sensor downloads.
- Transfira os instaladores de que precisa:
.pkgpara macOS,.exepara Windows e.debpara Ubuntu (escolha o que corresponde à arquitetura de CPU dos seus dispositivos). - No painel How to install, copie o seu CID. Vai precisar dele no passo 4.
2. Carregue o perfil de configuração (apenas macOS)
Aceda a MDM > Controlos, abra o seu controlo de macOS e carregue o mobileconfig abaixo como Ficheiro personalizado.
Faça-o antes de carregar o instalador. O macOS não executa a extensão de sistema do Falcon enquanto não for aprovada, e este perfil aprova-a antecipadamente. O perfil também configura o acesso total ao disco, as notificações, o item de início de sessão gerido e o filtro de rede. Se o sensor chegar a um dispositivo antes do perfil, a extensão de sistema fica a aguardar aprovação até o perfil chegar.
<?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. Carregue os instaladores como software personalizado
Para cada instalador:
- Aceda a MDM > Software, clique em Adicionar e depois em Carregar pacote personalizado, e carregue o ficheiro.
- Ative Instalar automaticamente. O Factorial IT cria então a política que instala o Falcon nos dispositivos de destino que ainda não o têm.
- Para um
.exeou um.deb, substitua o conteúdo de Consulta de deteção de instalação pela consulta dessa plataforma (abaixo). O Factorial IT preenche este campo antecipadamente com uma estimativa baseada no nome do ficheiro. - Em Segmentação, escolha Todos os dispositivos ou Por grupo de dispositivos. Sem destino é a predefinição e, com ela, Instalar automaticamente não instala o sensor em lado nenhum.
- Adicione os scripts de ativação (passo 4) e clique em Adicionar.
Consulta de deteção de instalação por plataforma:
-
macOS: nada a alterar. Para um
.pkg, o Factorial IT gera a 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 é compilado para uma única arquitetura de CPU. Atribua-o apenas a dispositivos com essa arquitetura, por exemplo, através de um grupo de dispositivos com o filtro Arquitetura de CPU.
Para instalar o Falcon assim que um dispositivo é aprovisionado, ative Instalar durante a configuração Zero Touch em cada pacote. Combine-o com as verificações de ativação descritas mais abaixo: durante a implementação zero-touch, o script de pós-instalação pode ser executado antes de a conta do colaborador existir.
4. Adicione os scripts de ativação
Abra Definições avançadas em cada pacote (já estão abertas quando adiciona um .exe) e adicione os scripts dessa plataforma. No macOS e no Ubuntu, não altere o Script de instalação: está vazio quando adiciona o pacote, por isso é utilizado o script de instalação predefinido. Substitua o marcador pelo seu CID.
macOS
Cole isto em Script de pós-instalação. Ativa o sensor com o seu CID logo após a instalação e não faz nada num dispositivo em que o sensor já está ativado.
#!/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 1Quando o script de pós-instalação falha, a instalação é marcada como falhada e o agente tenta remover o software. Se uma instalação no macOS falhar, verifique primeiro o CID.
Se o seu tenant do CrowdStrike exigir um token de aprovisionamento, siga o guia de implementação do sensor para macOS na sua consola do Falcon para o passar ao falconctl.
Windows
Substitua os scripts de instalação e desinstalação pelos seguintes. No script de instalação, substitua CustomerID pelo seu CID.
Script de instalação:
$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
}Se o seu tenant do CrowdStrike exigir um token de aprovisionamento, coloque-o depois do CID em ArgumentList: CID=CustomerID ProvToken=YourToken.
Script de desinstalação:
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
Cole isto em Script de pós-instalação. Reproduz o próprio script de instalação para Linux do CrowdStrike: define o seu CID e depois inicia o serviço falcon-sensor. Num dispositivo em que o sensor já está em execução, não faz 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 0Defina PROVISIONING_TOKEN apenas se o seu tenant do CrowdStrike exigir um; caso contrário, deixe-o vazio.
Depois de ativado, o sensor pode demorar alguns minutos a aparecer na sua consola do CrowdStrike.
Se o script terminar com erro, a instalação é marcada como falhada e o agente executa o script de desinstalação, que remove o sensor. Se uma instalação no Ubuntu falhar, verifique primeiro o CID.
Se estiver a editar um pacote adicionado anteriormente, clique em Guardar.
Verifique se o sensor está ativado
Um sensor pode estar instalado sem estar ativado. Sem um CID válido, não reporta nada ao seu tenant do CrowdStrike, mas a consulta de deteção de instalação continua a ser aprovada. As verificações abaixo abrangem macOS e Ubuntu.
Crie estas políticas no Fleet (Políticas > Adicionar Política) para identificar os dispositivos que precisam de correção:
-
CrowdStrike activated falha quando o sensor não tem ID de agente ou não tem 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 falha quando o sensor tem o seu CID mas não está em execução. No macOS, isto significa normalmente que a extensão de sistema não foi aprovada:
SELECT 1 FROM crowdstrike_falcon WHERE sensor_loaded = 'true'; -
CrowdStrike full protection falha quando o sensor está no modo de funcionalidade reduzida, com proteção mais fraca. Isto acontece normalmente após uma atualização do sistema operativo ou do kernel que a versão instalada do sensor ainda não suporta:
SELECT 1 FROM crowdstrike_falcon WHERE reduced_functionality_mode = 'false'; -
CrowdStrike system extension active (apenas macOS) falha quando a extensão de sistema do Falcon não está ativada e permitida, por exemplo, enquanto ainda aguarda aprovação:
SELECT 1 FROM system_extensions WHERE identifier = 'com.crowdstrike.falcon.Agent' AND team = 'X9E956P446' AND state = 'activated_enabled';
A tabela crowdstrike_falcon requer o fleetd 1.50 ou posterior. Está disponível no macOS e no Linux, mas não no Windows.
Para tentar novamente a ativação de forma automática, associe o script de pós-instalação da plataforma correspondente à política CrowdStrike activated como automatização de script (consulte o guia do Fleet: https://fleetdm.com/guides/policy-automation-run-script). Utilize uma política diferente para cada plataforma. O Fleet executa o script quando um dispositivo começa a falhar a política e tenta novamente até três vezes enquanto o script devolver um erro. Os dois scripts não alteram um sensor que já está ativado ou em execução, por isso as novas tentativas são seguras.
Dicas e Melhores Práticas
- Carregue o perfil do macOS antes do instalador. Caso contrário, a extensão de sistema fica a aguardar aprovação e o sensor não é executado.
- Defina sempre o CID. Um sensor instalado sem CID parece correto no Factorial IT, mas não reporta nada ao CrowdStrike.
- Escolha um destino. Sem destino é a predefinição e não instala o sensor em nenhum dispositivo.
-
Associe cada
.debà respetiva arquitetura de CPU. Utilize um grupo de dispositivos com o filtro Arquitetura de CPU. - Adicione as políticas de ativação. São a única forma de distinguir um sensor instalado de um ativado.
Solução de Problemas e FAQ
Solução de Problemas
- Uma instalação no macOS ou no Ubuntu é marcada como falhada. O script de pós-instalação devolveu um erro, por isso o agente removeu o sensor. Verifique primeiro o CID.
- O sensor está instalado mas não aparece no CrowdStrike. Provavelmente foi instalado sem um CID válido. A política CrowdStrike activated assinala estes dispositivos. Logo após a ativação, aguarde alguns minutos pelo registo.
- O sensor tem o seu CID mas não está em execução num Mac. Normalmente a extensão de sistema está a aguardar aprovação. Verifique se o perfil de configuração está instalado. A política CrowdStrike system extension active mostra os dispositivos afetados.
- O sensor está no modo de funcionalidade reduzida. Isto acontece normalmente após uma atualização do sistema operativo ou do kernel que a sua versão do sensor ainda não suporta. Verifique se a sua versão do sensor suporta o novo sistema operativo ou kernel.
- Nada é instalado mesmo com Instalar automaticamente ativado. Verifique Segmentação: com Sem destino selecionado, nenhum dispositivo recebe o sensor.
FAQ
-
Onde encontro o meu CID?
Na consola do CrowdStrike, no painel How to install em Host setup and management > Deploy > Sensor downloads.
-
O meu tenant exige um token de aprovisionamento. Onde o coloco?
No Windows, depois do CID emArgumentList. No Ubuntu, emPROVISIONING_TOKEN. No macOS, siga o guia de implementação do sensor na sua consola do Falcon.
-
As verificações de ativação funcionam no Windows?
Não. A tabelacrowdstrike_falconexiste apenas no macOS e no Linux.
-
É seguro executar os scripts de ativação novamente?
Sim. Não fazem qualquer alteração num dispositivo que já está ativado ou em execução.