Google Cloud API
Ce document fournit des conseils pour vous aider à configurer et à intégrer l'APIGoogle Cloud à Google Security Operations.
Cas d'utilisation
L'intégration de l'API Google Cloud utilise les fonctionnalités de Google SecOps pour prendre en charge les cas d'utilisation suivants :
Gestion automatisée des ressources : exécutez des actions sur les services Google Cloudtels que Compute Engine ou Cloud Storage pour corriger les menaces ou gérer l'infrastructure de manière dynamique.
Gouvernance des identités et des accès : ajustez de manière programmatique les stratégies ou les rôles Identity and Access Management en réponse aux incidents de sécurité détectés.
Orchestration d'API personnalisée : interagissez avec n'importe quelle API Google Cloud activée qui ne dispose pas d'une intégration dédiée, ce qui offre une flexibilité maximale pour les playbooks complexes.
Authentification sans clé : accédez de manière sécurisée aux ressources Google Cloud à l'aide de Workload Identity pour éliminer les risques associés aux clés de compte de service statiques.
Avant de commencer
Avant de configurer l'intégration dans la plate-forme Google SecOps, vérifiez que vous disposez des éléments suivants :
API cibles activées : identifiez et activez les servicesGoogle Cloud spécifiques que vous prévoyez d'automatiser.
Autorisations IAM : assurez-vous que votre identité dispose des rôles nécessaires pour les actions spécifiques que vous souhaitez effectuer.
Méthode d'authentification : choisissez entre Workload Identity (recommandé) ou une clé JSON de compte de service pour l'authentification.
Identifier et activer les API cibles
Comme cette intégration est une passerelle générique, il n'y a pas d'API fixes. Les exigences dépendent de votre cas d'utilisation spécifique. Vous devez activer les API cibles (telles que Compute Engine, Cloud Storage ou IAM) dans votre projet pour les exécuter via l'intégration.
Pour identifier et activer les API cibles, procédez comme suit :
Dans la console Google Cloud , accédez à API et services > Bibliothèque.
Recherchez et activez les services requis.
Configurer les autorisations IAM
Le compte de service ou l'identité utilisé par cette intégration doit disposer des rôles IAM appropriés.
Principe du moindre privilège : n'accordez que les rôles spécifiques nécessaires aux appels d'API prévus.
Exigences dynamiques : les autorisations varient en fonction de l'opération. Par exemple, la gestion des ressources nécessite des rôles différents de ceux requis pour les lister.
Sélectionnez une méthode d'authentification
Google SecOps accepte deux chemins d'authentification pour cette intégration :
S'authentifier à l'aide de Workload Identity (recommandé)
Workload Identity est la méthode la plus sécurisée, car elle élimine le besoin de gérer ou d'alterner les clés JSON de longue durée. Il utilise l'emprunt d'identité d'un compte de service pour permettre à la plate-forme d'accéder de manière sécurisée à vos ressources.
Identifier l'identité de l'instance Google SecOps
Pour trouver l'identité unique de votre instance, procédez comme suit :
Dans Google SecOps, accédez à Content Hub > Intégrations de réponse.
Sélectionnez l'intégration de l'APIGoogle Cloud .
Saisissez l'adresse e-mail du compte de service cible dans le champ Adresse e-mail Workload Identity.
Cliquez sur Enregistrer, puis sur Tester. Le test devrait échouer.
Cliquez sur close_small à droite de Test et recherchez dans le message d'erreur l'adresse e-mail d'identité commençant par
gke-init-python@...ousoar-python@....Copiez cette adresse e-mail unique.
Accorder des autorisations d'emprunt d'identité
Autorisez l'identité de l'instance à accéder à vos ressources en procédant comme suit :
Dans la console Google Cloud , accédez à IAM et administration > Comptes de service.
Sélectionnez le compte de service cible, puis accédez à Autorisations > Accorder l'accès.
Collez l'adresse e-mail unique dans le champ Nouveaux comptes principaux et attribuez le rôle Créateur de jetons du compte de service (
roles/iam.serviceAccountTokenCreator).
S'authentifier à l'aide d'une clé JSON
N'utilisez cette méthode que si Workload Identity n'est pas disponible dans votre environnement.
Pour authentifier l'intégration à l'aide d'une clé JSON de compte de service, procédez comme suit :
Dans la console Google Cloud , créez un compte de service.
Accédez à l'onglet Clés, puis sélectionnez Ajouter une clé > Créer une clé.
Sélectionnez
JSONcomme type de clé, puis téléchargez le fichier.Copiez l'intégralité du contenu de ce fichier et collez-le dans
Service Account Json File Contentlors de la configuration de l'intégration dans Google SecOps.
Intégrer l'API Google Cloud à Google SecOps SOAR
L'intégration nécessite les paramètres suivants :
| Paramètres | Description |
|---|---|
Test URL |
Optional Une URL de test pour valider l'authentification auprès de l'API Google Cloud . Ce paramètre utilise une requête GET. |
Service Account Json File Content |
Optional Contenu du fichier JSON de la clé du compte de service. Vous pouvez configurer ce paramètre, le paramètre Pour configurer ce paramètre, fournissez l'intégralité du contenu du fichier JSON de la clé de compte de service que vous avez téléchargé lors de la création d'un compte de service. Pour en savoir plus sur l'utilisation de comptes de service comme méthode d'authentification, consultez Présentation des comptes de service et Emprunt d'identité d'un compte de service. Dans cette intégration, l'authentification avec le fichier JSON de clé de compte de service est prioritaire sur l'adresse e-mail Workload Identity. |
Organization ID |
Optional ID d'organisation à utiliser dans l'intégration. Pour récupérer la valeur de ce paramètre lors de l'exécution de l'action, définissez l'espace réservé suivant : |
Project ID |
Optional ID du projet à utiliser dans l'intégration. Pour récupérer la valeur de ce paramètre lors de l'exécution de l'action, définissez l'espace réservé suivant : |
Quota Project ID |
Optional ID du projet Google Cloud que vous utilisez pour les API Google Cloud et la facturation. Ce paramètre nécessite que vous accordiez le rôle L'intégration associe cette valeur de paramètre à toutes les requêtes API. Si vous ne définissez pas de valeur pour ce paramètre, l'intégration récupère l'ID du projet à partir de votre compte de service Google Cloud . |
Workload Identity Email |
Optional Adresse e-mail du client de votre compte de service. Vous pouvez configurer ce paramètre ou le paramètre Dans cette intégration, l'authentification avec le fichier JSON de clé de compte de service est prioritaire sur l'adresse e-mail Workload Identity. Pour emprunter l'identité de comptes de service avec Workload Identity, attribuez le rôle |
OAuth Scopes |
Optional Liste d'éléments séparés par une virgule des champs d'application OAuth requis pour exécuter les requêtes API Google Cloud . |
Verify SSL |
Obligatoire Si cette option est sélectionnée, l'intégration vérifie que le certificat SSL de connexion au service Google Cloud est valide. Cette option est sélectionnée par défaut. |
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 compatibilité 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
finisheddans la réponse JSON et ignorer les autres états, définissez toutes les clésstatedeExpected Response Valuessurfinished:{ "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 queId=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 dansBody 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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é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 deSave To Case Wallavec le mot de passeinfected.
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 :
PUTChemin 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 |
Optional Méthode à utiliser dans la requête. La valeur par défaut est
|
URL Path |
Optional URL à exécuter. La valeur par défaut est |
URL Params |
Optional Paramètres d'URL. L'action utilise toutes les valeurs fournies avec celles que vous avez directement fournies dans le paramètre Chemin d'URL. Ce paramètre nécessite le format d'objet JSON en entrée. La valeur par défaut est la suivante : {
"URL Field Name": "URL_FIELD_VALUE"
} |
Headers |
Optional En-têtes à utiliser dans la requête HTTP. Ce paramètre nécessite le format d'objet JSON en entrée. La valeur par défaut est la suivante : {
"Content-Type": "application/json; charset=utf-8",
"Accept": "application/json",
"User-Agent" : "GoogleSecOps"
} |
Cookie |
Optional Paramètres à utiliser dans l'en-tête Ce paramètre remplace les cookies fournis dans le paramètre Headers. Ce paramètre nécessite le format d'objet JSON comme entrée. La valeur par défaut est la suivante : {
"Cookie_1": "COOKIE_1_VALUE"
} |
|
Optional
Corps de la requête HTTP. L'action crée différentes charges utiles en fonction de la valeur d'en-tête Ce paramètre nécessite le format d'objet JSON en entrée, sauf lorsqu'un produit tiers nécessite du contenu XML ou La valeur par défaut est la suivante : {
"Body Field Name": "BODY_FIELD_VALUE"
} |
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 |
Optional Si cette option est sélectionnée, l'action enregistre le fichier et le joint au mur de la demande. Le fichier est archivé avec l'extension Non sélectionné par défaut. |
Password Protect Zip |
Optional Si cette option est sélectionnée, l'action ajoute un mot de passe au fichier Utilisez ce paramètre lorsque vous travaillez avec des fichiers suspects. Cette option est sélectionnée par défaut. |
Follow Redirects |
Optional Si cette option est sélectionnée, l'action suit les redirections. Cette option est sélectionnée par défaut. |
Fail on 4xx/5xx |
Optional Si cette option est sélectionnée, l'action échoue si le code d'état de la réponse est une erreur 4xx ou 5xx. Cette option est sélectionnée par défaut. |
Base64 Output |
Optional Si cette option est sélectionnée, l'action convertit la réponse au format base64. Utilisez ce paramètre lors du téléchargement de fichiers. Le résultat JSON ne peut pas dépasser 15 Mo. Non sélectionné par défaut. |
Fields To Return |
Obligatoire Champs à renvoyer. Les valeurs possibles sont les suivantes :
|
Request Timeout |
Obligatoire Période d'attente avant que le serveur n'envoie des données avant l'échec de l'action. La valeur par défaut est de 120 secondes. |
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 décrit le résultat JSON reçu lors de l'utilisation de l'action Exécuter une requête HTTP :
{
"response_data": {
"data": {
"relationships": {
"comment": [
{
"name": "item",
"description": "Object to which the comment belongs to."
},
{
"name": "author",
"description": "User who wrote the comment."
}
]
}
}
},
"redirects": [],
"response_code": 200,
"cookies": {},
"response_headers": {
"Content-Type": "application/json",
"X-Cloud-Trace-Context": "VALUE",
"Date": "Fri, 03 Nov 2023 16:14:13 GMT",
"Server": "Google Frontend",
"Content-Length": "36084"
},
"apparent_encoding": "ascii"
}
Messages de sortie
L'action Exécuter une requête HTTP fournit les messages de sortie suivants :
| Message de sortie | Description du message |
|---|---|
|
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 décrit les valeurs 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 |
Ping
Utilisez l'action Ping pour tester la connectivité à Google Cloud.
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 décrit le résultat JSON reçu lors de l'utilisation de l'action Ping :
{
"endpoint": "TEST_URL"
}
Messages de sortie
L'action Ping fournit les messages de sortie suivants :
| Message de sortie | Description du message |
|---|---|
Successfully tested connectivity. |
L'action a réussi. |
Failed to test connectivity. |
É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 décrit les valeurs 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 |
Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.