Microsoft Defender for Endpoint
Ce document explique comment intégrer Microsoft Defender pour point de terminaison à Google SecOps.
Cas d'utilisation
Utilisez les données collectées dans Microsoft Defender pour point de terminaison pour enrichir vos investigations sur un cas particulier.
Les analystes peuvent utiliser les données collectées et stockées dans Microsoft Defender for Endpoint lors des investigations, par exemple pour obtenir des informations sur les alertes détectées dans Microsoft Defender for Endpoint ou lister les machines enregistrées dans Microsoft Defender for Endpoint.
Effectuer des actions de réponse active lors d'incidents de sécurité potentiels, comme isoler un hôte spécifique d'un réseau ou exécuter une analyse antivirus.
Surveillez et inspectez les alertes Microsoft Defender for Endpoint en tant qu'alertes Google Security Operations récupérées par le connecteur correspondant.
Prérequis
Avant de configurer l'intégration dans la plate-forme Google SecOps, veillez à effectuer les étapes préalables suivantes :
Créez l'application Microsoft Entra.
Configurez les autorisations de l'API pour votre application.
Créez un code secret du client.
Nous vous recommandons d'utiliser le contexte d'application plutôt que le contexte utilisateur lorsque vous accédez à l'API Microsoft Defender pour point de terminaison.
Créer une application Microsoft Entra
Connectez-vous au portail Azure en tant qu'administrateur d'utilisateurs ou administrateur de mots de passe.
Sélectionnez Microsoft Entra ID.
Accédez à Inscriptions d'applications > Nouvelle inscription.
Saisissez le nom de l'application.
Cliquez sur S'inscrire.
Enregistrez les valeurs ID d'application (client) et ID d'annuaire (locataire) pour les utiliser ultérieurement lors de la configuration des paramètres d'intégration.
Configurer les autorisations de l'API
Accédez à API Permissions> Add a permission> APIs my organization uses (Autorisations d'API > Ajouter une autorisation > API utilisées par mon organisation). La boîte de dialogue Demander des autorisations d'API s'ouvre.
Dans le champ Rechercher, saisissez
WindowsDefenderATP.Sélectionnez WindowsDefenderATP > Application permissions (Autorisations de l'application).
Sous le type d'autorisation Alerte, sélectionnez l'autorisation suivante :
Alert.Read.All
Cliquez sur Ajouter des autorisations.
Sur la page API Permissions (Autorisations des API), cliquez sur Add a permission (Ajouter une autorisation).
Sélectionnez Microsoft Graph> Autorisations déléguées.
Dans la section Sélectionner des autorisations, sélectionnez l'autorisation requise suivante :
User.Read
Cliquez sur Ajouter des autorisations.
Sur la page API Permissions (Autorisations des API), cliquez sur Add a permission (Ajouter une autorisation).
Sélectionnez WindowsDefenderATP > Autorisations de l'application.
Dans la section Sélectionner des autorisations, sélectionnez les autorisations requises suivantes :
AdvancedQuery.Read.AllAlert.Read.AllAlert.ReadWrite.AllEvent.WriteFile.Read.AllIp.Read.AllMachine.IsolateMachine.Read.AllMachine.ReadWrite.AllMachine.ScanMachine.StopAndQuarantineTi.ReadWriteUrl.Read.AllUser.Read.All
Cliquez sur Accorder le consentement administrateur pour
ORGANIZATION_NAME.Lorsque la boîte de dialogue Grant admin consent confirmation (Confirmation de l'octroi du consentement administrateur) s'affiche, cliquez sur Yes (Oui).
Voici un exemple de requête API permettant d'obtenir les alertes Defender ATP (notez le paramètre $expand utilisé pour récupérer des données sur les adresses IP, les domaines et les fichiers) :
GET /api/alerts?$expand=files,ips,domains HTTP/1.1
Host: api.securitycenter.windows.com
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJ...
User-Agent: PostmanRuntime/7.19.0
Accept: */ *
Cache-Control: no-cache
Postman-Token: 2dc0f885-068a-45d4-81a6-2da0d23a58ad,d3dd0e6e-83ab-4d27-94d2-0f3889dff324
Host: api.securitycenter.windows.com
Accept-Encoding: gzip, deflate
Connection: keep-alive
cache-control: no-cache
Pour en savoir plus sur les paramètres et les options de requête, comme le filtrage ou le développement, consultez API Microsoft Defender pour point de terminaison compatibles dans la documentation Microsoft.
Créer un code secret du client
Accédez à Certificates and secrets>New client secret (Certificats et codes secrets > Nouveau code secret du client).
Fournissez une description pour un code secret du client et définissez sa date d'expiration.
Cliquez sur Ajouter.
Enregistrez la valeur du code secret du client (et non l'ID du secret) pour l'utiliser comme valeur de paramètre
Client Secretlors de la configuration de l'intégration. La valeur du code secret du client ne s'affiche qu'une seule fois.
Activer l'intégration SIEM (obsolète)
Dans le volet de navigation, sélectionnez Paramètres > SIEM.
Sélectionnez Activer l'intégration SIEM.
La section des détails d'accès au connecteur SIEM est alors activée avec des valeurs préremplies, et une application est créée sous votre locataire Azure AD.
- Sélectionnez le type de SIEM "API générique".
- Copiez les valeurs individuelles ou sélectionnez "Enregistrer les détails dans un fichier" pour télécharger un fichier contenant toutes les valeurs.
- Vous aurez besoin des valeurs présentées sur cette page pour générer un jeton permettant d'accéder aux données de détection : ID client, code secret du client, ressource.
Intégrer Microsoft Defender for Endpoint à Google SecOps
Pour obtenir des instructions détaillées sur la configuration d'une intégration dans Google SecOps, consultez Configurer des intégrations.
Paramètres d'intégration
Pour configurer l'intégration, utilisez les paramètres suivants :
| Paramètres | |
|---|---|
Client ID |
Obligatoire ID client (application) de l'application Microsoft Entra à utiliser pour l'intégration. |
Client Secret |
Obligatoire Valeur du code secret du client de l'application Microsoft Entra à utiliser pour l'intégration. |
Azure Active Directory ID |
Obligatoire Valeur Microsoft Entra ID (ID de locataire). |
Verify SSL |
Optional Si cette option est sélectionnée, elle vérifie que le certificat SSL de la connexion au serveur Microsoft 365 Defender est valide. Cette option est sélectionnée par défaut. |
API Root |
Obligatoire URL racine de l'API à utiliser avec l'intégration. Pour de meilleures performances, vous pouvez utiliser un serveur plus proche de votre emplacement :
La valeur par défaut est |
Actions
Supprimer les indicateurs d'entité
Supprimez les indicateurs d'entité dans Microsoft Defender for Endpoint.
Paramètres
N/A
Exécution
Cette action s'exécute sur les entités suivantes :
- Adresse IP
- URL
- Filehash
Résultats de l'action
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Mur des cas
| Type de résultat | Valeur / Description | Type |
|---|---|---|
| Message de sortie* | L'action ne doit pas échouer ni arrêter l'exécution d'un playbook : Si le code d'état 204 est renvoyé (is_success=true) : "Les entités suivantes ont bien été supprimées en tant qu'indicateurs dans Microsoft Defender pour point de terminaison : {entity.identifier}. Si l'incident n'est pas trouvé (is_success=true) : "Les entités suivantes n'existent pas en tant qu'indicateurs dans Microsoft Defender pour point de terminaison : {entity.identifier}. L'action doit échouer et arrêter l'exécution d'un playbook : Si une erreur fatale est signalée (par exemple, des identifiants incorrects, l'absence de connexion au serveur, etc.) : "Error executing action "Delete Entity Indicators". Reason: {0}''.format(error.Stacktrace) |
Général |
Enrichir les entités
Enrichissez les entités d'hôte, d'adresse IP ou de hachage de fichier Google SecOps en fonction des informations de Microsoft Defender pour point de terminaison.
Paramètres
N/A
Cas d'utilisation
L'action peut être utilisée dans les playbooks qui examinent l'activité sur les appareils. Si l'agent Microsoft Defender pour point de terminaison est installé sur l'appareil, l'action extrait les informations de Defender ATP sur un appareil pour enrichir les entités Google SecOps. L'action peut également être utilisée pour enrichir les hachages de fichiers d'alerte avec les informations de Defender ATP.
Exécution
Cette action s'exécute sur les entités suivantes :
- Hôte
- Adresse IP
- Filehash
Résultats de l'action
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Résultat JSON
Si l'enrichissement fonctionne sur l'adresse IP ou l'hôte :
[
{
"EntityResult": {
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Machines/$entity",
"id": "example_id",
"computerDnsName": "example-name",
"firstSeen": "2019-11-18T11:13:04.0588699Z",
"lastSeen": "2019-11-24T18:31:50.581058Z",
"osPlatform": "Windows10",
"osVersion": null,
"osProcessor": "x64",
"version": "1803",
"lastIpAddress": "192.0.2.138",
"lastExternalIpAddress": "203.0.113.28",
"agentVersion": "10.4860.17134.982",
"osBuild": 17134,
"healthStatus": "Active",
"rbacGroupId": 0,
"rbacGroupName": null,
"riskScore": "High",
"exposureLevel": "Medium",
"aadDeviceId": null,
"machineTags": []
}
}
]
Si l'enrichissement fonctionne sur Filehash :
[
{
"EntityResult": {
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Files/$entity",
"sha1": "bdd0d38e113a0c7dd6213cf2e89e6cc6d66b5cdb",
"sha256": "328954033456d5c13e58fb5bcc6c0232f9f62cb6d9185afa51c7913338992491",
"md5": "9512e1cc66a1d36feb0a290cab09087b",
"globalPrevalence": 5205000,
"globalFirstObserved": "2018-06-22T12:59:21.6460311Z",
"globalLastObserved": "2019-11-21T00:24:01.921338Z",
"size": 245760,
"fileType": "APP",
"isPeFile": true,
"filePublisher": "Microsoft Corporation",
"fileProductName": "Microsoft Windows Operating System",
"signer": "Microsoft Windows",
"issuer": "Microsoft Windows Production PCA 2011",
"signerHash": "419e77aed546a1a6cf4dc23c1f977542fe289cf7",
"isValidCertificate": true
},
"EntityResult": {
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#microsoft.windowsDefenderATP.api.InOrgFileStats",
"sha1": "bdd0d38e113a0c7dd6213cf2e89e6cc6d66b5cdb",
"orgPrevalence": "1",
"orgFirstSeen": "2019-11-19T03:54:15Z",
"orgLastSeen": "2019-11-19T04:21:18Z",
"globalPrevalence": "5205000",
"globalFirstObserved": "2018-06-22T12:59:21.6460311Z",
"globalLastObserved": "2019-11-21T00:24:01.921338Z",
"topFileNames": ["notepad.exe"]
}
}
]
Enrichissement d'entités
Adresse IP et hôte
| Nom du champ d'enrichissement | Logique : quand les utiliser ? |
|---|---|
| Defender_ATP.sha1 | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.sha256 | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.md5 | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.globalPrevalence | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.globalFirstObserved | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.globalLastObserved | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.size | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.fileType | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.isPeFile | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.filePublisher | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.fileProductName | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.signer | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.issuer | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.signerHash | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.isValidCertificate | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.orgPrevalence | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.orgFirstSeen | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.orgLastSeen | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.topFileNames | Renvoie si elle existe dans le résultat JSON |
Hachage de fichier
| Nom du champ d'enrichissement | Logique : quand les utiliser ? |
|---|---|
| Defender_ATP.sha1 | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.sha256 | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.md5 | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.globalPrevalence | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.globalFirstObserved | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.globalLastObserved | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.size | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.fileType | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.isPeFile | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.filePublisher | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.fileProductName | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.signer | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.issuer | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.signerHash | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.isValidCertificate | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.orgPrevalence | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.orgFirstSeen | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.orgLastSeen | Renvoie si elle existe dans le résultat JSON |
| Defender_ATP.topFileNames | Renvoie si elle existe dans le résultat JSON |
Exécuter une commande de réponse en direct
Utilisez l'action Exécuter la commande de réponse en direct pour exécuter une commande de réponse en direct dans Microsoft Defender pour point de terminaison.
Entrées de l'action
L'action Exécuter la commande de réponse en direct nécessite les paramètres suivants :
| Paramètre | Description |
|---|---|
Command |
Obligatoire. Objet JSON représentant la commande à exécuter, y compris son type et ses paramètres. Pour en savoir plus sur les structures de commande compatibles, consultez la documentation de l'API Microsoft Defender pour Endpoint. Exemple de format : |
Comment |
Facultatif. Commentaire ou description de la commande exécutée. |
Sorties de l'action
L'action Exécuter la commande de réponse en direct fournit les résultats suivants :
| Type de sortie de l'action | Disponibilité |
|---|---|
| Pièce jointe au mur des cas | Non disponible |
| Lien vers le mur des cas | Non disponible |
| Tableau du mur des cas | Non disponible |
| Table d'enrichissement | Non disponible |
| Résultat JSON | Disponible |
| Messages de sortie | Disponible |
| Résultat du script | Disponible |
Résultat JSON
L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Exécuter une commande de réponse en direct :
{
"Entity": "",
"EntityResult": {
"@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#MachineActions/$entity",
"id": "00000000-0000-0000-0000-000000000000",
"type": "LiveResponse",
"title": null,
"requestor": "SEC_OPS_USER",
"requestorComment": "Execution of live response command",
"status": "Pending",
"machineId": "MACHINE_ID_HASH",
"computerDnsName": "hostname.domain.local",
"creationDateTimeUtc": "2026-01-04T10:57:33.032Z",
"lastUpdateDateTimeUtc": "2026-01-04T10:57:33.032Z",
"cancellationRequestor": null,
"cancellationComment": null,
"cancellationDateTimeUtc": null,
"errorHResult": 0,
"scope": null,
"externalId": null,
"requestSource": "PublicApi",
"relatedFileInfo": null,
"commands": [],
"troubleshootInfo": null,
"results": {
"filepath": "",
"script_name": "remediation_script.ps1",
"exit_code": 0,
"script_output": "Script completed successfully",
"script_errors": ""
}
}
}
Messages de sortie
L'action Exécuter la commande de réponse en direct peut renvoyer les messages de sortie suivants :
| Message de sortie | Description du message |
|---|---|
|
L'action a réussi. |
|
Échec de l'action. Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants. |
Résultat du script
Le tableau suivant liste la valeur de la sortie du résultat du script lorsque vous utilisez l'action Exécuter la commande de réponse en direct :
| Nom du résultat du script | Valeur |
|---|---|
is_success |
true ou false |
Obtenir l'état de la tâche actuelle
Obtenez l'état actuel d'une tâche.
Paramètres
| Nom à afficher du paramètre | Type | Valeur par défaut | Is Mandatory | Description |
|---|---|---|---|---|
| ID de tâche | Chaîne | N/A | Oui | Liste des ID de tâche sous forme de chaîne séparée par une virgule. |
Exécution
Cette action s'exécute sur toutes les entités.
Résultats de l'action
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Résultat JSON
[
{
"status": "Succeeded",
"creation_date_time_utc": "2020-02-08T03:24:52.8526634Z",
"cancellation_requestor": null,
"cancellation_date_time_utc": null,
"id": "2e39d22e-60a7-4267-899c-a1471e800000",
"last_update_date_time_utc": "2020-02-08T03:25:35.8345081Z",
"related_file_info": null,
"cancellation_comment": null,
"requestor": "e4fc6454-754d-47f7-bbdb-045fad600000",
"error_h_result": 0,
"scope": "Selective",
"machine_id": "fbc85cf3fbcc8bb14d1a84fcf7bbae4531f00000",
"type": "Isolate",
"requestor_comment": "test"
}
]
Recevoir des alertes liées aux fichiers
Recevez des alertes liées à un fichier de Microsoft Defender for Endpoint en fonction du hachage du fichier.
Paramètres
| Valeur d'affichage du paramètre | Type | Valeur par défaut | Is Mandatory | Description |
|---|---|---|---|---|
| État | Chaîne | Unknown, New, InProgress, Resolved | Non | Spécifiez les états des alertes à rechercher. Le paramètre accepte plusieurs valeurs sous la forme d'une chaîne séparée par une virgule. |
| Gravité | Chaîne | Non spécifié, Informatif, Faible, Moyen, Élevé | NON | Spécifiez les niveaux de gravité des incidents à rechercher. Le paramètre accepte plusieurs valeurs sous la forme d'une chaîne séparée par une virgule. |
| Catégorie | Chaîne | N/A | Non | Spécifiez la catégorie d'alerte à rechercher. Si ce paramètre n'est pas fourni, l'action recherche toutes les catégories. Le paramètre accepte plusieurs valeurs sous la forme d'une chaîne d'éléments séparés par une virgule. Valeurs possibles : "Collection", "CommandAndControl", "CredentialAccess", "DefenseEvasion", "Discovery", "Execution", "Exfiltration", "Exploit", "InitialAccess", "LateralMovement", "Malware", "Persistence", "PrivilegeEscalation", "Ransomware", "SuspiciousActivity", "UnwantedSoftware". |
| ID de l'incident | Integer | N/A | Non | Spécifiez l'ID d'incident Microsoft Defender pour lequel vous souhaitez rechercher les alertes associées. |
Cas d'utilisation
Lors de l'examen d'une alerte provenant du connecteur Defender ATP, cette action peut être utilisée pour collecter des informations si ce fichier est associé à des alertes afin de déterminer s'il est malveillant ou non.
Exécuter sur
Cette action s'exécute sur l'entité Filehash.
Résultats de l'action
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Résultat JSON
{
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Alerts",
"value": [
{
"id": "example_id",
"incidentId": 2,
"investigationId": 1,
"assignedTo": null,
"severity": "Medium",
"status": "New",
"classification": null,
"determination": null,
"investigationState": "TerminatedBySystem",
"detectionSource": "WindowsDefenderAtp",
"category": "DefenseEvasion",
"threatFamilyName": null,
"title": "Suspicious process injection observed",
"description": "A process abnormally injected code into another process, As a result, unexpected code may be running in the target process memory. Injection is often used to hide malicious code execution within a trusted process. \nAs a result, the target process may exhibit abnormal behaviors such as opening a listening port or connecting to a command and control server.",
"alertCreationTime": "2019-11-19T03:56:37.7335862Z",
"firstEventTime": "2019-11-19T03:54:15.7698362Z",
"lastEventTime": "2019-11-19T03:54:15.7698362Z",
"lastUpdateTime": "2019-11-20T10:13:31.7266667Z",
"resolvedTime": null,
"machineId": "machine-id",
"alertUser": {
"accountName": "example.user",
"domainName": "EXAMPLELAB"
},
"comments": [],
"alertFiles": [
{
"sha1": "1b3b40fbc889fd4c645cc12c85d0805ac36ba254",
"sha256": "d3f8fade829d2b7bd596c4504a6dae5c034e789b6a3defbe013bda7d14466677",
"filePath": "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
"fileName": "powershell.exe"
},{
"sha1": "bdd0d38e113a0c7dd6213cf2e89e6cc6d66b5cdb",
"sha256": "328954033456d5c13e58fb5bcc6c0232f9f62cb6d9185afa51c7913338992491",
"filePath": "C:\\Windows\\System32\\notepad.exe",
"fileName": "notepad.exe"
}
],
"alertDomains": [],
"alertIps": [],
"alertProcesses": []
}
]
}
Obtenir les machines associées au fichier
Récupère les machines associées à un fichier à partir de Microsoft Defender for Endpoint en fonction du hachage du fichier.
Paramètres
| Nom à afficher du paramètre | Type | Valeur par défaut | Is Mandatory | Description |
|---|---|---|---|---|
| Nom de la machine | Chaîne | N/A | Non | Spécifiez le nom complet de la machine à rechercher. |
| Adresse IP de la machine | Chaîne | N/A | Non | Spécifiez l'adresse IP de la machine à rechercher. |
| Score de risque de la machine | Chaîne | N/A | Non | Spécifiez le score de risque de la machine à rechercher. Le paramètre accepte plusieurs valeurs sous la forme d'une chaîne séparée par une virgule. |
| État de fonctionnement de la machine | Chaîne | Active, Inactive, ImpairedCommunication, NoSensorData, NoSensorDataImpairedCommunication | Non | Spécifiez l'état de fonctionnement de la machine à rechercher. Le paramètre accepte plusieurs valeurs sous la forme d'une chaîne séparée par une virgule. |
| Plate-forme de l'OS de la machine | Chaîne | N/A | Non | Spécifiez la plate-forme d'OS de la machine à rechercher. |
| ID du groupe RBAC | Chaîne | N/A | Non | Spécifiez l'ID du groupe RBAC à rechercher. |
Cas d'utilisation
Lors de l'examen d'une alerte provenant du connecteur Defender ATP, cette action peut être utilisée pour collecter des informations sur les machines sur lesquelles ce fichier a été enregistré dans Defender ATP.
Exécution
Cette action s'exécute sur l'entité Filehash.
Résultats de l'action
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Résultat JSON
{
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Machines",
"value": [
{
"id": "example_id",
"computerDnsName": "example-name",
"firstSeen": "2019-11-18T11:13:04.0588699Z",
"lastSeen": "2019-11-20T19:35:36.4619266Z",
"osPlatform": "Windows10",
"osVersion": null,
"osProcessor": "x64",
"version": "1803",
"lastIpAddress": "192.0.2.1",
"lastExternalIpAddress": "203.0.113.121",
"agentVersion": "10.4860.17134.982",
"osBuild": 17134,
"healthStatus": "Active",
"rbacGroupId": 0,
"rbacGroupName": null,
"riskScore": "High",
"exposureLevel": "Medium",
"aadDeviceId": null,
"machineTags": []
}
]
}
Obtenir les utilisateurs connectés à la machine
Obtenez des informations sur la connexion d'un utilisateur sur une machine spécifique.
Paramètres
N/A
Cas d'utilisation
L'action peut être utilisée à des fins d'investigation pour obtenir des détails spécifiques sur les utilisateurs qui se connectent à une machine en question à partir du serveur Defender ATP.
Exécution
Cette action s'exécute sur les entités suivantes :
- Hôte
- Adresse IP
Résultats de l'action
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Résultat JSON
{
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Users",
"value": [
{
"id": "example\\example.user",
"accountName": "example.user",
"accountDomain": "example",
"accountSid": null,
"firstSeen": "2019-11-19T03:50:36Z",
"lastSeen": "2019-11-19T03:50:36Z",
"mostPrevalentMachineId": null,
"leastPrevalentMachineId": null,
"logonTypes": "Interactive",
"logOnMachinesCount": 1,
"isDomainAdmin": false,
"isOnlyNetworkUser": null
}
]
}
Obtenir des recommandations de machines
Utilisez l'action Obtenir des recommandations sur les machines pour récupérer une liste de recommandations de sécurité pour des machines spécifiques dans Microsoft Defender pour point de terminaison.
Cette action s'exécute sur les entités Google SecOps suivantes :
HostnameIP Address
Entrées de l'action
L'action Obtenir des recommandations de machines nécessite les paramètres suivants :
| Paramètre | Description |
|---|---|
Max Recommendations To Return |
Obligatoire. Nombre maximal de recommandations à récupérer pour chaque entité. La valeur maximale est La valeur par défaut est |
Sorties de l'action
L'action Obtenir des recommandations de machines fournit les résultats suivants :
| Type de sortie de l'action | Disponibilité |
|---|---|
| Pièce jointe au mur des cas | Non disponible |
| Lien vers le mur des cas | Non disponible |
| Tableau du mur des cas | Non disponible |
| Table d'enrichissement | Non disponible |
| Résultat JSON | Disponible |
| Messages de sortie | Disponible |
| Résultat du script | Disponible |
Résultat JSON
L'exemple suivant montre le résultat JSON obtenu lors de l'utilisation de l'action Obtenir des recommandations de machines :
{
"Entity": "",
"EntityResult": [
{
"id": "va-_-7-zip-_-7-zip",
"productName": "7-zip",
"recommendationName": "Update 7-zip to version 25.01.0.0",
"weaknesses": 12,
"vendor": "7-zip",
"recommendedVersion": "25.01.0.0",
"recommendedVendor": "",
"recommendedProgram": "",
"recommendationCategory": "Application",
"subCategory": "",
"severityScore": 0.0,
"publicExploit": true,
"activeAlert": false,
"associatedThreats": [],
"remediationType": "Update",
"status": "Active",
"configScoreImpact": 0.0,
"exposureImpact": 0.0,
"totalMachineCount": 0,
"exposedMachinesCount": 1,
"nonProductivityImpactedAssets": 0,
"relatedComponent": "7-zip",
"hasUnpatchableCve": false,
"tags": [],
"exposedCriticalDevices": 0
}
]
}
Messages de sortie
L'action Obtenir des recommandations de machines peut renvoyer les messages de sortie suivants :
| Message de sortie | Description du message |
|---|---|
|
L'action a réussi. |
Error executing action "Get Machine Recommendations". Reason:
ERROR_REASON |
Échec de l'action. Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants. |
Résultat du script
Le tableau suivant liste la valeur de la sortie du résultat du script lorsque vous utilisez l'action Obtenir des recommandations de machines :
| Nom du résultat du script | Valeur |
|---|---|
is_success |
true ou false |
Recevoir des alertes liées à la machine
Recevez des alertes concernant une machine spécifique enregistrée dans Defender ATP.
Paramètres
| Paramètre | Type | Valeur par défaut | Is Mandatory | Description |
|---|---|---|---|---|
| État | Chaîne | Unknown, New, InProgress, Resolved | Non | Spécifiez les états des alertes à rechercher. Le paramètre accepte plusieurs valeurs sous la forme d'une chaîne séparée par une virgule. |
| Gravité | Chaîne | Non spécifié, Informatif, Faible, Moyen, Élevé | Non | Spécifiez les niveaux de gravité des incidents à rechercher. Le paramètre accepte plusieurs valeurs sous la forme d'une chaîne séparée par une virgule. |
| Catégorie | Chaîne | N/A | Non | Spécifiez la catégorie d'alerte à rechercher. Si ce paramètre n'est pas fourni, l'action recherche toutes les catégories. Le paramètre accepte plusieurs valeurs sous la forme d'une chaîne d'éléments séparés par une virgule. Valeurs possibles : "Collection", "CommandAndControl", "CredentialAccess", "DefenseEvasion", "Discovery", "Execution", "Exfiltration", "Exploit", "InitialAccess", "LateralMovement", "Malware", "Persistence", "PrivilegeEscalation", "Ransomware", "SuspiciousActivity", "UnwantedSoftware". |
| ID de l'incident | Integer | N/A | Non | Spécifiez l'ID d'incident Microsoft Defender pour lequel vous souhaitez rechercher les alertes associées. |
Cas d'utilisation
L'action peut être utilisée à des fins d'investigation pour obtenir des alertes liées à une machine spécifique en question à partir du serveur Defender ATP.
Exécution
Cette action s'exécute sur les entités suivantes :
- Hôte
- Adresse IP
Résultats de l'action
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Résultat JSON
{
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Alerts",
"value": [
{
"id": "example-id",
"incidentId": 1,
"investigationId": null,
"assignedTo": "testuser@example.com",
"severity": "Informational",
"status": "Resolved",
"classification": "FalsePositive",
"determination": "SecurityTesting",
"investigationState": "UnsupportedAlertType",
"detectionSource": "WindowsDefenderAtp",
"category": "Execution",
"threatFamilyName": null,
"title": "[Test Alert] Suspicious Powershell commandline",
"description": "*** This is a test alert ***\nA suspicious Powershell commandline was found on the machine. This commandline might be used during installation, exploration, or in some cases with lateral movement activities which are used by attackers to invoke modules, download external payloads, and get more information about the system. Attackers usually use Powershell to bypass security protection mechanisms by executing their payload in memory without touching the disk and leaving any trace.",
"alertCreationTime": "2019-11-18T11:17:48.287421Z",
"firstEventTime": "2019-11-18T11:15:06.5226815Z",
"lastEventTime": "2019-11-18T11:15:06.5226815Z",
"lastUpdateTime": "2019-11-20T04:12:03.91Z",
"resolvedTime": "2019-11-20T04:12:03.4976288Z",
"machineId": "machine-id",
"alertUser": {
"accountName": "Administrator",
"domainName": "US-LT-V13007"
},
"comments": [],
"alertFiles": [
{
"sha1": "3ce71813199abae99348f61f0caa34e2574f831c",
"sha256": "9a7c58bd98d70631aa1473f7b57b426db367d72429a5455b433a05ee251f3236",
"filePath": "C:\\Windows\\System32\\cmd.exe",
"fileName": "cmd.exe"
},
{
"sha1": "1b3b40fbc889fd4c645cc12c85d0805ac36ba254",
"sha256": "d3f8fade829d2b7bd596c4504a6dae5c034e789b6a3defbe013bda7d14466677",
"filePath": "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
"fileName": "powershell.exe"
}
],
"alertDomains": [],
"alertIps": [],
"alertProcesses": []
}
]
}
Obtenir les failles de la machine
Utilisez l'action Obtenir les failles de la machine pour lister les failles associées à des machines spécifiques dans Microsoft Defender for Endpoint.
Cette action s'exécute sur les entités Google SecOps suivantes :
HostnameIP Address
Entrées de l'action
L'action Obtenir les failles de la machine nécessite les paramètres suivants :
| Paramètre | Description |
|---|---|
Severity Filter |
Facultatif. Niveaux de gravité utilisés pour filtrer les failles renvoyées. Les valeurs possibles sont les suivantes :
La valeur par défaut est |
Threat Filter |
Facultatif. Critères de renseignement sur les menaces utilisés pour filtrer les failles renvoyées. Les valeurs possibles sont les suivantes :
|
Sort By |
Facultatif. Champ utilisé pour trier les failles renvoyées. Les valeurs possibles sont les suivantes :
La valeur par défaut est |
Sort Order |
Facultatif. Ordre dans lequel les résultats triés sont affichés. Les valeurs possibles sont les suivantes :
La valeur par défaut est |
Max Vulnerabilities To Return |
Obligatoire. Nombre maximal de failles à renvoyer pour chaque entité. La valeur maximale est La valeur par défaut est |
Sorties de l'action
L'action Obtenir les failles de la machine fournit les résultats suivants :
| Type de sortie de l'action | Disponibilité |
|---|---|
| Pièce jointe au mur des cas | Non disponible |
| Lien vers le mur des cas | Non disponible |
| Tableau du mur des cas | Non disponible |
| Table d'enrichissement | Non disponible |
| Résultat JSON | Disponible |
| Messages de sortie | Disponible |
| Résultat du script | Disponible |
Résultat JSON
L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Get Machine Vulnerabilities (Obtenir les failles de la machine) :
{
"Entity": "",
"EntityResult": [
{
"@odata.type": "#microsoft.windowsDefenderATP.api.PublicVulnerabilityDto",
"id": "CVE-2025-21266",
"name": "CVE-2025-21266",
"description": "Summary: The Windows Telephony Service in Microsoft Windows is vulnerable to remote code execution. An attacker can exploit this vulnerability by tricking a user into visiting a malicious website, which would allow them to execute arbitrary code on the system. Impact: If successfully exploited, this vulnerability could allow an attacker to execute arbitrary code on the affected system. This could lead to a complete compromise of the system, enabling the attacker to gain unauthorized access, steal sensitive information, or perform other malicious activities. Remediation: Apply the latest patches and updates provided by the respective vendors. Generated by AI",
"severity": "High",
"cvssV3": 8.8,
"cvssVector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:R/S:U/C:H/I:H/A:H/E:U/RL:O/RC:C",
"exposedMachines": 1,
"publishedOn": "2025-01-14T08:00:00Z",
"updatedOn": "2025-09-09T23:45:43.5Z",
"firstDetected": "2025-01-14T18:31:29Z",
"patchFirstAvailable": null,
"publicExploit": false,
"exploitVerified": false,
"exploitInKit": false,
"exploitTypes": [],
"exploitUris": [],
"cveSupportability": "Supported",
"tags": [],
"epss": 0.01391,
"status": "RemediationRequired"
}
]
}
Messages de sortie
L'action Obtenir les failles de la machine peut renvoyer les messages de sortie suivants :
| Message de sortie | Description du message |
|---|---|
|
L'action a réussi. |
Error executing action "Get Machine Vulnerabilities". Reason:
ERROR_REASON |
Échec de l'action. Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants. |
Résultat du script
Le tableau suivant liste la valeur de la sortie du résultat du script lorsque vous utilisez l'action Obtenir les failles de la machine :
| Nom du résultat du script | Valeur |
|---|---|
is_success |
true ou false |
Obtenir les alertes liées à l'utilisateur
Utilisez l'action Obtenir les alertes liées à l'utilisateur pour lister les alertes associées à des utilisateurs spécifiques dans Microsoft Defender pour point de terminaison.
Cette action s'exécute sur l'entité Google SecOps User.
Entrées de l'action
L'action Obtenir les alertes liées à l'utilisateur nécessite les paramètres suivants :
| Paramètre | Description |
|---|---|
Max Alerts To Return |
Obligatoire. Nombre maximal d'alertes à récupérer pour chaque utilisateur. La valeur maximale est La valeur par défaut est |
Sorties de l'action
L'action Obtenir les alertes liées à l'utilisateur fournit les résultats suivants :
| Type de sortie de l'action | Disponibilité |
|---|---|
| Pièce jointe au mur des cas | Non disponible |
| Lien vers le mur des cas | Non disponible |
| Tableau du mur des cas | Non disponible |
| Table d'enrichissement | Non disponible |
| Résultat JSON | Disponible |
| Messages de sortie | Disponible |
| Résultat du script | Disponible |
Résultat JSON
L'exemple suivant montre le résultat JSON obtenu lors de l'utilisation de l'action Get User Related Alerts (Obtenir les alertes liées à l'utilisateur) :
[
{
"Entity": "User@domain.local",
"EntityResult": [
{
"id": "da06788650-4d45-4dcf-ae23-d1071ad426ec_1",
"incident_id": 864492,
"investigation_id": 1778,
"assigned_to": "API-Automated Investigation and Response",
"severity": "Low",
"status": "Resolved",
"classification": null,
"determination": null,
"investigation_state": "Benign",
"detection_source": "WindowsDefenderAv",
"category": "Malware",
"threat_family_name": "Ceprolad",
"title": "An active '' malware ",
"description": "Malware and unwanted software are undesirable applications that perform annoying, disruptive, or harmful actions on affected machines. Some of these undesirable applications can replicate and spread from one machine to another. Others are able to receive commands from remote attackers and perform activities associated with cyber attacks.\n\nA malware is considered active if it is found running on the machine or it already has persistence mechanisms in place. Active malware detections are assigned higher severity ratings.\n\nBecause this malware was active, take precautionary measures and check for residual signs of infection.",
"alert_creation_time": "2026-02-27T06:58:08.1366667Z",
"first_event_time": "2026-02-27T06:55:51.021546Z",
"last_event_time": "2026-02-27T06:55:51.021546Z",
"last_update_time": "2026-02-27T07:13:46.2333333Z",
"resolved_time": "2026-02-27T07:13:44.3513463Z",
"machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
"alert_user": null,
"alert_files": [],
"comments": [],
"alert_domains": null,
"alert_ips": null,
"alert_processes": null
},
{
"id": "da0b1f334d-b5e5-4618-8a2a-d3675e62a93b_1",
"incident_id": 864492,
"investigation_id": null,
"assigned_to": null,
"severity": "Low",
"status": "New",
"classification": null,
"determination": null,
"investigation_state": "UnsupportedAlertType",
"detection_source": "WindowsDefenderAtp",
"category": "Execution",
"threat_family_name": null,
"title": "Suspicious JavaScript process",
"description": "A suspicious JavaScript process was observed on this device. Attackers typically use JavaScript to download secondary payloads, run additional commands, and perform other malicious activities on the target device.",
"alert_creation_time": "2026-02-27T06:58:38.5533333Z",
"first_event_time": "2026-02-27T06:55:32.6699867Z",
"last_event_time": "2026-03-05T07:24:52.7415066Z",
"last_update_time": "2026-03-05T07:28:04.67Z",
"resolved_time": null,
"machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
"alert_user": null,
"alert_files": [],
"comments": [],
"alert_domains": null,
"alert_ips": null,
"alert_processes": null
},
{
"id": "da0cfbb355-b5a5-43a5-adb6-d0879d0b0917_1",
"incident_id": 690846,
"investigation_id": null,
"assigned_to": "analyst@company.onmicrosoft.com",
"severity": "Medium",
"status": "InProgress",
"classification": null,
"determination": null,
"investigation_state": "UnsupportedAlertType",
"detection_source": "WindowsDefenderAtp",
"category": "Execution",
"threat_family_name": null,
"title": "Suspicious behavior by cmd.exe was observed",
"description": "A suspicious behavior by cmd.exe was observed. This behavior may indicate malware installation or other malicious activities on the machine.",
"alert_creation_time": "2025-10-13T10:26:21.3333333Z",
"first_event_time": "2025-10-13T10:23:58.1472359Z",
"last_event_time": "2025-10-13T10:25:22.714708Z",
"last_update_time": "2026-02-13T08:14:22.61Z",
"resolved_time": null,
"machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
"alert_user": null,
"alert_files": [],
"comments": [
{
"comment": "\ud83d\udfe6 Intezer Automated Triage\n===================================\n\u26a0\ufe0f Suspicious - Not Mitigated - Follow Up Required\n===================================\n\n- Title: Suspicious behavior by cmd.exe was observed\n- Source: Microsoft Defender for Endpoint\n- Creation time: 13 Oct 25 | 10:26 UTC\n- External severity: Medium\n- Hosts: \n * workstation-01 (Windows10)\n- Description: A suspicious behavior by cmd.exe was observed. This behavior may indicate malware installation or other malicious activities on the machine.\n- TTPs:\n * Command and Control: Application Layer Protocol [T1071]\n * Defense Evasion: MMC [T1218.014]\n * Execution: Windows Command Shell [T1059.003]\n- Recommended actions: Ensure Device is Patched, Run Intezer Endpoint Scan (https://docs.intezer.com/docs/live-endpoint-analysis), Validate Activity with User\n- Malicious files: APTSimulator_scheduler.bat\n\nView alert: \ud83d\udc49 https://analyze.intezer.com/alerts/da0cfbb355-b5a5-43a5-adb6-d0879d0b0917_1?environment=mde",
"createdBy": "API Action",
"createdTime": "2025-10-13T10:40:32.4733451Z"
}
],
"alert_domains": null,
"alert_ips": null,
"alert_processes": null
},
{
"id": "da0e3de096-1789-43ff-bb2e-6cc22e5037ad_1",
"incident_id": 864492,
"investigation_id": null,
"assigned_to": null,
"severity": "Low",
"status": "New",
"classification": null,
"determination": null,
"investigation_state": "UnsupportedAlertType",
"detection_source": "WindowsDefenderAtp",
"category": "DefenseEvasion",
"threat_family_name": null,
"title": "Suspicious registry modification",
"description": "A suspicious process modified the registry on this device. Registry entries can be added, modified, or removed to change various settings of the system or behavior of a program. Attackers leverage this technique to gain persistence, escalate privileges, launch malicious codes, or to tamper with security products.",
"alert_creation_time": "2026-02-27T06:58:38.7266667Z",
"first_event_time": "2026-02-27T06:56:11.3416006Z",
"last_event_time": "2026-03-05T07:25:30.6007486Z",
"last_update_time": "2026-03-05T07:28:07.39Z",
"resolved_time": null,
"machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
"alert_user": null,
"alert_files": [],
"comments": [],
"alert_domains": null,
"alert_ips": null,
"alert_processes": null
},
{
"id": "da13c4af0a-bd35-4cb2-a556-fa972f3b80da_1",
"incident_id": 864492,
"investigation_id": 1779,
"assigned_to": "API-Automated Investigation and Response",
"severity": "Low",
"status": "Resolved",
"classification": null,
"determination": null,
"investigation_state": "Benign",
"detection_source": "WindowsDefenderAv",
"category": "Malware",
"threat_family_name": "Ceprolad",
"title": "An active '' malware ",
"description": "Malware and unwanted software are undesirable applications that perform annoying, disruptive, or harmful actions on affected machines. Some of these undesirable applications can replicate and spread from one machine to another. Others are able to receive commands from remote attackers and perform activities associated with cyber attacks.\n\nA malware is considered active if it is found running on the machine or it already has persistence mechanisms in place. Active malware detections are assigned higher severity ratings.\n\nBecause this malware was active, take precautionary measures and check for residual signs of infection.",
"alert_creation_time": "2026-03-02T07:26:21.22Z",
"first_event_time": "2026-03-02T07:25:05.4166175Z",
"last_event_time": "2026-03-02T07:25:05.4166175Z",
"last_update_time": "2026-03-02T07:37:19.2666667Z",
"resolved_time": "2026-03-02T07:37:19.1231428Z",
"machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
"alert_user": null,
"alert_files": [],
"comments": [],
"alert_domains": null,
"alert_ips": null,
"alert_processes": null
},
{
"id": "da2052972f-7cc3-42c8-8abf-8ac490d63c35_1",
"incident_id": 690846,
"investigation_id": null,
"assigned_to": "analyst@company.onmicrosoft.com",
"severity": "Medium",
"status": "InProgress",
"classification": null,
"determination": null,
"investigation_state": "UnsupportedAlertType",
"detection_source": "WindowsDefenderAtp",
"category": "Execution",
"threat_family_name": null,
"title": "Suspicious behavior by cmd.exe was observed",
"description": "A suspicious behavior by cmd.exe was observed. This behavior may indicate malware installation or other malicious activities on the machine.",
"alert_creation_time": "2025-10-07T10:25:41.1666667Z",
"first_event_time": "2025-10-07T10:23:44.5677721Z",
"last_event_time": "2025-10-07T10:25:10.6581007Z",
"last_update_time": "2026-02-13T08:14:22.61Z",
"resolved_time": null,
"machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
"alert_user": null,
"alert_files": [],
"comments": [
{
"comment": "\ud83d\udfe6 Intezer Automated Triage\n===================================\n\ud83e\udde8 Generic Threat - APTSimulator_schedu... - Not Mitigated - Escalated\n===================================\n\n- Title: Suspicious behavior by cmd.exe was observed\n- Source: Microsoft Defender for Endpoint\n- Creation time: 07 Oct 25 | 10:25 UTC\n- External severity: Medium\n- Hosts: \n * workstation-01 (Windows10)\n- Description: A suspicious behavior by cmd.exe was observed. This behavior may indicate malware installation or other malicious activities on the machine.\n- TTPs:\n * Command and Control: Application Layer Protocol [T1071]\n * Defense Evasion: MMC [T1218.014]\n * Execution: Windows Command Shell [T1059.003]\n- Recommended actions: Isolation, Stop and Quarantine File, Run Intezer Endpoint Scan (https://docs.intezer.com/docs/live-endpoint-analysis)\n- Malicious files: APTSimulator_scheduler.bat\n\nView alert: \ud83d\udc49 https://analyze.intezer.com/alerts/da2052972f-7cc3-42c8-8abf-8ac490d63c35_1?environment=mde",
"createdBy": "API Action",
"createdTime": "2025-10-07T10:27:41.3867936Z"
},
{
"comment": "\ud83d\udfe6 Intezer Automated Triage (\ud83d\udca1Triage updated \u2192 Risk Deescalated)\n===================================\n\u26a0\ufe0f Suspicious - Not Mitigated - Follow Up Required\n===================================\n\n- Title: Suspicious behavior by cmd.exe was observed\n- Source: Microsoft Defender for Endpoint\n- Creation time: 07 Oct 25 | 10:25 UTC\n- External severity: Medium\n- Hosts: \n * workstation-01 (Windows10)\n- Description: A suspicious behavior by cmd.exe was observed. This behavior may indicate malware installation or other malicious activities on the machine.\n- TTPs:\n * Command and Control: Application Layer Protocol [T1071]\n * Defense Evasion: MMC [T1218.014]\n * Execution: Windows Command Shell [T1059.003]\n- Recommended actions: Ensure Device is Patched, Run Intezer Endpoint Scan (https://docs.intezer.com/docs/live-endpoint-analysis), Validate Activity with User\n- Malicious files: APTSimulator_scheduler.bat\n\nView alert: \ud83d\udc49 https://analyze.intezer.com/alerts/da2052972f-7cc3-42c8-8abf-8ac490d63c35_1?environment=mde",
"createdBy": "API Action",
"createdTime": "2025-10-07T10:32:21.417826Z"
}
],
"alert_domains": null,
"alert_ips": null,
"alert_processes": null
},
{
"id": "da2068d331-0335-4479-9f96-e8f33db81aa9_1",
"incident_id": 864492,
"investigation_id": 1780,
"assigned_to": "API-Automated Investigation and Response",
"severity": "Low",
"status": "Resolved",
"classification": null,
"determination": null,
"investigation_state": "Benign",
"detection_source": "WindowsDefenderAv",
"category": "Malware",
"threat_family_name": "Ceprolad",
"title": "An active 'Ceprolad' malware in a command line was prevented from executing",
"description": "Malware and unwanted software are undesirable applications that perform annoying, disruptive, or harmful actions on affected machines. Some of these undesirable applications can replicate and spread from one machine to another. Others are able to receive commands from remote attackers and perform activities associated with cyber attacks.\n\nA malware is considered active if it is found running on the machine or it already has persistence mechanisms in place. Active malware detections are assigned higher severity ratings.\n\nBecause this malware was active, take precautionary measures and check for residual signs of infection.",
"alert_creation_time": "2026-03-05T07:26:09.89Z",
"first_event_time": "2026-03-05T07:25:08.6889036Z",
"last_event_time": "2026-03-05T07:25:08.6889036Z",
"last_update_time": "2026-03-05T07:37:44.9066667Z",
"resolved_time": "2026-03-05T07:37:44.65021Z",
"machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
"alert_user": null,
"alert_files": [],
"comments": [],
"alert_domains": null,
"alert_ips": null,
"alert_processes": null
},
{
"id": "da29243e25-be1e-47b7-9d40-e626df36345c_1",
"incident_id": 688299,
"investigation_id": null,
"assigned_to": null,
"severity": "Medium",
"status": "InProgress",
"classification": null,
"determination": null,
"investigation_state": "UnsupportedAlertType",
"detection_source": "WindowsDefenderAtp",
"category": "Persistence",
"threat_family_name": null,
"title": "New group added suspiciously",
"description": "A new group was added after suspicious activities were detected. An attacker might add new users to the group in an attempt to gain a better foothold on the machine or network.",
"alert_creation_time": "2025-09-18T14:59:47.52Z",
"first_event_time": "2025-09-18T14:53:30.7348596Z",
"last_event_time": "2025-09-21T14:53:43.8093531Z",
"last_update_time": "2025-09-21T14:56:44.5166667Z",
"resolved_time": null,
"machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
"alert_user": null,
"alert_files": [],
"comments": [
{
"comment": "\ud83d\udfe6 Intezer Automated Triage\n===================================\n\u26a0\ufe0f Suspicious - APTSimulator_schedu... - Not Mitigated - Follow Up Required\n===================================\n\n- Title: New group added suspiciously\n- Source: Microsoft Defender for Endpoint\n- Creation time: 18 Sep 25 | 14:59 UTC\n- External severity: Medium\n- Hosts: \n * workstation-01 (Windows10)\n- Description: A new group was added after suspicious activities were detected. An attacker might add new users to the group in an attempt to gain a better foothold on the machine or network.\n- TTPs:\n * Command and Control: Application Layer Protocol [T1071]\n * Discovery: Local Groups [T1069.001]\n * Persistence: Account Manipulation [T1098]\n- Recommended actions: Ensure Device is Patched, Run Intezer Endpoint Scan (https://docs.intezer.com/docs/live-endpoint-analysis), Validate Activity with User\n\nView alert: \ud83d\udc49 https://analyze.intezer.com/alerts/da29243e25-be1e-47b7-9d40-e626df36345c_1?environment=mde",
"createdBy": "API Action",
"createdTime": "2025-09-18T15:03:43.2796289Z"
}
],
"alert_domains": null,
"alert_ips": null,
"alert_processes": null
},
{
"id": "da2be6df1c-2401-4545-8111-5f75d0fd0223_1",
"incident_id": 690846,
"investigation_id": null,
"assigned_to": "analyst@company.onmicrosoft.com",
"severity": "Low",
"status": "InProgress",
"classification": null,
"determination": null,
"investigation_state": "UnsupportedAlertType",
"detection_source": "WindowsDefenderAtp",
"category": "Execution",
"threat_family_name": null,
"title": "Suspicious JavaScript process",
"description": "A suspicious JavaScript process was observed on this device. Attackers typically use JavaScript to download secondary payloads, run additional commands, and perform other malicious activities on the target device.",
"alert_creation_time": "2025-10-01T10:26:20.6566667Z",
"first_event_time": "2025-10-01T10:24:19.1071611Z",
"last_event_time": "2025-10-07T10:24:27.1065475Z",
"last_update_time": "2026-02-13T08:14:22.61Z",
"resolved_time": null,
"machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
"alert_user": null,
"alert_files": [],
"comments": [
{
"comment": "\ud83d\udfe6 Intezer Automated Triage\n===================================\n\u26a0\ufe0f Suspicious - en-US.js - Not Mitigated - Follow Up Required\n===================================\n\n- Title: Suspicious JavaScript process\n- Source: Microsoft Defender for Endpoint\n- Creation time: 01 Oct 25 | 10:26 UTC\n- External severity: Low\n- Hosts: \n * workstation-01 (Windows10)\n- Description: A suspicious JavaScript process was observed on this device. Attackers typically use JavaScript to download secondary payloads, run additional commands, and perform other malicious activities on the target device.\n- TTPs:\n * Command and Control: Application Layer Protocol [T1071]\n * Defense Evasion: Indicator Removal on Host [T1070]\n * Defense Evasion: Indicator Removal on Host: Timestomp [T1070.006]\n- Recommended actions: Ensure Device is Patched, Run Intezer Endpoint Scan (https://docs.intezer.com/docs/live-endpoint-analysis), Validate Activity with User\n\nView alert: \ud83d\udc49 https://analyze.intezer.com/alerts/da2be6df1c-2401-4545-8111-5f75d0fd0223_1?environment=mde",
"createdBy": "API Action",
"createdTime": "2025-10-01T10:30:36.462226Z"
}
],
"alert_domains": null,
"alert_ips": null,
"alert_processes": null
},
{
"id": "da37252b75-0446-4a7b-99b4-e64886557bd3_1",
"incident_id": 688299,
"investigation_id": null,
"assigned_to": null,
"severity": "Low",
"status": "InProgress",
"classification": null,
"determination": null,
"investigation_state": "UnsupportedAlertType",
"detection_source": "WindowsDefenderAtp",
"category": "Execution",
"threat_family_name": null,
"title": "Suspicious JavaScript process",
"description": "A suspicious JavaScript process was observed on this device. Attackers typically use JavaScript to download secondary payloads, run additional commands, and perform other malicious activities on the target device.",
"alert_creation_time": "2025-09-18T14:59:46.57Z",
"first_event_time": "2025-09-18T14:54:11.4061419Z",
"last_event_time": "2025-09-21T14:54:00.575478Z",
"last_update_time": "2025-09-21T14:56:36.6533333Z",
"resolved_time": null,
"machine_id": "4f683b2d393afc3149b0de4149acc5449acdf07e",
"alert_user": null,
"alert_files": [],
"comments": [
{
"comment": "\ud83d\udfe6 Intezer Automated Triage\n===================================\n\u26a0\ufe0f Suspicious - wscript.exe - Not Mitigated - Follow Up Required\n===================================\n\n- Title: Suspicious JavaScript process\n- Source: Microsoft Defender for Endpoint\n- Creation time: 18 Sep 25 | 14:59 UTC\n- External severity: Low\n- Hosts: \n * workstation-01 (Windows10)\n- Description: A suspicious JavaScript process was observed on this device. Attackers typically use JavaScript to download secondary payloads, run additional commands, and perform other malicious activities on the target device.\n- TTPs:\n * Command and Control: Application Layer Protocol [T1071]\n * Defense Evasion: Indicator Removal on Host [T1070]\n * Defense Evasion: Indicator Removal on Host: Timestomp [T1070.006]\n- Recommended actions: Ensure Device is Patched, Run Intezer Endpoint Scan (https://docs.intezer.com/docs/live-endpoint-analysis), Validate Activity with User\n\nView alert: \ud83d\udc49 https://analyze.intezer.com/alerts/da37252b75-0446-4a7b-99b4-e64886557bd3_1?environment=mde",
"createdBy": "API Action",
"createdTime": "2025-09-18T15:06:13.2743521Z"
}
],
"alert_domains": null,
"alert_ips": null,
"alert_processes": null
}
]
}
]
Messages de sortie
L'action Obtenir les alertes liées à l'utilisateur peut renvoyer les messages de sortie suivants :
| Message de sortie | Description du message |
|---|---|
|
L'action a réussi. |
Error executing action "Get User Related Alerts". Reason:
ERROR_REASON |
Échec de l'action. Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants. |
Résultat du script
Le tableau suivant liste la valeur de la sortie du résultat du script lors de l'utilisation de l'action Get User Related Alerts (Obtenir les alertes liées à l'utilisateur) :
| Nom du résultat du script | Valeur |
|---|---|
is_success |
true ou false |
Isoler la machine
Isolez une machine à l'aide de Microsoft Defender for Endpoint. La machine peut être configurée en isolation complète ou en isolation sélective. Les applications Outlook, Skype Entreprise et Teams continuent de fonctionner sur une machine isolée.
Paramètres
| Nom à afficher du paramètre | Type | Valeur par défaut | Is Mandatory | Description |
|---|---|---|---|---|
| Type d'isolation | LDD | Complète Valeurs possibles :
|
Oui | Spécifiez le type d'isolation. |
| Commentaire | Chaîne | N/A | Oui | Indiquez pourquoi la machine doit être isolée. |
| Créer un insight ? | Case à cocher | Cochée | Si cette option est activée, l'action crée un insight Google SecOps avec les informations associées si elle est exécutée correctement. |
Cas d'utilisation
Isoler une machine considérée comme infectée. Par exemple, l'alerte du connecteur Defender ATP a été ingérée sur le serveur Google SecOps. Lors de l'analyse de l'alerte, il a été découvert que la machine liée à l'alerte (entité de cas) pouvait être infectée et devait être isolée.
Exécution
Cette action s'exécute sur les actions suivantes :
- Hôte
- Adresse IP
Résultats de l'action
Résultat du script
"True" si le point de terminaison de l'API a renvoyé l'état 201 pour chaque entité fournie sur laquelle il a été exécuté, dans la réponse JSON "status": "Pending", ce qui indique que la requête API a bien été exécutée. Si l'action échoue pour au moins une des entités, le résultat final doit être un échec (False).
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Résultat JSON
{
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#MachineActions/$entity",
"id": "example-id",
"type": "Isolate",
"requestor": "requestor-id",
"requestorComment": "Machine Isolation due to alert ...",
"status": "Pending",
"machineId": "machine-id",
"creationDateTimeUtc": "2019-11-21T03:55:59.5419077Z",
"lastUpdateDateTimeUtc": "2019-11-21T03:55:59.5419077Z",
"cancellationRequestor": null,
"cancellationComment": null,
"cancellationDateTimeUtc": null,
"errorHResult": 0,
"scope": null,
"relatedFileInfo": null
}
Insights
- Logique de l'insight : si la machine a été isolée à l'aide de l'agent Defender ATP, créez un insight pour l'indiquer.
- Type : Entity.
- Titre (chaîne) : entité.
- IdentifierMessage : "L'hôte a été isolé à l'aide de Microsoft Defender for Endpoint."
Lister les alertes
Répertoriez les alertes Microsoft Defender for Endpoint en fonction des critères de recherche fournis. L'action renvoie des informations sur les alertes trouvées dans un tableau et un formulaire de vue JSON en tant que résultat de l'action, ainsi que des données d'alerte brutes stockées dans le fichier JSON de sortie de l'action et jointes à celui-ci.
Paramètres
| Nom à afficher du paramètre | Type | Valeur par défaut | Is Mandatory | Description |
|---|---|---|---|---|
| Période | Integer | 3 | Non | Spécifiez une période en heures pour laquelle récupérer les alertes. |
| État | Chaîne | Unknown, New, InProgress, Resolved | Non | Spécifiez les états des alertes à rechercher. Le paramètre accepte plusieurs valeurs sous la forme d'une chaîne séparée par une virgule. |
| Gravité | Chaîne | N/A | Non | Spécifiez le niveau de gravité des incidents à rechercher. Si ce paramètre n'est pas fourni, l'action recherche tous les niveaux de gravité. Le paramètre accepte plusieurs valeurs sous la forme d'une chaîne séparée par une virgule. Valeurs possibles : UnSpecified, Informational, Low, Medium et High |
| Catégorie | Chaîne | N/A | Non | Spécifiez la catégorie d'alerte à rechercher. Si ce paramètre n'est pas fourni, l'action recherche toutes les catégories. Le paramètre accepte plusieurs valeurs sous la forme d'une chaîne d'éléments séparés par une virgule. Valeurs possibles : "Collection", "CommandAndControl", "CredentialAccess", "DefenseEvasion", "Discovery", "Execution", "Exfiltration", "Exploit", "InitialAccess", "LateralMovement", "Malware", "Persistence", "PrivilegeEscalation", "Ransomware", "SuspiciousActivity", "UnwantedSoftware". |
| ID de l'incident | Integer | N/A | Non | Spécifiez l'ID d'incident Microsoft Defender pour lequel vous souhaitez rechercher les alertes associées. |
Cas d'utilisation
L'action peut être utilisée pour examiner les avertissements Defender ATP sur le serveur Google SecOps pour un utilisateur final. Par exemple, lorsqu'il traite l'avertissement provenant du connecteur Defender ATP, l'utilisateur configure l'action "Lister les avertissements" pour accepter l'ID d'incident de l'alerte traitée comme paramètre d'entrée afin d'extraire les détails du serveur Defender ATP. Il existe d'autres avertissements qui font partie d'un seul incident Defender ATP.
Exécution
Cette action s'exécute sur toutes les entités.
Résultats de l'action
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Résultat JSON
{
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Alerts",
"value": [
{
"id": "example_id",
"incidentId": 2,
"investigationId": null,
"assignedTo": null,
"severity": "Medium",
"status": "New",
"classification": null,
"determination": null,
"investigationState": "UnsupportedAlertType",
"detectionSource": "WindowsDefenderAtp",
"category": "Execution",
"threatFamilyName": null,
"title": "Unexpected behavior observed by a process run with no command line arguments",
"description": "The legitimate process by this name does not normally exhibit this behavior when run with no command line arguments. \nSuch unexpected behavior may be a result of extraneous code injected into a legitimate process, or a malicious executable masquerading as the legitimate one by name.",
"alertCreationTime": "2019-11-19T03:56:35.3007009Z",
"firstEventTime": "2019-11-19T03:54:16.0441057Z",
"lastEventTime": "2019-11-19T03:54:16.0441057Z",
"lastUpdateTime": "2019-11-19T03:56:38.45Z",
"resolvedTime": null,
"machineId": "machine-id",
"alertUser": null,
"comments": [],
"alertFiles": [],
"alertDomains": [],
"alertIps": [],
"alertProcesses": []
}
]
}
Lister les indicateurs
Répertorier les indicateurs dans Microsoft Defender for Endpoint.
Paramètres
| Nom à afficher du paramètre | Type | Valeur par défaut | Is Mandatory | Description |
|---|---|---|---|---|
| Indicateurs | CSV | N/A | Non | Spécifiez une liste d'indicateurs que vous souhaitez récupérer, séparés par une virgule. |
| Types d'indicateurs | CSV | FileSha1,FileSha256,FileMd5,CertificateThumbprint,IpAddress,DomainName, Url | Non | Spécifiez une liste de types d'indicateurs à récupérer, séparés par une virgule. Valeurs possibles : FileSha1, FileSha256, FileMd5, CertificateThumbprint, IpAddress,DomainName, Url. |
| Actions | CSV | Warn,Block,Audit,Alert,AlertAndBlock,BlockAndRemediate,Allowed | Non | Spécifiez une liste d'actions d'indicateur que vous souhaitez utiliser pour le filtrage, séparées par une virgule. Valeurs possibles : Warn,Block,Audit,Alert, AlertAndBlock,BlockAndRemediate,Allowed |
| Gravité | CSV | Informative,Faible,Moyenne,Élevée | Non | Spécifiez une liste de niveaux de gravité à utiliser pour le filtrage, séparés par une virgule. Valeurs possibles : Informational,Low,Medium,High |
| Nombre maximal de résultats à renvoyer | Integer | 50 | Non | Spécifiez le nombre d'indicateurs à renvoyer. |
Exécution
Cette action ne s'exécute pas sur les entités.
Résultats de l'action
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Résultat JSON
{
"id": "18",
"indicatorValue": "110e7d15b011d7fac48f2bd61114db1022197f7a",
"indicatorType": "FileSha1",
"action": "Audit",
"createdBy": "45e9773c-100e-4a9f-ad37-d8e182e9ed26",
"severity": "Informational",
"category": 1,
"application": "demo-test",
"educateUrl": null,
"bypassDurationHours": null,
"title": "test",
"description": "test",
"recommendedActions": "nothing",
"creationTimeDateTimeUtc": "2022-02-08T14:20:34.9071582Z",
"expirationTime": null,
"lastUpdateTime": "2022-02-08T14:20:34.9151307Z",
"lastUpdatedBy": null,
"rbacGroupNames": [],
"rbacGroupIds": [],
"notificationId": null,
"notificationBody": null,
"version": null,
"mitreTechniques": [],
"historicalDetection": false,
"lookBackPeriod": null,
"generateAlert": true,
"additionalInfo": null,
"createdByDisplayName": "Example Defender ATP",
"externalId": null,
"createdBySource": "PublicApi",
"certificateInfo": null
}
Mur des cas
| Type de résultat | Valeur / Description | Type |
|---|---|---|
| Message de sortie* | L'action ne doit pas échouer ni arrêter l'exécution d'un playbook : Si des données sont disponibles (is_success=true) : "Successfully found indicators for the provided criteria in Microsoft Defender for Endpoint." (Indicateurs trouvés pour les critères fournis dans Microsoft Defender pour point de terminaison). Si les données ne sont pas disponibles (is_success=false) : "Aucun indicateur n'a été trouvé pour les critères fournis dans Microsoft Defender pour point de terminaison." L'action doit échouer et arrêter l'exécution d'un playbook : Si une erreur fatale est signalée, par exemple des identifiants incorrects , une absence de connexion au serveur ou autre : "Error executing action "List Indicators". Reason: {0}''.format(error.Stacktrace) Si un paramètre "Types d'indicateurs" non valide est fourni : "Erreur lors de l'exécution de l'action 'Lister les indicateurs'. Motif : valeur non valide pour le paramètre "Types d'indicateurs". Valeurs possibles : FileSha1, FileSha256, FileMd5, CertificateThumbprint, IpAddress, DomainName, Url. Si un paramètre "Actions" non valide est fourni : "Error executing action "List Indicators". Motif : valeur non valide pour le paramètre "Actions". Valeurs possibles : Warn, Block, Audit, Alert, AlertAndBlock, BlockAndRemediate, Allowed. Si un paramètre "Severity" non valide est fourni : "Error executing action "List Indicators". Motif : valeur non valide pour le paramètre "Actions". Valeurs possibles : Informational, Low, Medium, High. |
Général |
| Tableau du mur des cas | Indicateurs trouvés Type : indicatorType Action : action Gravité : severity Description : description Titre : title Recommandation : recommendedActions |
Entité |
Lister les machines
Obtenez des informations sur les machines enregistrées auprès du serveur Microsoft Defender pour point de terminaison en fonction des paramètres fournis pour la recherche.
Paramètres
| Paramètre | Type | Valeur par défaut | Is Mandatory | Description |
|---|---|---|---|---|
| Période de la dernière activité | Integer | N/A | Non | Spécifiez la période de dernière détection à rechercher, en heures. |
| Nom de la machine | Chaîne | N/A | Non | Spécifiez le nom complet de la machine à rechercher. |
| Adresse IP de la machine | Chaîne | N/A | Non | Spécifiez l'adresse IP de la machine à rechercher. |
| Score de risque de la machine | Chaîne | Aucun, Faible, Moyen, Élevé | Non | Spécifiez le score de risque de la machine à rechercher. Le paramètre accepte plusieurs valeurs sous la forme d'une chaîne séparée par une virgule. |
| État de fonctionnement de la machine | Chaîne | Active, Inactive, ImpairedCommunication, NoSensorData, NoSensorDataImpairedCommunication | Non | Spécifiez l'état de fonctionnement de la machine à rechercher. Le paramètre accepte plusieurs valeurs sous la forme d'une chaîne séparée par une virgule. |
| Plate-forme de l'OS de la machine | Chaîne | N/A | Non | Spécifiez la plate-forme d'OS de la machine à rechercher. |
| ID du groupe RBAC | Chaîne | N/A | Non | Spécifiez l'ID du groupe RBAC à rechercher. |
Cas d'utilisation
L'action peut être utilisée à des fins d'investigation pour obtenir des informations sur les appareils enregistrés sur le serveur Defender ATP. Cette action est principalement utilisée comme action manuelle, pour que l'utilisateur n'ait pas à revenir à la console Defender ATP et à rechercher les machines sur lesquelles l'agent Defender ATP fonctionne.
Exécution
Cette action s'exécute sur toutes les entités.
Résultats de l'action
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Résultat JSON
{
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Machines",
"value": [
{
"id": "example-id",
"computerDnsName": "example-name",
"firstSeen": "2019-11-18T11:13:04.0588699Z",
"lastSeen": "2019-11-20T09:59:28.0646303Z",
"osPlatform": "Windows10",
"osVersion": null,
"osProcessor": "x64",
"version": "1803",
"lastIpAddress": "192.0.2.138",
"lastExternalIpAddress": "203.0.113.35",
"agentVersion": "10.4860.17134.982",
"osBuild": 17134,
"healthStatus": "Active",
"rbacGroupId": 0,
"rbacGroupName": null,
"riskScore": "High",
"exposureLevel": "Medium",
"aadDeviceId": null,
"machineTags": []
},{
"id": "example-id",
"computerDnsName": "example-name",
"firstSeen": "2019-11-20T08:36:16.2721384Z",
"lastSeen": "2019-11-20T08:36:52.7182837Z",
"osPlatform": "Windows10",
"osVersion": null,
"osProcessor": "x64",
"version": "1803",
"lastIpAddress": "192.0.2.141",
"lastExternalIpAddress": "203.0.113.35",
"agentVersion": "10.4850.17134.191",
"osBuild": 17134,
"healthStatus": "Active",
"rbacGroupId": 0,
"rbacGroupName": null,
"riskScore": "None",
"exposureLevel": "Medium",
"aadDeviceId": null,
"machineTags": []
}
]
}
Ping
Testez la connectivité à l'instance Microsoft Defender for Endpoint avec les paramètres fournis sur la page de configuration de l'intégration.
Paramètres
N/A
Cas d'utilisation
L'action permet de tester la connectivité et peut être exécutée en tant qu'action manuelle, qui ne fait pas partie des playbooks.
Exécution
Cette action s'exécute sur toutes les entités.
Résultats de l'action
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Exécuter une requête de traque avancée
Exécutez une requête de repérage avancé Microsoft Defender for Endpoint. Notez que les guillemets, les nouvelles lignes ou d'autres symboles spéciaux doivent être échappés. Par exemple, utilisez la barre oblique inverse pour échapper les guillemets.
Paramètres
| Nom à afficher du paramètre | Type | Valeur par défaut | Est obligatoire | Description |
|---|---|---|---|---|
| Nom à afficher du paramètre | Type | Valeur par défaut | Is Mandatory | Description |
| Query | Chaîne | N/A | Oui | Requête de traque avancée à exécuter. |
Cas d'utilisation
L'utilisateur peut disposer de requêtes de recherche qu'il souhaite utiliser pour interroger les données collectées dans Defender ATP lors du traitement d'une alerte Defender spécifique. Cette action lui permet d'exécuter ces requêtes de recherche avancées.
Exécution
Cette action s'exécute sur toutes les entités.
Résultats de l'action
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Résultat JSON
{
"Stats": {
"ExecutionTime": 0.0156652,
"resource_usage": {
"cache": {
"memory": {
"hits": 13,
"misses": 0,
"total": 13
},
"disk": {
"hits": 0,
"misses": 0,
"total": 0
}
},
"cpu": {
"user": "00:00:00.0156250",
"kernel": "00:00:00",
"total cpu": "00:00:00.0156250"
},
"memory": {
"peak_per_node": 33554624
}
},
"dataset_statistics": [
{
"table_row_count": 2,
"table_size": 60
}
]
},
"Schema": [
{
"Name": "EventTime",
"Type": "DateTime"
},
{
"Name": "FileName",
"Type": "String"
},
{
"Name": "InitiatingProcessFileName",
"Type": "String"
}
],
"Results": [
{
"EventTime": "2019-11-18T11:13:07.043128Z",
"FileName": "csc.exe",
"InitiatingProcessFileName": "powershell.exe"
},
{
"EventTime": "2019-11-19T03:54:14.4256361Z",
"FileName": "csc.exe",
"InitiatingProcessFileName": "powershell.exe"
}
]
}
Exécuter une analyse antivirus
Lancez une analyse antivirus sur un hôte à l'aide de Microsoft Defender for Endpoint. Deux types d'analyses Defender ATP sont disponibles : complète ou rapide.
Paramètres
| Nom à afficher du paramètre | Type | Valeur par défaut | Is Mandatory | Description |
|---|---|---|---|---|
| Type d'analyse antivirus | LDD | Complète Valeurs possibles :
|
Oui | Indiquez si vous souhaitez lancer une analyse antivirus complète ou rapide sur l'ordinateur. |
| Commentaire | Chaîne | N/A | Oui | Indiquez pourquoi une analyse antivirus doit être exécutée sur la machine. |
Cas d'utilisation
Une alerte a été émise par le connecteur Defender ATP. Lors du traitement de l'alerte, des indicateurs de compromission par un logiciel malveillant ont été détectés sur la machine liée à l'entité de l'incident Google SecOps. L'utilisateur a donc décidé d'exécuter une analyse antivirus sur la machine pour essayer de trouver un logiciel malveillant sur l'hôte.
Exécution
Cette action s'exécute sur les entités suivantes :
- Hôte
- Adresse IP
Résultats de l'action
Résultat du script
"True" si le point de terminaison de l'API a renvoyé l'état 201 pour chaque entité fournie sur laquelle il a été exécuté, dans la réponse JSON "status": "Pending", ce qui indique que la requête API a bien été exécutée. Si l'action échoue pour au moins une des entités, le résultat final doit être un échec (False).
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Résultat JSON
{
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#MachineActions/$entity",
"id": "example-id",
"type": "RunAntiVirusScan",
"requestor": "requestor_id",
"requestorComment": "Run antivirus scan on suspect",
"status": "Pending",
"machineId": "machine-id",
"creationDateTimeUtc": "2019-11-21T11:07:06.611628Z",
"lastUpdateDateTimeUtc": "2019-11-21T11:07:06.611628Z",
"cancellationRequestor": null,
"cancellationComment": null,
"cancellationDateTimeUtc": null,
"errorHResult": 0,
"scope": null,
"relatedFileInfo": null
}
Arrêter et mettre en quarantaine un fichier sur une machine spécifique
Arrêtez l'exécution d'un fichier sur une machine spécifique et mettez-le en quarantaine à l'aide de l'agent Microsoft Defender for Endpoint. L'action fonctionne avec les entités Google SecOps "Hôte" ou "IP".
Paramètres
| Nom à afficher du paramètre | Type | Valeur par défaut | Is Mandatory | Description |
|---|---|---|---|---|
| Hachage de fichier SHA1 à mettre en quarantaine | Chaîne | N/A | Oui | Spécifiez le hachage de fichier SHA-1 du fichier à arrêter et à mettre en quarantaine. Remarque : Le hachage SHA-1 doit être en minuscules pour que l'action trouve le fichier correspondant. |
| Commentaire | Chaîne | N/A | Oui | Spécifiez un commentaire expliquant pourquoi une analyse antivirus doit être exécutée sur la machine. |
| Créer un insight ? | Case à cocher | Cochée | Si cette option est activée, l'action créera un insight Google SecOps avec les informations associées si elle est exécutée correctement. |
Cas d'utilisation
Lors du traitement de l'alerte provenant du connecteur Defender ATP, l'action "Arrêter et mettre en quarantaine le fichier" peut être utilisée pour bloquer l'exécution du fichier spécifique afin d'éviter que la machine ne soit compromise. Cette action peut être nécessaire lors d'une recherche avancée, et l'utilisateur peut découvrir des fichiers potentiellement malveillants qu'il souhaite bloquer sur une seule machine.
Exécution
Cette action s'exécute sur les entités suivantes :
- Hôte
- Adresse IP
Résultats de l'action
Résultat du script
Peut être "True" ou "False". "True" si le point de terminaison de l'API a renvoyé l'état 201 pour chaque entité fournie sur laquelle il a été exécuté, dans la réponse JSON "status": "Pending", ce qui indique que la requête API a bien été exécutée. Si l'action échoue pour au moins l'une des entités, le résultat final doit être un échec (False).
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Résultat JSON
{
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#MachineActions/$entity",
"id": "example-id",
"type": "StopAndQuarantineFile",
"requestor": "requestor-id",
"requestorComment": "Stopping and quarantining putty",
"status": "Pending",
"machineId": "machine-id",
"creationDateTimeUtc": "2019-11-25T10:05:21.3641296Z",
"lastUpdateDateTimeUtc": "2019-11-25T10:05:21.3641296Z",
"cancellationRequestor": null,
"cancellationComment": null,
"cancellationDateTimeUtc": null,
"errorHResult": 0,
"scope": null,
"relatedFileInfo": {
"fileIdentifier": "d932604ab8e9debe475415851fd26929a0c0dcd1",
"fileIdentifierType": "Sha1"
}
}
Insights
- Type : Entity.
- Titre (chaîne) : entité.
- IdentifierMessage (chaîne) : "Le fichier avec le hachage de fichier SHA-1 {0} a été arrêté et mis en quarantaine sur {1}". format (filehash,entity.Identifier).
Envoyer des indicateurs d'entité
Envoyez des entités en tant qu'indicateurs dans Microsoft Defender for Endpoint.
Paramètres
| Nom à afficher du paramètre | Type | Valeur par défaut | Is Mandatory | Description |
|---|---|---|---|---|
| Action | LDD | Bloquer Valeurs possibles :
|
Oui | Spécifiez l'action à appliquer aux entités. Remarque : La valeur "Bloquer et corriger" n'est compatible qu'avec les entités de hachage de fichier. |
| Gravité | LDD | Élevée Valeurs possibles :
|
Oui | Spécifiez le niveau de gravité des entités trouvées. |
| Application | Chaîne | N/A | Non | Spécifiez une application associée aux entités. |
| Titre de l'alerte de l'indicateur | Chaîne | N/A | Oui | Spécifiez le titre de l'alerte, s'ils sont identifiés dans l'environnement. |
| Description | Chaîne | Remédiation Google SecOps | Oui | Spécifiez la description des entités. |
| Action recommandée | Chaîne | N/A | Non | Spécifiez les actions recommandées pour le traitement des entités. |
Exécution
Cette action s'exécute sur les entités suivantes :
- Adresse IP
- URL
- Filehash
Résultats de l'action
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Mur des cas
| Type de résultat | Valeur / Description | Type |
|---|---|---|
| Message de sortie* | L'action ne doit pas échouer ni arrêter l'exécution d'un playbook : Si des données sont disponibles pour une entité (is_success = true) : "Successfully submitted the following entities as indicators to Microsoft Defender for Endpoint: {entity.identifier}". Si les données ne sont pas disponibles pour une entité (is_success=true) : "L'action n'a pas pu envoyer les entités suivantes en tant qu'indicateurs à Microsoft Defender pour point de terminaison : {entity.identifier}". Si le code d'état 403 est signalé pour une entité : "L'instance ne dispose pas des autorisations suffisantes pour envoyer les entités suivantes : {entity.identifier} Si les données ne sont pas disponibles pour toutes les entités (is_success=false) : "Aucune des entités fournies n'a été envoyée en tant qu'indicateur à Microsoft Defender pour point de terminaison." Si une entité est déjà un indicateur : "Les entités suivantes sont déjà des indicateurs dans Microsoft Defender pour point de terminaison : {entity.identifier}" L'action doit échouer et arrêter l'exécution d'un playbook : En cas d'erreur fatale, comme des identifiants incorrects, une absence de connexion au serveur ou autre : "Error executing action "Submit Entity Indicators". Reason: {0}''.format(error.Stacktrace) Si le code d'état 403 est signalé pour toutes les entités : "Error executing action "Submit Entity Indicators". Motif : aucun des indicateurs n'a été créé en raison des autorisations de l'instance. Veuillez vérifier la configuration.''. |
Général |
Désisoler la machine
Annulez l'isolation d'une machine qui a été précédemment isolée à l'aide de Microsoft Defender for Endpoint.
Paramètres
| Nom à afficher du paramètre | Type | Valeur par défaut | Is Mandatory | Description |
|---|---|---|---|---|
| Commentaire | Chaîne | N/A | Oui | Indiquez pourquoi la machine doit être désisolée. |
| Créer un insight ? | Case à cocher | Cochée | Si cette option est activée, l'action crée un insight Google SecOps avec les informations associées si elle est exécutée correctement. |
Cas d'utilisation
Cette action peut être utilisée dans les situations où la machine a déjà été isolée, mais avec les nouvelles données recueillies lors du traitement du playbook (par exemple, la première machine a été isolée, puis nous avons créé un indicateur de menace pour un fichier suspect et exécuté l'action "Arrêter et mettre en quarantaine" pour supprimer ce fichier de la machine concernée), nous pouvons considérer qu'il est sûr de supprimer la machine concernée de l'isolation.
Exécution
Cette action s'exécute sur les entités suivantes :
- Hôte
- Adresse IP
Résultats de l'action
Résultat du script
"True" si le point de terminaison de l'API a renvoyé l'état 201 pour chaque entité fournie sur laquelle il a été exécuté, dans la réponse JSON "status": "Pending", ce qui indique que la requête API a bien été exécutée. Si l'action échoue pour au moins une des entités, le résultat final doit être un échec (False).
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Résultat JSON
{
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#MachineActions/$entity",
"id": "example-id",
"type": "Unisolate",
"requestor": "requestor-id",
"requestorComment": "Unisolate machine due to the following remediation measures taken...",
"status": "Pending",
"machineId": "machine-id",
"creationDateTimeUtc": "2019-11-21T03:59:34.7389352Z",
"lastUpdateDateTimeUtc": "2019-11-21T03:59:34.7389352Z",
"cancellationRequestor": null,
"cancellationComment": null,
"cancellationDateTimeUtc": null,
"errorHResult": 0,
"scope": null,
"relatedFileInfo": null
}
Insights
- Type : Entité
- Titre : entité.
- IdentifierMessage : l'isolation Microsoft Defender for Endpoint a été supprimée.
Mettre à jour l'alerte
Mettre à jour une alerte Microsoft Defender for Endpoint spécifique. L'action peut être utilisée pour fermer une alerte dans Microsoft Defender for Endpoint.
Paramètres
| Paramètre | Type | Valeur par défaut | Is Mandatory | Description |
|---|---|---|---|---|
| ID d'alerte | Chaîne | N/A | Oui | Spécifiez l'ID de l'alerte Microsoft Defender for Endpoint à mettre à jour. |
| État | LDD | Nouveau Valeurs possibles :
|
Non | Spécifiez l'état de l'alerte à mettre à jour. |
| Attribué à | Chaîne | N/A | Non | Spécifiez les informations utilisateur si vous souhaitez mettre à jour ce champ. |
| Classification | LDD | Inconnu Valeurs possibles :
|
Non | Spécifiez la classification avec laquelle mettre à jour l'alerte. |
| Détermination | LDD | NotAvailable Valeurs possibles :
|
Non | Spécifiez la détermination avec laquelle mettre à jour l'alerte. |
Cas d'utilisation
Utilisez l'action pour mettre à jour un avertissement Defender ATP.
Utilisez l'action pour intervenir dans un workflow impliquant l'analyse des avertissements Defender ATP.
Une fois l'alerte traitée dans Google SecOps, vous pouvez ignorer l'alerte Defender ATP pour que les listes d'alertes Defender ATP et Google SecOps restent alignées. Vous pouvez également modifier l'alerte pour afficher la progression de l'analyse de l'alerte (par exemple, définir l'attribut
assignedToou définir l'état de l'alerte surinProgress).
Exécution
Cette action s'exécute sur toutes les entités.
Résultats de l'action
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Résultat JSON
{
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#Alerts/$entity",
"id": "example-id",
"incidentId": 1,
"investigationId": null,
"assignedTo": null,
"severity": "Informational",
"status": "Resolved",
"classification": null,
"determination": null,
"investigationState": "UnsupportedAlertType",
"detectionSource": "WindowsDefenderAtp",
"category": "Execution",
"threatFamilyName": null,
"title": "[Test Alert] Suspicious Powershell commandline",
"description": "*** This is a test alert ***\nA suspicious Powershell commandline was found on the machine. This commandline might be used during installation, exploration, or in some cases with lateral movement activities which are used by attackers to invoke modules, download external payloads, and get more information about the system. Attackers usually use Powershell to bypass security protection mechanisms by executing their payload in memory without touching the disk and leaving any trace.",
"alertCreationTime": "2019-11-18T11:17:48.287421Z",
"firstEventTime": "2019-11-18T11:15:06.5226815Z",
"lastEventTime": "2019-11-18T11:15:06.5226815Z",
"lastUpdateTime": "2019-11-20T04:12:03.6066667Z",
"resolvedTime": "2019-11-20T04:12:03.4976288Z",
"machineId": "machine-id",
"alertUser": {
"accountName": "Administrator",
"domainName": "example-domain"
},
"comments": [],
"alertFiles": [
{
"sha1": "3ce71813199abae99348f61f0caa34e2574f831c",
"sha256": "9a7c58bd98d70631aa1473f7b57b426db367d72429a5455b433a05ee251f3236",
"filePath": "C:\\Windows\\System32\\cmd.exe",
"fileName": "cmd.exe"
},
{
"sha1": "1b3b40fbc889fd4c645cc12c85d0805ac36ba254",
"sha256": "d3f8fade829d2b7bd596c4504a6dae5c034e789b6a3defbe013bda7d14466677",
"filePath": "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
"fileName": "powershell.exe"
}
],
"alertDomains": [],
"alertIps": [],
"alertProcesses": []
}
Attendre l'état de la tâche
Attendre l'état d'une tâche.
Paramètres
| Nom à afficher du paramètre | Type | Valeur par défaut | Is Mandatory | Description |
|---|---|---|---|---|
| ID de tâche | Chaîne | N/A | Oui | Liste des ID de tâche sous forme de chaîne séparée par une virgule. |
Exécution
Cette action s'exécute sur toutes les entités.
Résultats de l'action
Résultat du script
| Nom du résultat du script | Options de valeur | Exemple |
|---|---|---|
| is_success | Vrai/Faux | is_success:False |
Résultat JSON
[
{
"status": "Succeeded",
"creation_date_time_utc": "2020-02-08T03:24:52.8526634Z",
"cancellation_requestor": null,
"cancellation_date_time_utc": null,
"id": "2e39d22e-60a7-4267-899c-a1471e800000",
"last_update_date_time_utc": "2020-02-08T03:25:35.8345081Z",
"related_file_info": null,
"cancellation_comment": null,
"requestor": "e4fc6454-754d-47f7-bbdb-045fad600000",
"error_h_result": 0,
"scope": "Selective",
"machine_id": "fbc85cf3fbcc8bb14d1a84fcf7bbae4531f00000",
"type": "Isolate",
"requestor_comment": "test"
}
]
Connecteurs
Pour obtenir des instructions détaillées sur la configuration d'un connecteur dans Google SecOps, consultez Configurer le connecteur.
Pour configurer le connecteur sélectionné, utilisez les paramètres spécifiques au connecteur listés dans les tableaux suivants :
- Paramètres de configuration du connecteur Microsoft Defender ATP
- Paramètres de configuration du connecteur Microsoft Defender ATP v2
Connecteur Microsoft Defender ATP
L'API SIEM Defender ATP utilisée dans le connecteur Microsoft Defender ATP pour les événements est obsolète depuis le 1er mars 2022.
Le connecteur se connecte régulièrement au point de terminaison de l'API Defender ATP et extrait une liste d'alertes générées pour une période spécifique. Pour les alertes traitées, le connecteur extrait les informations sur les détections de Defender ATP dans une requête distincte. Les détections comportent un champ AlertId qui peut être utilisé pour associer les détections à des alertes spécifiques.
Paramètres du connecteur
Utilisez les paramètres suivants pour configurer le connecteur :
| Nom à afficher du paramètre | Type | Valeur par défaut | Est obligatoire | Description |
|---|---|---|---|---|
| Nom du champ de produit | Chaîne | ProductName | Oui | Décrit le nom du champ dans lequel le nom du produit est stocké. |
| Nom du champ d'événement | Chaîne | AlertName | Oui | Décrit le nom du champ dans lequel le nom de l'événement est stocké. |
| Nom du champ d'environnement | Chaîne | "" | Non | Nom du champ dans lequel le nom de l'environnement est stocké. Si le champ d'environnement est introuvable, l'environnement est "". |
| Modèle d'expression régulière de l'environnement | Chaîne | .* | Non | Modèle d'expression régulière à exécuter sur la valeur trouvée dans le champ La valeur par défaut est ".*" pour tout récupérer et renvoyer la valeur inchangée. Permet à l'utilisateur de manipuler le champ "environment" à l'aide d'une logique d'expression régulière. Si le modèle d'expression régulière est nul ou vide, ou si la valeur de l'environnement est nulle, le résultat final de l'environnement est "". |
| Racine de l'API | Chaîne | https://api.securitycenter.windows.com | Oui | URL racine de l'API à utiliser avec l'intégration. Pour de meilleures performances, vous pouvez utiliser un serveur plus proche de votre emplacement :
|
| ID Azure Active Directory | Chaîne | N/A | Oui | L'ID de locataire Microsoft Entra est disponible dans Active Directory > Inscription d'applications > Votre application > ID de répertoire (locataire). |
| ID client d'intégration | Chaîne | N/A | Oui | ID client (application) ajouté pour l'enregistrement de l'application dans Microsoft Entra pour l'intégration. |
| Code secret du client d'intégration | Mot de passe | N/A | Oui | Secret saisi pour l'enregistrement de l'application Azure AD pour l'intégration. |
| ID client SIEM | Chaîne | N/A | Oui | ID client (application) pour l'intégration SIEM activée dans Microsoft Defender for Endpoint. |
| Code secret du client SIEM | Mot de passe | N/A | Oui | Secret pour l'intégration SIEM activée dans Microsoft Defender for Endpoint. |
| Heure du décalage en heures | Integer | 24 | Oui | Récupérez les alertes des X dernières heures. |
| Nombre maximal d'alertes par cycle | Integer | 100 | Oui | Nombre d'alertes traitées lors d'une exécution du connecteur. |
| États d'alerte à récupérer | Chaîne | Unknown, New, InProgress, Resolved | Oui | Spécifiez les états des alertes Defender ATP qui doivent être récupérées par le serveur Google SecOps. Le paramètre peut prendre plusieurs valeurs sous la forme d'une chaîne de valeurs séparées par une virgule. |
| Niveaux de gravité des alertes à récupérer | Chaîne | Non spécifié, Informatif, Faible, Moyen, Élevé | Oui | Spécifiez les niveaux de gravité des alertes Defender ATP qui doivent être récupérées par le serveur Google SecOps. Le paramètre peut prendre plusieurs valeurs sous la forme d'une chaîne de valeurs séparées par une virgule. |
| Adresse du serveur proxy | IP_OR_HOST | N/A | Non | Serveur proxy à utiliser pour la connexion. |
| Nom d'utilisateur du serveur proxy | Chaîne | N/A | Non | Nom d'utilisateur du serveur proxy. |
| Mot de passe du serveur proxy | Mot de passe | N/A | Non | Mot de passe du serveur proxy. |
Règles du connecteur
Le connecteur n'est pas compatible avec les règles de liste de blocage ou de liste dynamique.
Le connecteur est compatible avec les proxys.
Connecteur Microsoft Defender ATP V2
Récupérez les alertes Defender ATP à l'aide de l'API d'incident 365 Defender pour obtenir les données d'événement. Utilisez la liste dynamique du connecteur pour n'ingérer que des types d'alertes spécifiques en fonction de la valeur de l'attribut detectionSource de l'alerte.
L'attribut de connecteur SourceGroupIdentifier peut être utilisé pour regrouper les alertes en fonction de l'ID d'incident Defender ATP.
Prérequis
Avant de configurer le connecteur, veillez à accorder des autorisations supplémentaires à votre application Microsoft Entra :
Connectez-vous au portail Azure en tant qu'administrateur d'utilisateurs ou administrateur de mots de passe.
Sélectionnez Microsoft Entra ID.
Accédez à API Permissions> Add a permission> APIs my organization uses (Autorisations d'API > Ajouter une autorisation > API utilisées par mon organisation).
Sélectionnez Microsoft Threat Protection > Application permissions (Microsoft Threat Protection > Autorisations de l'application).
Dans la section Sélectionner des autorisations, sélectionnez les autorisations requises suivantes :
Incident.Read.AllIncident.ReadWrite.All
Cliquez sur Ajouter des autorisations.
Cliquez sur Accorder le consentement administrateur pour
YOUR_ORGANIZATION_NAME.
Paramètres du connecteur
Utilisez les paramètres suivants pour configurer le connecteur :
| Nom à afficher du paramètre | Type | Valeur par défaut | Est obligatoire | Description |
|---|---|---|---|---|
| Nom du champ de produit | Chaîne | :: | Oui | Décrit le nom du champ dans lequel le nom du produit est stocké. |
| Nom du champ d'événement | Chaîne | EventName | Oui | Décrit le nom du champ dans lequel le nom de l'événement est stocké. |
| Nom du champ d'environnement | Chaîne | "" | Non | Nom du champ dans lequel le nom de l'environnement est stocké. Si le champ d'environnement est introuvable, l'environnement est "". |
| Modèle d'expression régulière de l'environnement | Chaîne | .* | Non | Modèle d'expression régulière à exécuter sur la valeur trouvée dans le champ La valeur par défaut est ".*" pour tout récupérer et renvoyer la valeur inchangée. Permet à l'utilisateur de manipuler le champ "environment" à l'aide d'une logique d'expression régulière. Si le modèle d'expression régulière est nul ou vide, ou si la valeur de l'environnement est nulle, le résultat final de l'environnement est "". |
| Racine de l'API Defender ATP | Chaîne | https://api.securitycenter.windows.com | Oui | URL racine de l'API à utiliser avec l'intégration Pour de meilleures performances, vous pouvez utiliser un serveur plus proche de votre emplacement :
|
| Racine de l'API 365 Defender | Chaîne | https://api.security.microsoft.com | Oui | Racine de l'API de l'instance Microsoft 365 Defender utilisée pour obtenir les données d'événements Google SecOps. |
| ID Azure Active Directory | Chaîne | N/A | Oui | ID de locataire Microsoft Entra, disponible dans Microsoft Entra > Enregistrement de l'application > Votre application > ID de répertoire (locataire). |
| ID client d'intégration | Chaîne | N/A | Oui | ID client (application) ajouté pour l'enregistrement de l'application dans Microsoft Entra pour l'intégration. |
| Code secret du client d'intégration | Mot de passe | N/A | Oui | Secret saisi pour l'enregistrement de l'application Azure AD pour l'intégration. |
| Vérifier le protocole SSL | Case à cocher | Cochée | Oui | Si cette option est activée, elle vérifie que le certificat SSL de la connexion au serveur Microsoft 365 Defender est valide. |
| Heure du décalage en heures | Integer | 24 | Oui | Récupérez les alertes des X dernières heures. |
| Nombre maximal d'alertes par cycle | Integer | 10 | Oui | Nombre d'alertes traitées lors d'une exécution du connecteur. |
| États d'alerte à récupérer | Chaîne | Unknown, New, InProgress, Resolved | Oui | Spécifiez les états des alertes Defender ATP qui doivent être récupérées par le serveur Google SecOps. Le paramètre peut prendre plusieurs valeurs sous la forme d'une chaîne de valeurs séparées par une virgule. |
| Niveaux de gravité des alertes à récupérer | Chaîne | Non spécifié, Informatif, Faible, Moyen, Élevé | Oui | Spécifiez les niveaux de gravité des alertes Defender ATP qui doivent être récupérées par le serveur Google SecOps. Le paramètre peut prendre plusieurs valeurs sous la forme d'une chaîne de valeurs séparées par une virgule. |
| Désactiver le dépassement | Case à cocher | Décochée | Non | Si cette option est activée, le connecteur ignore le mécanisme de dépassement. |
| Délai avant expiration du script | Integer | 300 | Oui | Spécifiez le délai avant expiration pour l'exécution du connecteur. |
| Utiliser la liste d'autorisation comme liste de blocage | Case à cocher | Décochée | Non | Si cette option est activée, la liste dynamique est utilisée comme liste de blocage. |
| Adresse du serveur proxy | IP_OR_HOST | N/A | Non | Serveur proxy à utiliser pour la connexion. |
| Nom d'utilisateur du serveur proxy | Chaîne | N/A | Non | Nom d'utilisateur du serveur proxy. |
| Mot de passe du serveur proxy | Mot de passe | N/A | Non | Mot de passe du serveur proxy. |
Règles du connecteur
Le connecteur est compatible avec une logique de liste dynamique basée sur la valeur du champ d'alerte detectionSource Defender ATP.
Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.