Microsoft Defender pour le cloud
Ce document explique comment intégrer Microsoft Defender pour le cloud à Google Security Operations.
Cas d'utilisation
Ingérez des alertes de sécurité dans Google SecOps pour les examiner.
Mettre à jour les alertes.
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 :
Le compte utilisateur doit être un membre actif pour les rôles Azure suivants :
Security ReaderSecurity Admin
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 :
Créez l'application Microsoft Entra.
Configurez les autorisations de l'API pour votre application.
Créez un code secret du client.
Utilisez l'ID de votre abonnement Azure comme valeur pour le paramètre d'intégration correspondant.
Créer une application Microsoft Entra
Connectez-vous au portail Azure en tant qu'administrateur d'utilisateurs ou administrateur de mots de passe.
Sélectionnez Microsoft Entra ID.
Accédez à Inscriptions d'applications > Nouvelle inscription.
Saisissez le nom de l'application.
Cliquez sur S'inscrire.
Enregistrez les valeurs ID d'application (client) et ID d'annuaire (locataire) pour les utiliser ultérieurement lors de la configuration des paramètres d'intégration.
Configurer les autorisations de l'API
Accédez à API Permissions> Add a permission (Autorisations d'API > Ajouter une autorisation).
Sélectionnez Azure Service Management> Autorisations déléguées.
Dans la section Sélectionner des autorisations, sélectionnez l'autorisation suivante :
user_impersonation
Sélectionnez Microsoft Graph> Autorisations déléguées.
Dans la section Sélectionner des autorisations, sélectionnez les autorisations suivantes :
SecurityEvents.Read.AllSecurityEvents.ReadWrite.AllUser.Read
Sélectionnez Microsoft Graph> Autorisations de l'application.
Dans la section Sélectionner des autorisations, sélectionnez les autorisations suivantes :
SecurityEvents.Read.AllSecurityEvents.ReadWrite.All
Cliquez sur Ajouter des autorisations.
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
Accédez à Certificates and secrets>New client secret (Certificats et codes secrets > Nouveau code secret du client).
Fournissez une description pour un code secret du client et définissez sa date d'expiration.
Cliquez sur Ajouter.
Enregistrez la valeur du code secret du client (et non l'ID du secret) pour l'utiliser comme valeur de paramètre
Client Secretlors de la configuration de l'intégration. La valeur du code secret du client ne s'affiche qu'une seule fois.
Configurer l'intégration avec l'ID d'abonnement Azure
Dans Microsoft Defender pour le cloud, accédez à l'onglet Overview (Présentation).
Cliquez sur Abonnements Azure.
Copiez la valeur de l'ID d'abonnement Azure et saisissez-la dans le paramètre
Subscription IDlors 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 :
Créez l'application Microsoft Entra.
Configurez les autorisations de l'API pour votre application.
Créez un code secret du client.
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 :
Connectez-vous au portail Azure en tant qu'administrateur d'utilisateurs ou administrateur de mots de passe.
Sélectionnez Microsoft Entra ID.
Accédez à Inscriptions d'applications > Nouvelle inscription.
Saisissez le nom de l'application.
Sélectionnez les types de comptes compatibles appropriés.
Pour l'URL de redirection, indiquez la valeur suivante :
http://localhost.Cliquez sur S'inscrire.
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
Accédez à API Permissions> Add a permission (Autorisations d'API > Ajouter une autorisation).
Sélectionnez Azure Service Management> Autorisations déléguées.
Dans la section Sélectionner des autorisations, sélectionnez l'autorisation suivante :
user_impersonation
Sélectionnez Microsoft Graph> Autorisations déléguées.
Dans la section Sélectionner des autorisations, sélectionnez les autorisations suivantes :
SecurityEvents.Read.AllSecurityEvents.ReadWrite.AllUser.Read
Sélectionnez Microsoft Graph> Autorisations de l'application.
Dans la section Sélectionner des autorisations, sélectionnez les autorisations suivantes :
SecurityEvents.Read.AllSecurityEvents.ReadWrite.All
Cliquez sur Ajouter des autorisations.
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
Accédez à Certificates and secrets>New client secret (Certificats et codes secrets > Nouveau code secret du client).
Fournissez une description pour un code secret du client et définissez sa date d'expiration.
Cliquez sur Ajouter.
Enregistrez la valeur du code secret du client (et non l'ID du secret) pour l'utiliser comme valeur de paramètre
Client Secretlors de la configuration de l'intégration. La valeur du code secret du client ne s'affiche qu'une seule fois.
Configurer l'intégration avec l'ID d'abonnement Azure
Dans Microsoft Defender pour le cloud, accédez à l'onglet Overview (Présentation).
Cliquez sur Abonnements Azure.
Copiez la valeur de l'ID d'abonnement Azure et saisissez-la dans le paramètre
Subscription IDlors 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 :
Configurez les paramètres d'intégration et enregistrez-les.
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.
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 :
Dans le menu de navigation de gauche, sélectionnez Demandes.
Sur la page "Cas", cliquez sur add > Simuler des cas.
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.
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.
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).
Dans l'onglet Cas, sélectionnez votre cas simulé pour ouvrir une vue du cas.
Cliquez sur Action manuelle.
Dans le champ Rechercher de l'action manuelle, saisissez
Azure Security Center.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.
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.Cliquez sur Exécuter.
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.
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.
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#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).
Dans l'onglet Cas, sélectionnez votre cas simulé pour ouvrir une vue du cas.
Cliquez sur Action manuelle.
Dans le champ Rechercher de l'action manuelle, saisissez
Azure Security Center.Dans les résultats de l'intégration d'Azure Security Center, sélectionnez Get OAuth Refresh Token (Obtenir un jeton d'actualisation OAuth).
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.Cliquez sur Exécuter.
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).
Copiez l'intégralité de la valeur du jeton d'actualisation généré.
Configurer le paramètre "Refresh Token" (Jeton d'actualisation)
Accédez à la boîte de dialogue de configuration de l'intégration d'Azure Security Center.
Saisissez la valeur du jeton d'actualisation de l'étape précédente dans le champ Refresh Token (Jeton d'actualisation).
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 |
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 :
|
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 :
|
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 :
|
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.