Microsoft Defender pour le cloud

Ce document explique comment intégrer Microsoft Defender pour le cloud à Google Security Operations.

Cas d'utilisation

  1. Ingérez des alertes de sécurité dans Google SecOps pour les examiner.

  2. Mettre à jour les alertes.

  3. Récupérez des informations sur la conformité aux normes.

Prérequis

Avant de configurer l'intégration dans la plate-forme Google SecOps, veillez à accorder les autorisations requises au compte utilisateur Azure et à configurer une authentification par mot de passe ou une authentification OAuth.

Configurer les autorisations

Cette intégration nécessite un accès délégué aux ressources Azure. Veillez à accorder les autorisations requises suivantes au compte utilisateur Azure utilisé pour configurer l'intégration :

  1. Le compte utilisateur doit être un membre actif pour les rôles Azure suivants :

    • Security Reader
    • Security Admin
  2. Au niveau de l'abonnement Azure, veillez à attribuer à l'utilisateur le rôle IAM suivant : Management Group Reader.

Configurer l'authentification par mot de passe

Pour configurer l'authentification par mot de passe pour Microsoft Defender pour le cloud, procédez comme suit :

  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.

  4. Utilisez l'ID de votre abonnement Azure comme valeur pour le paramètre d'intégration correspondant.

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 (Autorisations d'API > Ajouter une autorisation).

  2. Sélectionnez Azure Service Management> Autorisations déléguées.

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

    • user_impersonation
  4. Sélectionnez Microsoft Graph> Autorisations déléguées.

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

    • SecurityEvents.Read.All
    • SecurityEvents.ReadWrite.All
    • User.Read
  6. Sélectionnez Microsoft Graph> Autorisations de l'application.

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

    • SecurityEvents.Read.All
    • SecurityEvents.ReadWrite.All
  8. Cliquez sur Ajouter des autorisations.

  9. Cliquez sur Accorder le consentement administrateur pour YOUR_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).

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.

Configurer l'intégration avec l'ID d'abonnement Azure

  1. Dans Microsoft Defender pour le cloud, accédez à l'onglet Overview (Présentation).

  2. Cliquez sur Abonnements Azure.

  3. Copiez la valeur de l'ID d'abonnement Azure et saisissez-la dans le paramètre Subscription ID lors de la configuration des paramètres d'intégration.

Configurer l'authentification OAuth

Pour configurer l'authentification OAuth pour Microsoft Defender pour le cloud, procédez comme suit :

  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.

  4. Utilisez l'ID de votre abonnement Azure comme valeur pour le paramètre d'intégration correspondant.

Créer une application Microsoft Entra

Pour créer une application et emprunter l'identité de l'utilisateur choisi, procédez comme suit :

  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. Sélectionnez les types de comptes compatibles appropriés.

  6. Pour l'URL de redirection, indiquez la valeur suivante : http://localhost.

  7. Cliquez sur S'inscrire.

  8. Enregistrez les valeurs ID (client) de l'application et ID (de locataire) du répertoire pour les utiliser ultérieurement afin de configurer l'intégration.

Configurer les autorisations de l'API

  1. Accédez à API Permissions> Add a permission (Autorisations d'API > Ajouter une autorisation).

  2. Sélectionnez Azure Service Management> Autorisations déléguées.

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

    • user_impersonation
  4. Sélectionnez Microsoft Graph> Autorisations déléguées.

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

    • SecurityEvents.Read.All
    • SecurityEvents.ReadWrite.All
    • User.Read
  6. Sélectionnez Microsoft Graph> Autorisations de l'application.

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

    • SecurityEvents.Read.All
    • SecurityEvents.ReadWrite.All
  8. Cliquez sur Ajouter des autorisations.

  9. Cliquez sur Accorder le consentement administrateur pour YOUR_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).

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.

Configurer l'intégration avec l'ID d'abonnement Azure

  1. Dans Microsoft Defender pour le cloud, accédez à l'onglet Overview (Présentation).

  2. Cliquez sur Abonnements Azure.

  3. Copiez la valeur de l'ID d'abonnement Azure et saisissez-la dans le paramètre Subscription ID lors de la configuration de l'intégration.

Configurer l'authentification OAuth dans Google SecOps

Pour configurer l'authentification OAuth pour Microsoft Defender pour le cloud dans la plate-forme Google SecOps, procédez comme suit :

  1. Configurez les paramètres d'intégration et enregistrez-les.

  2. Générez un jeton d'actualisation :

    • Facultatif : simulez un cas dans Google SecOps.

    • Exécutez manuellement l'action Obtenir le code d'autorisation OAuth.

    • Exécutez manuellement l'action Générer un jeton.

  3. Saisissez le jeton d'actualisation obtenu comme valeur du paramètre Refresh Token, puis enregistrez la configuration.

Configurer les paramètres d'intégration

Dans Google SecOps, configurez les paramètres d'intégration avec les valeurs d'ID client, de code secret du client, d'ID de locataire et d'ID d'abonnement que vous avez obtenues lors des étapes précédentes.

Générer un jeton d'actualisation

Pour générer un jeton d'actualisation, vous devez effectuer des actions manuelles sur une demande existante. Si votre instance Google SecOps est nouvelle et ne comporte aucune demande, simulez-en une.

Simuler un cas

Pour simuler une demande dans Google SecOps, procédez comme suit :

  1. Dans le menu de navigation de gauche, sélectionnez Demandes.

  2. Sur la page "Cas", cliquez sur add > Simuler des cas.

  3. Sélectionnez l'un des cas par défaut, puis cliquez sur Créer. Le cas que vous choisissez de simuler n'a pas d'importance.

  4. Cliquez sur Simuler.

    Si vous disposez d'un environnement autre que celui par défaut et que vous souhaitez l'utiliser, sélectionnez l'environnement approprié, puis cliquez sur Simuler.

  5. Dans l'onglet Demandes, cliquez sur Actualiser. Le cas que vous avez simulé apparaît dans la liste des cas.

Exécuter l'action "Obtenir un code d'autorisation OAuth"

Utilisez la demande Google SecOps que vous avez simulée ou une demande existante pour exécuter manuellement l'action Get OAuth Authorization Code (Obtenir le code d'autorisation OAuth).

  1. Dans l'onglet Cas, sélectionnez votre cas simulé pour ouvrir une vue du cas.

  2. Cliquez sur Action manuelle.

  3. Dans le champ Rechercher de l'action manuelle, saisissez Azure Security Center.

  4. Dans les résultats sous l'intégration d'Azure Security Center, sélectionnez Get OAuth Authorization Code (Obtenir le code d'autorisation OAuth). Cette action renvoie un lien d'autorisation utilisé pour se connecter de manière interactive à l'application Microsoft Entra.

  5. Dans le champ du paramètre Redirect URL, saisissez l'URL que vous avez utilisée lors de la création de l'application Microsoft Entra.

  6. Cliquez sur Exécuter.

  7. Une fois l'action exécutée, accédez au mur des cas de votre cas simulé. Dans l'enregistrement d'action Azure Security Center_Get OAuth Authorization Code, cliquez sur Afficher plus et copiez le lien d'autorisation.

  8. Ouvrez une nouvelle fenêtre de navigateur en mode navigation privée et collez l'URL d'autorisation générée. La page de connexion Azure s'ouvre.

  9. Connectez-vous avec les identifiants utilisateur que vous avez sélectionnés pour l'intégration. Une fois connecté, votre navigateur doit être redirigé avec un code dans la barre d'adresse.

    Voici un exemple d'URL obtenue avec le code :

    http://localhost/?code=0.ATwAylKP1BpbCEeO0Ou5iiakalBV.......nIAA&state=12345&session_state=28084547-3dea-449a-8b4c-c1671342a39d#
    
  10. Dans l'URL, copiez la partie du code d'accès qui suit http://localhost/?code=. Vous avez besoin de ce code d'accès pour exécuter l'action Obtenir un jeton d'actualisation OAuth.

Exécuter l'action "Obtenir un jeton d'actualisation OAuth"

Utilisez la demande Google SecOps que vous avez simulée pour exécuter manuellement l'action Get OAuth Refresh Token (Obtenir un jeton d'actualisation OAuth).

  1. Dans l'onglet Cas, sélectionnez votre cas simulé pour ouvrir une vue du cas.

  2. Cliquez sur Action manuelle.

  3. Dans le champ Rechercher de l'action manuelle, saisissez Azure Security Center.

  4. Dans les résultats de l'intégration d'Azure Security Center, sélectionnez Get OAuth Refresh Token (Obtenir un jeton d'actualisation OAuth).

  5. Dans le champ du paramètre Authorization Code, saisissez le code d'accès que vous avez obtenu après avoir exécuté l'action Obtenir le code d'autorisation OAuth.

  6. Cliquez sur Exécuter.

  7. Une fois l'action exécutée, accédez au mur des cas de votre cas simulé. Dans l'enregistrement d'action Azure Security Center_Get OAuth Refresh Token, cliquez sur View More (Afficher plus).

  8. Copiez l'intégralité de la valeur du jeton d'actualisation généré.

Configurer le paramètre "Refresh Token" (Jeton d'actualisation)
  1. Accédez à la boîte de dialogue de configuration de l'intégration d'Azure Security Center.

  2. Saisissez la valeur du jeton d'actualisation de l'étape précédente dans le champ Refresh Token (Jeton d'actualisation).

  3. Cliquez sur Enregistrer.

Intégrer Microsoft Defender pour le cloud à Google SecOps

Pour obtenir des instructions détaillées sur la configuration d'une intégration dans Google SecOps, consultez Configurer des intégrations.

Entrées d'intégration

Utilisez les paramètres suivants pour configurer l'intégration :

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
ID client Chaîne N/A Oui ID client de l'application Microsoft Entra.
Code secret du client Mot de passe N/A Oui Code secret du client de l'application Microsoft Entra.
Nom d'utilisateur Chaîne N/A Non Nom d'utilisateur du compte Microsoft Entra.
Mot de passe Mot de passe N/A Non Mot de passe du compte Microsoft Entra.
ID d'abonnement Chaîne N/A Oui

ID de l'abonnement pour lequel vous souhaitez demander des informations.

Remarque : Si l'ID d'abonnement est fourni au niveau de l'intégration et de l'action, la priorité est donnée à la configuration de l'action.

ID du locataire Chaîne N/A Oui ID de locataire de l'application Microsoft Entra.
Jeton d'actualisation Mot de passe N/A Oui Jeton d'actualisation pour l'autorisation OAuth.
Vérifier le protocole SSL Case à cocher Décochée Oui Si cette option est activée, elle vérifie que le certificat SSL de la connexion au serveur Microsoft Defender pour le cloud est valide.

Actions

Obtenir un code d'autorisation OAuth

Générez un code d'autorisation OAuth pour obtenir un jeton d'actualisation.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
URL de redirection Chaîne https://localhost Oui Spécifiez l'URL de redirection utilisée lors de la création de l'application Microsoft Entra.

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
is_success is_success=False
is_success is_success=True
Mur des cas
Type de résultat Valeur/Description Type (Entity \ General)
Message de sortie* L'action ne doit pas échouer ni arrêter l'exécution d'un playbook : "Successfully generated Authorization code URL in Azure Security Center. Veuillez la copier et la coller dans le navigateur. Ensuite, copiez la partie "code" de l'URL. Ce code d'autorisation est utilisé dans l'action "Obtenir un jeton d'actualisation OAuth". ". Général
Lien

Nom : Lien vers le code d'autorisation
URL : {generated link}

Obtenir un jeton d'actualisation OAuth

Générez le jeton d'actualisation nécessaire à la configuration de l'intégration. Le code d'autorisation peut être généré à l'aide de l'action Obtenir un code d'autorisation OAuth.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
URL de redirection Chaîne https://localhost Oui Spécifiez l'URL de redirection utilisée lors de la création de l'application.
Code d'autorisation Chaîne Oui Spécifiez le code d'autorisation de l'action "Obtenir le code d'autorisation OAuth".

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
is_success is_success=False
is_success is_success=True
Résultat JSON
{
    "token_type": "Bearer",
    "scope": "user_impersonation",
    "expires_in": "3599",
    "ext_expires_in": "3599",
    "expires_on": "1628514482",
    "not_before": "1628510582",
    "resource": "https://management.azure.com",
    "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsIng1dCI6Im5PbzNaRH",
    "refresh_token": "0.ATwAylKP1BpbCEeO0Ou5iiakalBVs4hy5YpMhS4OVguFb9Y8AGw",
    "id_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJub25lIn0.eyJhdWQiOiI4OGIzNTU1MC1"
}
Mur des cas
Type de résultat Valeur/Description Type (Entity \ General)
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si le code d'état 200 est renvoyé (is_success = true) : "Successfully generated refresh token in Azure Security Center." (Le jeton d'actualisation a bien été généré dans Azure Security Center).

L'action doit échouer et arrêter l'exécution d'un playbook :

En cas d'erreur fatale (identifiants incorrects, aucune connexion au serveur, etc.) : "Error executing action "Get OAuth Refresh Token". Reason: {0}''.format(error.Stacktrace)

Si le code d'état n'est pas 200 : "Erreur lors de l'exécution de l'action "Obtenir le jeton d'actualisation OAuth". Reason: {0}''.format(error_description)

Général

Répertorier les normes réglementaires

Répertorier les normes réglementaires disponibles dans Microsoft Defender pour le cloud.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
ID d'abonnement Chaîne N/A Non

Spécifiez l'ID de l'abonnement pour lequel vous souhaitez interroger des informations.

Remarque : Si l'ID d'abonnement est fourni au niveau de l'intégration et de l'action, la priorité est donnée à la configuration de l'action.

Filtre par état CSV Échec Non

Spécifiez la liste des états séparés par une virgule. Exemple : Failed, Skipped. Seules les normes dont l'état correspond seront renvoyées. Par exemple, si vous spécifiez "Échec", l'action ne renverra que les normes ayant échoué.

Valeurs possibles : Passed,Failed,Unsupported,Skipped

Nombre maximal de normes à renvoyer Chaîne 50 Non Spécifiez le nombre de normes à 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
is_success is_success=False
is_success is_success=True
Résultat JSON
{
    "value": [
        {
            "id": "/subscriptions/a052d33b-b7c4-4dc7-9e17-5c89ea594669/providers/Microsoft.Security/regulatoryComplianceStandards/Azure-CIS-1.1.0",
            "name": "Azure-CIS-1.1.0",
            "type": "Microsoft.Security/regulatoryComplianceStandards",
            "properties": {
                "state": "Failed",
                "passedControls": 21,
                "failedControls": 3,
                "skippedControls": 0,
                "unsupportedControls": 87
            }
        }
    ]
}
Mur des cas
Type de résultat Valeur/Description Type (Entity \ General)
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si le code d'état est 200 et que nous disposons de données après le filtrage : "Successfully retrieved regulatory controls for the provided standards in Microsoft Azure Security Center" (Les contrôles réglementaires pour les normes fournies ont bien été récupérés dans Microsoft Azure Security Center)

Si le code d'état est 200 et qu'aucune donnée n'est disponible après le filtrage : "Aucune norme réglementaire n'a été trouvée dans Microsoft Azure Security Center"

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale ou une erreur du SDK est signalée (par exemple, des identifiants incorrects, l'absence de connexion au serveur, etc.) : "Error executing action "List Regulatory Standards". Reason: {0}''.format(error.Stacktrace)

Si le filtre d'état contient des valeurs non valides : "Error executing action "List Regulatory Standards". Motif : Le paramètre "Filtre d'état" ne doit contenir que les valeurs suivantes : "Réussi", "Échec", "Ignoré", "Non compatible".

Général
Tableau du mur des cas

Nom : Normes réglementaires

Colonne :

  • Nom
  • État
  • Contrôles réussis
  • Contrôles ayant échoué
  • Contrôles ignorés
  • Contrôles non compatibles
Général

Lister les contrôles des normes réglementaires

Répertoriez les contrôles disponibles liés aux normes dans Microsoft Defender pour le cloud.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
ID d'abonnement Chaîne N/A Non

Spécifiez l'ID de l'abonnement pour lequel vous souhaitez interroger des informations.

Remarque : Si l'ID d'abonnement est fourni au niveau de l'intégration et de l'action, la priorité est donnée à la configuration de l'action.

Noms standards CSV Oui Spécifiez une liste de noms de normes pour lesquelles vous souhaitez récupérer des détails, séparés par une virgule. Exemple : Azure-CIS-1.1.0
Filtre par état CSV Échec Non

Spécifiez la liste des états séparés par une virgule. Exemple : Failed, Skipped. Seuls les contrôles dont l'état correspond seront renvoyés. Par exemple, si vous spécifiez "Échec", l'action ne renverra que les contrôles ayant échoué.

Valeurs possibles : Passed,Failed,Unsupported,Skipped

Nombre maximal de contrôles à renvoyer Chaîne 50 Non Spécifiez le nombre de contrôles à renvoyer par norme.

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
is_success is_success=False
is_success is_success=True
Résultat JSON
{
    "results": [
      "Name": "{Standard_name}",
      "Controls":
[
        {
            "id": "/subscriptions/a052d33b-b7c4-4dc7-9e17-5c89ea594669/providers/Microsoft.Security/regulatoryComplianceStandards/Azure-CIS-1.1.0",
            "name": "Azure-CIS-1.1.0",
            "type": "Microsoft.Security/regulatoryComplianceStandards",
            "properties": {
                "state": "Failed",
                "passedControls": 21,
                "failedControls": 3,
                "skippedControls": 0,
                "unsupportedControls": 87
            }
        }
    ]
}
Mur des cas
Type de résultat Valeur/Description Type (Entity \ General)
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si le code d'état est 200 et qu'après le filtrage, nous disposons de données pour au moins une norme(is_success = true) : "Successfully retrieved regulatory controls for the following standards in Microsoft Azure Security Center:\n {0}".format(standard)

Si l'action échoue pour une norme(is_success = true) : "Action wasn't able to retrieve regulatory controls for the following standards in Microsoft Azure Security Center:\n {0}".format(standard)

Si aucune donnée n'est trouvée pour certaines normes après le filtrage (is_success=true) : "No regulatory controls were found for the following standards in Microsoft Azure Security Center:\n {0}".format(standard)

Si aucune donnée n'est trouvée pour toutes les normes en fonction des filtres : "Aucun contrôle réglementaire n'a été trouvé pour les normes fournies."

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale ou une erreur de SDK (par exemple, des identifiants incorrects, l'absence de connexion au serveur, etc.) est signalée : "Error executing action "List Regulatory Standard Controls". Reason: {0}''.format(error.Stacktrace)

Si le filtre d'état contient des valeurs non valides : "Error executing action "List Regulatory Standard Controls". Motif : Le paramètre "Filtre d'état" ne doit contenir que les valeurs suivantes : "Réussi", "Échec", "Ignoré", "Non compatible".

Général
Tableau du mur des cas

Nom de la table : "Regulatory Controls: {0}".format(Standard)

Colonne :

  • Nom
  • État
  • Description
  • Évaluations réussies
  • Évaluations ayant échoué
  • Évaluations ignorées
Général

Ping

Testez la connectivité à Microsoft Defender for Cloud avec les paramètres fournis sur la page de configuration de l'intégration dans la page Google SecOps Content Hub.

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
is_success is_success=False
is_success is_success=True
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 l'opération réussit : "Successfully connected to the Azure Security Center server with the provided connection parameters!" (Connexion au serveur Azure Security Center réussie avec les paramètres de connexion fournis)

L'action doit échouer et arrêter l'exécution d'un playbook :

En cas d'échec : "Failed to connect to the Azure Security Center server! Error is {0}".format(exception.stacktrace)

Général

Mettre à jour l'état de l'alerte

Mettez à jour l'état de l'alerte dans Microsoft Defender pour le cloud.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
ID d'abonnement Chaîne N/A Non

Spécifiez l'ID de l'abonnement pour lequel vous souhaitez interroger des informations.

Remarque : Si l'ID d'abonnement est fourni au niveau de l'intégration et de l'action, la priorité est donnée à la configuration de l'action.

ID d'alerte Chaîne N/A Oui Spécifiez l'ID de l'alerte dont vous souhaitez mettre à jour l'état.
Emplacement Chaîne N/A Oui Spécifiez l'emplacement de l'alerte. Exemple : centralus.
État LDD

Résoudre

Valeurs possibles :

  • Ignorer
  • Réactiver
  • Résoudre
Oui Spécifiez l'état de l'alerte.

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
is_success is_success=False
is_success is_success=True
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 est 204 (is_success = true) : "Successfully {0} alert with ID {1} in Microsoft Azure Security Center:\n {0}".format(dismissed/resolved/reactivated, alert_id)

Si "errors" est présent dans la réponse (is_success = false) : "L'action n'a pas pu {0} l'alerte avec l'ID {1} dans Microsoft Azure Security Center. Reason: {2}".format(dismiss/resolve/reactivate, alert_id, errors/message)

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale ou une erreur du SDK est signalée (par exemple, des identifiants incorrects, l'absence de connexion au serveur, etc.) : "Error executing action "Update Alert Status". Reason: {0}''.format(error.Stacktrace)

Général

Connecteurs

Pour obtenir des instructions détaillées sur la configuration d'un connecteur dans Google SecOps, consultez Configurer le connecteur.

Azure Security Center – Connecteur d'alertes de sécurité

Extraire les alertes de sécurité de Microsoft Defender pour le cloud.

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 Nom du produit Oui Saisissez le nom du champ source pour récupérer le nom du champ produit.
Nom du champ d'événement Chaîne resourceType Oui Saisissez le nom du champ source pour récupérer le nom du champ d'événement.
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 n'est pas trouvé, l'environnement par défaut est utilisé.

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 "Nom du champ d'environnement".

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 est l'environnement par défaut.

Délai avant expiration du script (en secondes) Entier 180 Oui Délai avant expiration du processus Python exécutant le script actuel.
ID client Chaîne N/A Vrai ID client de l'application Microsoft Entra.
Code secret du client Mot de passe N/A Vrai Code secret du client de l'application Microsoft Entra.
Nom d'utilisateur Chaîne N/A Vrai Nom d'utilisateur du compte Microsoft Entra.
Mot de passe Mot de passe N/A Vrai Mot de passe du compte Microsoft Entra.
ID d'abonnement Chaîne N/A Vrai ID d'abonnement de l'application Microsoft Entra
ID du locataire Chaîne N/A Vrai ID de locataire de l'application Microsoft Entra.
Gravité la plus faible à récupérer Chaîne Faible

Niveau de gravité le plus faible qui sera utilisé pour récupérer l'alerte.

Valeurs possibles : Faible, Moyen, Élevé

Nombre maximal d'alertes à récupérer Integer 50 Non Nombre d'alertes à traiter par itération de connecteur.
Nombre maximal d'heures en arrière Entier 1 Non Nombre d'heures dans le passé à partir desquelles récupérer les alertes.
Utiliser la liste d'autorisation comme liste de blocage Case à cocher Décochée Oui Si cette option est activée, la liste dynamique sera utilisée comme liste de blocage.
Vérifier le protocole SSL Case à cocher Décochée Oui Si cette option est activée, vérifiez que le certificat SSL de la connexion au serveur Microsoft Defender pour le cloud est valide.
Adresse du serveur proxy Chaîne N/A Non Adresse du serveur proxy à utiliser.
Nom d'utilisateur du proxy Chaîne N/A Non Nom d'utilisateur du proxy pour l'authentification.
Mot de passe du proxy Mot de passe N/A Non Mot de passe du proxy pour l'authentification.
Jeton d'actualisation Mot de passe N/A Non Jeton d'actualisation pour l'autorisation OAuth.

Règles du connecteur

Assistance de proxy

Le connecteur est compatible avec les proxys.

Jobs

Pour configurer des jobs dans Google SecOps, accédez à Réponse > Planificateur de jobs.

Job de renouvellement du jeton d'actualisation

L'objectif du job de renouvellement du jeton d'actualisation est de mettre à jour régulièrement le jeton d'actualisation utilisé dans l'intégration.

Par défaut, le jeton d'actualisation expire tous les 90 jours, ce qui rend l'intégration inutilisable à l'expiration. Il est recommandé d'exécuter ce job tous les 7 ou 14 jours pour vous assurer que le jeton d'actualisation est à jour.

Entrées de job

Pour configurer le job, utilisez les paramètres suivants :

Paramètres
Environnements d'intégration Optional

Environnements d'intégration pour lesquels le job met à jour les jetons d'actualisation.

Ce paramètre accepte plusieurs valeurs sous forme de chaîne d'éléments séparés par une virgule. Placez les valeurs individuelles entre guillemets (" ").

Noms des connecteurs Optional

Noms des connecteurs pour lesquels le job met à jour les jetons d'actualisation.

Ce paramètre accepte plusieurs valeurs sous forme de chaîne d'éléments séparés par une virgule. Placez les valeurs individuelles entre guillemets (" ").

Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.