Intégrer l'API Azure à Google SecOps

Ce document explique comment intégrer l'API Azure à Google Security Operations.

Cas d'utilisation

L'intégration de l'API Azure utilise les fonctionnalités de Google SecOps pour prendre en charge les cas d'utilisation suivants :

  • Investigation universelle Microsoft 365 : utilisez la fonctionnalité de requête HTTP personnalisée pour interroger n'importe quel point de terminaison Microsoft Graph, ce qui permet aux analystes de collecter des données sur Teams, SharePoint et Exchange à partir d'une seule interface.

  • Correction personnalisée des incidents : exécutez des requêtes POST ou PATCH ciblées pour corriger les menaces dans les services Azure lorsqu'une action dédiée en un clic n'est pas disponible, ce qui garantit une réponse rapide aux nouvelles failles.

  • Ingestion automatisée des données : effectuez une ingestion planifiée des événements de sécurité et des journaux d'audit à partir de différents dépôts Azure pour maintenir une visibilité complète sur l'environnement cloud.

  • Gestion sécurisée des logiciels malveillants : téléchargez et analysez des fichiers suspects en toute sécurité à l'aide de la fonctionnalité d'archivage ZIP intégrée protégée par mot de passe, qui empêche l'exécution accidentelle de contenus malveillants.

  • Gestion de l'authentification persistante : utilisez le job de renouvellement des jetons d'actualisation pour effectuer une rotation automatique des jetons OAuth 2.0, ce qui permet aux playbooks automatisés et aux jobs de recherche de conserver un accès sécurisé et ininterrompu aux services Microsoft 365.

Avant de commencer

Avant de configurer l'intégration dans Google SecOps, vérifiez que vous disposez des éléments suivants :

  • Application Microsoft Entra ID : application enregistrée sur le portail Microsoft Entra ID pour faciliter la communication avec l'API.

  • ID client et code secret du client : identifiants valides générés à partir de l'enregistrement de votre application.

  • ID du locataire : identifiant unique de votre instance Azure Active Directory.

  • URL de redirection : URI de redirection configuré qui correspond à celui fourni dans les paramètres d'intégration.

  • Autorisations d'API (champs d'application) : autorisations spécifiques attribuées à votre application en fonction des services Azure que vous souhaitez interroger.

  • Jeton d'actualisation : jeton valide pendant 90 jours, requis pour l'accès délégué persistant.

  • Job de renouvellement des jetons d'actualisation : automatisation de sécurité essentielle utilisée pour éviter les échecs d'intégration dus à l'expiration des jetons.

Configuration de l'authentification de l'API Azure

L'intégration de l'API Azure est compatible avec deux types d'authentification. L'ensemble d'autorisations requis dépend des requêtes API et des services Azure spécifiques que vous interrogez.

  • Autorisations d'application : les requêtes API sont exécutées du point de vue de l'application configurée dans Microsoft Entra ID. Cette configuration ne nécessite qu'un ID client et un code secret du client.

  • Autorisations déléguées : les requêtes API sont exécutées au nom d'un utilisateur spécifique pour lequel l'emprunt d'identité est configuré.

Établir l'authentification déléguée

Pour utiliser des autorisations déléguées, vous devez générer manuellement un jeton d'actualisation initial en procédant comme suit :

  1. Indiquez les valeurs Client ID, Client Secret, Scope, Redirect URL et Tenant ID dans la configuration de l'intégration.

  2. Exécutez l'action Obtenir l'autorisation.

  3. Ouvrez le lien généré par l'action dans un navigateur et copiez le lien de redirection obtenu.

  4. Fournissez le lien redirigé en tant qu'entrée de l'action Générer un jeton.

  5. Copiez le jeton renvoyé par l'action et saisissez-le dans Refresh Token lors de la configuration de l'intégration.

Configurer le renouvellement des jetons d'actualisation

Le jeton d'actualisation initial est valable pendant 90 jours. Pour assurer la continuité du service, configurez le job de renouvellement du jeton d'actualisation afin de mettre à jour automatiquement le jeton d'actualisation de l'instance d'intégration.

Paramètres d'intégration

L'intégration de l'API Azure nécessite les paramètres suivants :

Paramètre Description
Microsoft Login API Root

Obligatoire.

Racine de l'API du service de connexion de la plate-forme d'identité Microsoft utilisée pour l'authentification de l'API Azure.

La valeur par défaut est https://login.microsoftonline.com.
Microsoft Graph API Root

Obligatoire.

Racine de l'API du service Microsoft Graph utilisée pour les opérations de l'API Azure.

La valeur par défaut est https://graph.microsoft.com.
Client ID

Obligatoire.

ID client du compte API Azure.
Client Secret

Obligatoire.

Code secret du client pour le compte d'API Azure.
Tenant ID

Obligatoire.

ID de locataire du compte d'API Azure.
Refresh Token

Facultatif.

Jeton d'actualisation utilisé pour l'accès délégué au compte de l'API Azure.

Ce jeton est valide pendant 90 jours et est obtenu lors de la configuration initiale.
Verify SSL

Facultatif.

Si cette option est sélectionnée, l'intégration valide le certificat SSL lors de la connexion au serveur d'API Azure.

Cette option est activée par défaut.
Redirect URL

Facultatif.

URI de redirection associé à l'application Microsoft Entra ID.

La valeur par défaut est http://localhost.
Test URL

Obligatoire.

URL utilisée pour valider l'authentification auprès de l'API Azure à l'aide d'une requête GET.
Scopes

Obligatoire.

Liste des niveaux d'accès pour l'authentification de l'API Azure, séparés par une virgule.

Pour savoir comment configurer une intégration dans Google SecOps, consultez Configurer des intégrations.

Vous pourrez apporter des modifications ultérieurement si nécessaire. Après avoir configuré une instance d'intégration, vous pouvez l'utiliser dans des playbooks. Pour en savoir plus sur la configuration et la prise en charge de plusieurs instances, consultez Prendre en charge plusieurs instances.

Actions

Pour en savoir plus sur les actions, consultez Répondre aux actions en attente depuis votre bureau et Exécuter une action manuelle dans votre demande.

Exécuter une requête HTTP

Utilisez l'action Exécuter une requête HTTP pour créer et exécuter une requête API HTTP personnalisée sur une URL cible.

Cette action ne s'exécute pas sur les entités Google SecOps.

Comportement de l'action

Cette action accepte des comportements complexes, y compris l'interrogation asynchrone, la construction de charges utiles dynamiques et la gestion de fichiers.

Interrogation asynchrone

Lorsque Expected Response Values est fourni, l'action s'exécute en mode asynchrone. Dans ce mode, l'action interroge de manière répétée le point de terminaison cible pour suivre l'état d'une réponse (par exemple, en attendant qu'une tâche de longue durée se termine).

L'action évalue le corps de la réponse par rapport aux conditions JSON fournies dans le paramètre et poursuit l'exécution jusqu'à ce que les conditions soient remplies ou que l'action atteigne son délai avant expiration.

Logique de condition

L'action accepte la logique suivante pour le suivi des états de réponse :

  • Correspondance d'un seul champ : l'action attend qu'un champ spécifique atteigne une valeur unique.

    {
  "state": "finished"
}

  • Plusieurs valeurs (logique OU) : l'action arrête l'exécution si un champ correspond à l'une des valeurs d'une liste fournie. Cela est utile pour s'arrêter à la fois sur les états "réussite" et "erreur" afin d'éviter les interrogations inutiles.

    {
  "state": ["finished", "error"]
}

  • Plusieurs champs (logique ET) : l'action attend que tous les champs spécifiés correspondent simultanément à leurs valeurs respectives.

    {
  "state": "finished",
  "percentage": "100"
}

  • Logique combinée : vous pouvez combiner plusieurs conditions dans l'objet JSON.

    {
  "state": ["finished", "error"],
  "percentage": "10"
}
Comportement de l'analyse JSON

Lors de l'évaluation des conditions, l'action suit les règles suivantes :

  • Recherche globale : l'action recherche les clés spécifiées dans l'ensemble de l'objet de réponse JSON. Indiquez le nom de la clé exactement tel qu'il apparaît dans le fichier JSON, sans ajouter de préfixe ni de nom d'objet parent (par exemple, utilisez "state", et non "data_state" ou "data-state").

  • Plusieurs clés identiques : si la réponse contient plusieurs clés portant le même nom à différents niveaux de la hiérarchie JSON, le résultat attendu n'est atteint que lorsque tous les noms de clés correspondants satisfont à la même valeur attendue.

    Par exemple, pour rechercher l'état finished dans la réponse JSON et ignorer les autres états, définissez toutes les clés state de Expected Response Values sur finished :

    {
"data": {
  "state": "finished"
  },
  "state": "finished"
}
Construction de la charge utile du corps

L'action construit le corps de la requête en fonction de l'en-tête Content-Type fourni dans Headers.

Il s'agit de l'entrée Body Payload utilisée pour les exemples de construction suivants :

{
  "Id": "123123",
  "sorting": "asc"
}

  • application/x-www-form-urlencoded : l'action génère la charge utile en tant que Id=123123&sorting=asc.

  • application/json : l'action génère la charge utile JSON suivante :

    {
  "Id": "123123",
  "sorting": "asc"
}

  • XML : si le produit tiers nécessite du XML, fournissez une entrée au format XML directement dans Body Payload :

    <?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="[http://schemas.xmlsoap.org/soap/envelope/](http://schemas.xmlsoap.org/soap/envelope/)">
<soap:Body>
  <NumberToWords xmlns="[http://www.dataaccess.com/webservicesserver/](http://www.dataaccess.com/webservicesserver/)">
    <ubiNum>500</ubiNum>
  </NumberToWords>
</soap:Body>
</soap:Envelope>
Gestion de fichiers

L'action est compatible avec les workflows suivants pour la gestion des fichiers :

  • Télécharger des fichiers :

    • Pour renvoyer les données du fichier dans le résultat JSON au format base64, sélectionnez Base64 Output.

    • Pour enregistrer un fichier directement dans le Case Wall sous forme d'archive ZIP, sélectionnez Save To Case Wall.

  • Importer des fichiers : pour importer un fichier, convertissez-le en chaîne encodée en base64 et incluez-le dans la valeur Body Payload.

    L'exemple suivant montre un fichier image converti en chaîne encodée en base64 :

    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

  • Sécurité : pour les fichiers sensibles (tels que les logiciels malveillants), sélectionnez Password Protect Zip. Cette commande chiffre automatiquement l'archive ZIP enregistrée créée à l'aide de Save To Case Wall avec le mot de passe infected.

Configuration du bloc de playbook

La configuration suivante montre comment utiliser l'action Exécuter une requête HTTP dans un bloc de playbook. Utilisez cet exemple pour comprendre comment appliquer des espaces réservés et des préfixes d'entrée.

Lorsque vous utilisez des entrées de bloc comme espaces réservés, vous devez inclure le préfixe Input. (par exemple, [Input.comment]).

  • Méthode : PUT

  • Chemin de l'URL :

    https://{API_URL}/[Input.table_name]/[Input.sys_id]

  • En-têtes :

    {
  "Content-type": "application/json; charset=utf-8",
  "Accept": "application/json",
  "User-Agent": "GoogleSecops"
}

  • Charge utile du corps :

    {
  "work_notes": "[Input.comment]"
}

Entrées de l'action

L'action Exécuter une requête HTTP nécessite les paramètres suivants :

Paramètre Description
Method

Facultatif.

Méthode HTTP (verbe) utilisée pour la requête.

Les valeurs possibles sont les suivantes :

  • GET
  • POST
  • PUT
  • PATCH
  • DELETE
  • HEAD
  • OPTIONS

La valeur par défaut est GET.
URL Path

Obligatoire.

Point de terminaison de l'API où la requête s'exécute. Ce chemin d'accès peut éventuellement inclure des paramètres de requête.
URL Params

Facultatif.

Paramètres de requête pour l'URL, fournis sous forme d'objet JSON.

Il s'agit de la méthode de saisie recommandée pour ce paramètre, car ils sont ajoutés à tous les paramètres de requête déjà définis dans URL Path.
Headers

Facultatif.

En-têtes de la requête HTTP, fournis sous forme d'objet JSON.

Les en-têtes contrôlent des aspects tels que l'authentification et définissent le format de Body Payload (à l'aide de Content-Type).
Cookie

Facultatif.

Cookies construits dans l'en-tête HTTP Cookie, fournis sous forme d'objet JSON.

Ce paramètre remplace toutes les valeurs de cookie fournies dans Headers.
Body Payload

Facultatif.

Charge utile de contenu pour la requête HTTP, fournie sous la forme d'un objet JSON.

Le format de la requête (JSON ou form-urlencoded) est déterminé par le Content-Type défini dans Headers.
Expected Response Values

Facultatif.

Objet JSON contenant les paires champ-valeur qui définissent l'état requis du corps de la réponse.
Save To Case Wall

Facultatif.

Si cette option est sélectionnée, l'action enregistre les données de réponse sous forme de fichier et les joint au mur de la demande.

Le fichier est archivé avec l'extension .zip. Ce fichier ZIP n'est pas protégé par un mot de passe, sauf si Password Protect Zip est activé.
Password Protect Zip

Facultatif.

Si cette option est sélectionnée, l'action chiffre l'archive ZIP téléchargée (créée à l'aide de Save To Case Wall) avec un mot de passe (tel que infected).

Utilisez cette option lorsque vous traitez des fichiers suspects ou potentiellement malveillants afin d'éviter toute exécution accidentelle.

Cette option est activée par défaut.
Follow Redirects

Facultatif.

Si cette option est sélectionnée, l'action suit automatiquement toutes les réponses de redirection HTTP (comme les codes d'état 301 ou 302) vers l'URL de destination finale.

Cette option est activée par défaut.
Fail on 4xx/5xx

Facultatif.

Si cette option est sélectionnée, l'action fait explicitement échouer l'étape lorsque la réponse HTTP renvoie un code d'état d'erreur client (4xx) ou d'erreur du serveur (5xx).

Cette option est activée par défaut.
Base64 Output

Facultatif.

Si cette option est sélectionnée, l'action convertit le corps de la réponse HTTP en une chaîne encodée en Base64. Cela est utile pour traiter ou stocker les fichiers téléchargés.

La chaîne encodée ne peut pas dépasser 15 Mo.
Fields To Return

Obligatoire.

Liste de champs séparés par une virgule que l'action renvoie dans la sortie.

Les valeurs possibles sont les suivantes :

  • response_data
  • redirects
  • response_code
  • response_cookies
  • response_headers
  • apparent_encoding

La valeur par défaut est response_data,redirects,response_code,response_cookies,response_headers,apparent_encoding.
Request Timeout

Obligatoire.

Durée maximale, en secondes, pendant laquelle l'action attend que le serveur envoie des données avant que la requête ne soit annulée.

La valeur par défaut est 120.

Sorties de l'action

L'action Exécuter une requête HTTP fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe du 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 Exécuter une requête HTTP :

{
   "response_data": {
       "data": {
           "relationships": {
               "comment": [
                   {
                       "name": "example_resource_name",
                       "description": "Description of the object to which the comment belongs."
                   },
                   {
                       "name": "example_user_role",
                       "description": "Description of the user role associated with the comment."
                   }
               ]
           }
       }
   },
   "redirects": [],
   "response_code": 200,
   "cookies": {},
   "response_headers": {
       "Content-Type": "application/json",
       "X-Cloud-Trace-Context": "REDACTED_TRACE_ID",
       "Date": "REDACTED_DATE_TIME",
       "Server": "REDACTED_SERVER_NAME",
       "Content-Length": "REDACTED_VALUE"
   },
   "apparent_encoding": "ascii"
}
Messages de sortie

L'action Exécuter une requête HTTP peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully executed API request.

Successfully executed API request, but the status code 4xx_OR_5xx was returned. Please check the request or try again later.

 L'action a réussi.
Failed to execute API request. Error: 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 une requête HTTP :

Nom du résultat du script Valeur
is_success true ou false

Obtenir l'autorisation

Utilisez l'action Obtenir l'autorisation pour lancer le flux OAuth et obtenir un lien contenant le code d'accès requis pour l'authentification déléguée.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Obtenir l'autorisation nécessite les paramètres suivants :

Paramètre Description
Oauth Scopes

Obligatoire.

Liste d'autorisations (champs d'application) séparées par une virgule qui définissent le niveau d'accès pour les jetons d'accès et d'actualisation.

La valeur par défaut est user.read, offline_access.

Sorties de l'action

L'action Obtenir l'autorisation fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe du 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 Non disponible
Messages de sortie Disponible
Résultat du script. Disponible
Messages de sortie

L'action Obtenir l'autorisation peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Authorization URL generated successfully. To obtain a URL with access code,Please navigate to the link below as the user that you want to run the integration with., to get a URL with access code. Provide the URL with the access code should be provided next in the Generate Token action.

 L'action a réussi.
Failed to generate the authorization URL! Error is 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 l'autorisation :

Nom du résultat du script Valeur
is_success true ou false

Générer un jeton

Utilisez l'action Générer un jeton pour obtenir un jeton d'actualisation persistant requis pour l'authentification déléguée.

Ce jeton est généré à l'aide de l'URL d'autorisation reçue de l'action Obtenir l'autorisation.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

L'action Générer un jeton nécessite les paramètres suivants :

Paramètre Description
Authorization URL

Obligatoire.

URL de redirection complète contenant le code d'autorisation reçu de l'action Obtenir l'autorisation. Cette URL permet de demander et de générer le jeton d'actualisation.

Sorties de l'action

L'action Générer un jeton fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe du 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 Non disponible
Messages de sortie Disponible
Résultat du script. Disponible
Messages de sortie

L'action Générer un jeton peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully fetched the refresh token: TOKEN_VALUE. Enter this token in the integration configuration to enable the integration to authenticate with delegated permissions on behalf of the user that performed the configuration steps. Note: We strongly recommend you configure the "Refresh Token Renewal Job" after you generate the initial refresh token so the job automatically renews and keeps the token valid.

 L'action a réussi.
Failed to get the refresh token! Error is 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 Générer un jeton :

Nom du résultat du script Valeur
is_success true ou false

Ping

Utilisez l'action Ping pour tester la connectivité à l'API Azure.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées de l'action

Aucune.

Sorties de l'action

L'action Ping fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe du 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 Ping :

{
    "endpoint": "https://api.example-cloud-provider.com/v1.0/health"
}
Messages de sortie

L'action Ping peut renvoyer les messages de sortie suivants :

Message de sortie Description du message

Successfully tested connectivity.

 L'action a réussi.
Failed to test connectivity. 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 répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Ping :

Nom du résultat du script Valeur
is_success true ou false

Jobs

Pour en savoir plus sur les jobs, consultez Configurer un nouveau job et Planification avancée.

Job de renouvellement du jeton d'actualisation

Utilisez le job de renouvellement du jeton d'actualisation pour mettre à jour régulièrement le jeton d'actualisation configuré pour l'intégration.

Par défaut, le jeton d'actualisation expire tous les 90 jours. Nous vous recommandons de configurer ce job pour qu'il s'exécute automatiquement tous les 7 ou 14 jours afin de maintenir le jeton d'actualisation à jour.

Paramètres du job

Le job de renouvellement du jeton d'actualisation nécessite les paramètres suivants :

Paramètre Description
Integration Environments

Facultatif.

Liste de noms d'environnements d'intégration pour lesquels le job met à jour les jetons d'actualisation, séparés par une virgule.

Chaque nom d'environnement doit être placé entre guillemets doubles.

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