Gérer les plug-ins d'intégration de la sécurité des points de terminaison pour Windows

Les plugins d'intégration de sécurité des points de terminaison étendent la fonctionnalité équivalente d'Okta en permettant à Okta Verify de collecter des signaux de confiance à partir de l'appareil Windowssur lequel il s'exécute.

Vous pouvez utiliser un outil de gestion des appareils mobiles (MDM) pour configurer les plug-ins sur votre appareil Windows (par exemple, en utilisant des scripts PowerShell). Vous pouvez exécuter ces scripts pour installer et désinstaller les plug-ins sur chaque appareil individuellement. Cela vous permet de spécifier les signaux d'appareils à collecter.

Sur les appareils Windows, ces plug-ins se trouvent dans le dossier %PROGRAMDATA%\Okta\OktaVerify\Plugins.

Avant de commencer

Installer le plugin d'intégration de sécurité relative au point de terminaison WSC

Par défaut, le plug-in Security Center (WSC) de Windows est installé automatiquement lors de l'installation de Okta Verify.

Si vous devez réinstaller le plugin ultérieurement pour une raison quelconque, désinstallez la version actuelle, puis utilisez ce script.

$content = "{`r`n`t`"name`": `"com.okta.windowsSecurityCenter`",`r`n`t`"description`": `"Okta provided integration collecting signals through the Windows Security Center APIs.`",`r`n`t`"type`": `"DEFAULT`",`r`n`t`"format`": `"JSON`",`r`n`t`"availabilityChecks`": [`r`n`t`t{`r`n`t`t`t`"type`": `"SERVICE_RUNNING`",`r`n`t`t`t`"value`": `"wscsvc`"`r`n`t`t}`r`n`t]`r`n}"
$path = $env:ProgramData + "\Okta\OktaVerify\Plugins\"
$filePath = $path + "com.okta.windowsSecurityCenter.json"
if (-not (Test-Path $path))
{
New-Item $path -ItemType Directory
}
$content | Out-File -FilePath $filePath

Le script PowerShell configure le fichier de plugin JSON suivant :

{
  "name": "com.okta.windowsSecurityCenter",
  "description": "Okta provided integration collecting signals through the Windows Security Center APIs.",
  "type": "DEFAULT",
  "format": "JSON",
  "availabilityChecks": [
    {
      "type": "SERVICE_RUNNING",
      "value": "wscsvc"
    }
  ]
}

Installer le plug-in d'intégration de la sécurité des points de terminaison CrowdStrike

Le plug-in CrowdStrike n'est pas installé automatiquement lorsque Okta Verify est installé. En fonction de votre scénario d'installation, désinstallez la version actuelle s'il en existe une, puis suivez la procédure d'installation appropriée :

Déployer Okta Verify sur les appareils Windows

N'utilisez pas le script PowerShell dans ce scénario. Utilisez plutôt la ligne de commande fournie par votre outil de gestion (GPO, logiciel MDM) pour inclure l'indicateur EnableZTAPlugin dans la commande d'installation.

Consultez Okta Verify les options d'installation pour Windows les options d'installation.

Tous les autres scénarios de déploiement

D'autres scénarios sont également possibles :

  • L'utilisateur final a installé Okta Verify sur son appareil, plutôt qu'un administrateur via un outil de gestion.
  • Vous voulez activer ou désactiver la fonctionnalité après que Okta Verify soit déjà installé sur l'appareil.

Utilisez le script PowerShell suivant :

$content = "{`r`n`t`"name`": `"com.crowdstrike.zta`",`r`n`t`"description`": `"Okta provided integration with CrowdStrike Falcon endpoint collecting the zta score.`",`r`n`t`"type`": `"FILE`",`r`n`t`"format`": `"JWT`",`r`n`t`"location`": `"%ProgramData%\\CrowdStrike\\ZeroTrustAssessment\\data.zta`",`r`n`t`"availabilityChecks`": [`r`n`t`t{`r`n`t`t`t`"type`": `"SERVICE_RUNNING`",`r`n`t`t`t`"value`": `"csagent`"`r`n`t`t}`r`n`t]`r`n}"
$path = $env:ProgramData + "\Okta\OktaVerify\Plugins\"
$filePath = $path + "com.crowdstrike.zta.json"
if (-not (Test-Path $path))
{
New-Item $path -ItemType Directory
}
[System.IO.File]::WriteAllText($filePath, $content)

Le script PowerShell génère le fichier plug-in JSON :

{
  "name": "com.crowdstrike.zta",
  "description": "Okta provided integration with CrowdStrike Falcon endpoint collecting the zta score.",
  "type": "FILE",
  "format": "JWT",
  "location": "%ProgramData%\\CrowdStrike\\ZeroTrustAssessment\\data.zta",
  "availabilityChecks": [
    {
      "type": "SERVICE_RUNNING",
      "value": "csagent"
    }
  ]
}

Installer le plug-in d'intégration osquery

Le plug-in d'intégration osquery est nécessaire à la fonctionnalité de vérifications de posture avancées. Le plug-in n'est pas installé automatiquement lorsque Okta Verify est installé.

Le plug-in nécessite que la valeur de configuration EnableOSQueryCustomChecks soit définie, ainsi qu'un fichier manifeste de plug-in contenant une liste des domaines autorisés. Consultez EnableOSQueryCustomChecks dans Okta VerifyConfigurations pour les appareils Windows.

Utilisez le script PowerShell suivant pour générer le fichier manifeste :

$manifest = [ordered]@{
    name           = "com.okta.device.osquery"
    description    = "Okta provided integration collecting signals through osquery."
    type           = "com.okta.device.osquery"
    format         = "JSON"
    timeout        = 10000
    allowedDomains = @("okta.okta.com", "okta.example.com") # Add your allowed domains here
}
$filePath = "$env:ProgramData\Okta\OktaVerify\Plugins\com.okta.device.osquery.json"
$content = $manifest | ConvertTo-Json
$utf8 = New-Object System.Text.UTF8Encoding($false)
[System.IO.File]::WriteAllText($filePath, $content, $utf8)

Exemple de fichier manifeste :

{
  "name": "com.okta.device.osquery",
  "description": "Okta provided integration collecting signals through osquery.",
  "type": "com.okta.device.osquery",
  "format": "JSON",
  "timeout": 10000,
  "allowedDomains": [
    "okta.okta.com", 
    "okta.example.com"
  ]
}

Désinstaller un plug-in d'intégration de sécurité relative au point de terminaison

Désinstallez toujours le plug-in d'intégration de sécurité relative au point de terminaison actuel avant d'installer une nouvelle version.

Pour désinstaller un plug-in d'intégration de la sécurité des points de terminaison sur des ordinateurs Windows pour quelque raison que ce soit, utilisez le script PowerShell suivant.

$path = $env:ProgramData + "\Okta\OktaVerify\Plugins\[JSON_FILE_NAME]"
if ((Test-Path $path))
{
Remove-Item -Path $path
}

Remplacez [JSON_FILE_NAME] dans le script PowerShell par le fichier JSON applicable :

  • WindowsCentre de sécurité : com.okta.windowsSecurityCenter.json
  • CrowdStrike : com.crowdstrike.zta.json
  • osquery : com.okta.device.osquery.json

Étapes suivantes