Microsoft Defender for Endpoint

Ce document explique comment intégrer Microsoft Defender pour point de terminaison à Google SecOps.

Cas d'utilisation

  1. 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.

  2. 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.

  3. 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 :

  1. Créez l'application Microsoft Entra.

  2. Configurez les autorisations de l'API pour votre application.

  3. 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

  1. Connectez-vous au portail Azure en tant qu'administrateur d'utilisateurs ou administrateur de mots de passe.

  2. Sélectionnez Microsoft Entra ID.

  3. Accédez à Inscriptions d'applications > Nouvelle inscription.

  4. Saisissez le nom de l'application.

  5. Cliquez sur S'inscrire.

  6. 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

  1. 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.

  2. Dans le champ Rechercher, saisissez WindowsDefenderATP.

  3. Sélectionnez WindowsDefenderATP > Application permissions (Autorisations de l'application).

  4. Sous le type d'autorisation Alerte, sélectionnez l'autorisation suivante :

    • Alert.Read.All
  5. Cliquez sur Ajouter des autorisations.

  6. Sur la page API Permissions (Autorisations des API), cliquez sur Add a permission (Ajouter une autorisation).

  7. Sélectionnez Microsoft Graph> Autorisations déléguées.

  8. Dans la section Sélectionner des autorisations, sélectionnez l'autorisation requise suivante :

    • User.Read
  9. Cliquez sur Ajouter des autorisations.

  10. Sur la page API Permissions (Autorisations des API), cliquez sur Add a permission (Ajouter une autorisation).

  11. Sélectionnez WindowsDefenderATP > Autorisations de l'application.

  12. Dans la section Sélectionner des autorisations, sélectionnez les autorisations requises suivantes :

    • AdvancedQuery.Read.All
    • Alert.Read.All
    • Alert.ReadWrite.All
    • Event.Write
    • File.Read.All
    • Ip.Read.All
    • Machine.Isolate
    • Machine.Read.All
    • Machine.ReadWrite.All
    • Machine.Scan
    • Machine.StopAndQuarantine
    • Ti.ReadWrite
    • Url.Read.All
    • User.Read.All
  13. 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

  1. Accédez à Certificates and secrets>New client secret (Certificats et codes secrets > Nouveau code secret du client).

  2. Fournissez une description pour un code secret du client et définissez sa date d'expiration.

  3. Cliquez sur Ajouter.

  4. Enregistrez la valeur du code secret du client (et non l'ID du secret) pour l'utiliser comme valeur de paramètre Client Secret lors 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)

  1. Dans le volet de navigation, sélectionnez Paramètres > SIEM.

  2. 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 :

  • api-us.securitycenter.windows.com
  • api-eu.securitycenter.windows.com
  • api-uk.securitycenter.windows.com

La valeur par défaut est https://api.securitycenter.windows.com.

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 :

{
    "type": "Command",
    "params": [
        {
            "key": "string",
            "value": "string"
        }
    ]
}
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

Successfully executed command on the following endpoints in Microsoft Defender for Endpoint: ENTITY_ID.

L'action a réussi.

The command didn't complete for the following endpoints in Microsoft Defender for Endpoint: ENTITY_ID.

The scan didn't complete for all of the provided endpoints in Microsoft Defender for Endpoint.

Error executing action "Execute Live Response Command". 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 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"
    }
]

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": []
        }
    ]
}

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 :

  • Hostname

  • IP 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 100.

La valeur par défaut est 100.

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

Successfully returned recommendations for the following endpoints in Microsoft Defender for Endpoint: ENTITY_IDS.

No recommendations were found for the following endpoints in Microsoft Defender for Endpoint: ENTITY_IDS.

No recommendations were found for the provided endpoints in Microsoft Defender for Endpoint.

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

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 :

  • Hostname

  • IP 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 :

  • Critical
  • High
  • Medium
  • Low

La valeur par défaut est Critical.

Threat Filter

Facultatif.

Critères de renseignement sur les menaces utilisés pour filtrer les failles renvoyées.

Les valeurs possibles sont les suivantes :

  • Associated Active Alert
  • Exploit is available
  • Exploit is verified
  • This exploit is part of an exploit kit
Sort By

Facultatif.

Champ utilisé pour trier les failles renvoyées.

Les valeurs possibles sont les suivantes :

  • First Detection Time
  • Severity
  • Update Time

La valeur par défaut est Severity.

Sort Order

Facultatif.

Ordre dans lequel les résultats triés sont affichés.

Les valeurs possibles sont les suivantes :

  • ASC
  • DESC

La valeur par défaut est ASC.

Max Vulnerabilities To Return

Obligatoire.

Nombre maximal de failles à renvoyer pour chaque entité.

La valeur maximale est 100.

La valeur par défaut est 100.

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

Successfully returned vulnerabilities for the following endpoints in Microsoft Defender for Endpoint: ENTITY_IDS.

The action wasn't able to return vulnerabilities for the following endpoints in Microsoft Defender for Endpoint: ENTITY_IDS.

The action wasn't able to return vulnerabilities for the provided endpoints in Microsoft Defender for Endpoint.

No vulnerabilities were found for the following endpoints in Microsoft Defender for Endpoint: ENTITY_IDS.

No vulnerabilities were found for the provided endpoints in Microsoft Defender for Endpoint.

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

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 100.

La valeur par défaut est 100.

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

Successfully returned alerts related to the following users in Microsoft Defender for Endpoint: ENTITY_IDS.

No alerts were related to the following users in Microsoft Defender for Endpoint: ENTITY_IDS.

No alerts were related to the provided users in Microsoft Defender for Endpoint.

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 :

  • Complète
  • Sélective
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 :

  • Complète
  • Rapide
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 :

  • Bloquer
  • Audit
  • Bloquer et corriger
  • Autoriser
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 :

  • Élevée
  • Moyen
  • Faible
  • Informatif
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 :

  • Nouveau
  • InProgress
  • Résolu
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 :

  • Inconnu
  • FalsePositive
  • TruePositive
Non Spécifiez la classification avec laquelle mettre à jour l'alerte.
Détermination LDD

NotAvailable

Valeurs possibles :

  • NotAvailable
  • Apt
  • Logiciels malveillants
  • SecurityPersonnel
  • SecurityTesting
  • UnwantedSoftware
  • Autre
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 assignedTo ou définir l'état de l'alerte sur inProgress).

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 :

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 Environment Field Name.

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 :

  • api-us.securitycenter.windows.com
  • api-eu.securitycenter.windows.com
  • api-uk.securitycenter.windows.com
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 :

  1. Connectez-vous au portail Azure en tant qu'administrateur d'utilisateurs ou administrateur de mots de passe.

  2. Sélectionnez Microsoft Entra ID.

  3. Accédez à API Permissions> Add a permission> APIs my organization uses (Autorisations d'API > Ajouter une autorisation > API utilisées par mon organisation).

  4. Sélectionnez Microsoft Threat Protection > Application permissions (Microsoft Threat Protection > Autorisations de l'application).

  5. Dans la section Sélectionner des autorisations, sélectionnez les autorisations requises suivantes :

    • Incident.Read.All
    • Incident.ReadWrite.All
  6. Cliquez sur Ajouter des autorisations.

  7. 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 Environment Field Name.

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 :

  • api-us.securitycenter.windows.com
  • api-eu.securitycenter.windows.com
  • api-uk.securitycenter.windows.com
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.