Intégrer Google Workspace à Google SecOps

Ce document explique comment intégrer Google Workspace à Google Security Operations (Google SecOps).

Version de l'intégration : 19.0

Cas d'utilisation

L'intégration de Google Workspace à Google SecOps peut vous aider à résoudre le cas d'utilisation suivant :

  • Désactivation des utilisateurs et sécurité des comptes : utilisez les fonctionnalités Google SecOps pour déclencher un workflow permettant de révoquer l'accès à Google Workspace, de suspendre des comptes et de transférer les e-mails des utilisateurs désactivés à un autre employé.

Avant de commencer

Avant de configurer l'intégration Google Workspace dans Google SecOps, effectuez les étapes préalables suivantes :

  1. Créez un compte de service.
  2. Créez une clé JSON.
  3. Créez un rôle personnalisé pour l'intégration.
  4. Attribuez le rôle personnalisé à un utilisateur.
  5. Déléguez l'autorité au niveau du domaine à votre compte de service.
  6. Activez l'API SDK Admin pour votre projet.

Créer un compte de service

Pour créer un compte de service, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Identifiants.

    Accéder à "Identifiants"

  2. Dans le menu Créer des identifiants, sélectionnez Compte de service.

  3. Sous Détails du compte de service, saisissez un nom dans le champ Nom du compte de service.

  4. Facultatif : Modifiez l'ID du compte de service.

  5. Cliquez sur Créer et continuer. L'écran Autorisations s'affiche.

  6. Cliquez sur Continuer. L'écran Comptes principaux avec accès s'affiche.

  7. Cliquez sur OK.

Attribuer des rôles Google Cloud IAM au compte de service

Pour vous assurer que le compte de service dispose de toutes les autorisations nécessaires dans votre projet Google Cloud, attribuez-lui les rôles IAM suivants :

  1. Dans la console Google Cloud , accédez à IAM et administration > IAM.

  2. Cliquez sur Accorder l'accès.

  3. Dans le champ Nouveaux comptes principaux, saisissez l'adresse e-mail du compte de service que vous avez créé.

  4. Dans la liste Sélectionner un rôle, recherchez et sélectionnez le rôle Service Account Token Creator (roles/iam.serviceAccountTokenCreator).

  5. Cliquez sur Enregistrer.

Créer une clé JSON

Pour créer une clé JSON, procédez comme suit :

  1. Sélectionnez votre compte de service, puis accédez à Clés.
  2. Cliquez sur Ajouter une clé.
  3. Sélectionnez Créer une clé.
  4. Pour le type de clé, sélectionnez JSON, puis cliquez sur Créer. Une boîte de dialogue Clé privée enregistrée sur votre ordinateur s'affiche et une copie de la clé privée est téléchargée sur votre ordinateur.

Créer un rôle personnalisé pour l'intégration

  1. Dans la console d'administration Google, accédez à Compte > Rôles d'administrateur.
  2. Cliquez sur Créer un rôle.
  3. Attribuez un nom au nouveau rôle personnalisé, puis cliquez sur Continuer.
  4. Sur la page Sélectionner les droits d'accès, accédez à la section des droits d'accès API Admin.

  5. Sous Droits pour l'API Admin, sélectionnez les droits suivants :

    • Unités organisationnelles
    • Utilisateurs
    • Groupes

  6. Cliquez sur Continuer.

  7. Pour créer un rôle personnalisé, cliquez sur Créer un rôle.

Attribuer le rôle personnalisé à un utilisateur

  1. Pour créer un utilisateur, accédez à la page Annuaire > Utilisateurs.
  2. Ajoutez un utilisateur associé au compte de service.
  3. Ouvrez les paramètres du nouvel utilisateur. L'onglet du compte utilisateur s'ouvre.
  4. Cliquez sur Rôles d'administrateur et autorisations.
  5. Cliquez sur Modifier Modifier.
  6. Sélectionnez le rôle personnalisé que vous avez créé.
  7. Pour le rôle sélectionné, activez l'option Attribué.

Déléguer l'autorité au niveau du domaine à votre compte de service

  1. Dans la console d'administration Google de votre domaine, accédez à  Menu principal > Sécurité > Contrôle des accès et des données > Commandes des API.
  2. Dans le volet Délégation au niveau du domaine, sélectionnez Gérer la délégation au niveau du domaine.
  3. Cliquez sur Ajouter.
  4. Dans le champ ID client, saisissez l'ID client obtenu lors des étapes précédentes de création du compte de service.

  5. Dans le champ Champs d'application OAuth, saisissez la liste des champs d'application requis pour votre application, séparés par une virgule :

    https://mail.google.com/,
https://www.googleapis.com/auth/cloud-platform,
https://www.googleapis.com/auth/admin.directory.user,
https://www.googleapis.com/auth/admin.directory.group.member,
https://www.googleapis.com/auth/admin.directory.customer.readonly,
https://www.googleapis.com/auth/admin.directory.domain.readonly,
https://www.googleapis.com/auth/admin.directory.group,
https://www.googleapis.com/auth/admin.directory.orgunit,
https://www.googleapis.com/auth/admin.directory.user.alias,
https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly,
https://www.googleapis.com/auth/apps.groups.settings,
https://www.googleapis.com/auth/admin.directory.user.security,
https://www.googleapis.com/auth/admin.reports.audit.readonly,
https://www.googleapis.com/auth/admin.directory.device.chromebrowsers.readonly,
https://www.googleapis.com/auth/chrome.management.policy,
https://www.googleapis.com/auth/chrome.management.appdetails.readonly

  6. Cliquez sur Autoriser.

Activer l'API Admin SDK pour votre projet

  1. Dans la console Google Cloud , accédez à API et services.

    Accéder aux API et services

  2. Cliquez sur Activer les API et les services.

  3. Activez l'API Admin SDK pour votre projet.

Paramètres d'intégration

L'intégration Google Workspace nécessite les paramètres suivants :

Paramètre Description
Verify SSL

Facultatif.

Si cette option est sélectionnée, l'intégration valide le certificat SSL lors de la connexion à Google Workspace.

Cette option est sélectionnée par défaut.
User's Service Account JSON

Facultatif.

Contenu du fichier JSON de clé de compte de service.

Vous pouvez configurer ce paramètre ou le paramètre Workload Identity Email.

Pour configurer ce paramètre, indiquez le contenu complet du fichier JSON de la clé de compte de service que vous avez téléchargé lorsque vous avez créé un compte de service.
Delegated Email

Obligatoire.

Adresse e-mail à utiliser pour l'intégration.
Workload Identity Email

Facultatif.

Adresse e-mail du client de votre compte de service.

Vous pouvez configurer ce paramètre ou le paramètre User's Service Account JSON.

Pour emprunter l'identité de comptes de service avec la fédération d'identité de charge de travail, accordez le rôle Service Account Token Creator à votre compte de service. Pour en savoir plus sur les identités de charge de travail et sur la façon de les utiliser, consultez Identités pour les charges de travail.

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

Vous pourrez apporter des modifications ultérieurement, si nécessaire. Une fois que vous avez configuré une instance d'intégration, vous pouvez l'utiliser dans des playbooks. Pour savoir comment configurer et prendre en charge plusieurs instances, consultez Prise en charge de plusieurs instances.

Actions

Pour en savoir plus sur les actions, consultez Répondre aux actions en attente dans Votre espace de travail et Effectuer une action manuelle.

Ajouter des membres à un groupe

Utilisez l'action Ajouter des membres au groupe pour ajouter des utilisateurs à un groupe.

Cette action s'exécute sur l'entité User.

L'action Ajouter des membres à un groupe résout les cas d'utilisation suivants :

  • Intégration et suppression automatisées des utilisateurs.
  • Réponse aux incidents en accordant un accès temporaire.
  • Collaboration dynamique sur les projets.

Entrées d'action

L'action Ajouter des membres au groupe nécessite les paramètres suivants :

Paramètre Description
Group Email Address

Obligatoire.

Adresse e-mail du groupe auquel ajouter des membres.

User Email Addresses

Facultatif.

Liste d'utilisateurs à ajouter au groupe, séparés par une virgule.

L'action exécute les valeurs que vous configurez pour ce paramètre en même temps que l'entité User.

Sorties d'action

L'action Ajouter des membres au groupe fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Table du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Non disponible
Résultat du script Disponible
Résultat du script

Le tableau suivant décrit les valeurs de sortie des résultats du script lorsque vous utilisez l'action Ajouter des membres au groupe :

Nom du résultat du script Valeur
is_success True ou False

Bloquer une extension

Utilisez l'action Bloquer l'extension pour bloquer une extension Chrome spécifique dans une unité organisationnelle.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Bloquer l'extension nécessite les paramètres suivants :

Paramètre Description
Organization Unit Name

Obligatoire.

Nom de l'unité organisationnelle dans laquelle bloquer l'extension.
Extension ID

Obligatoire.

ID de l'extension à bloquer.

Sorties d'action

L'action Bloquer l'extension fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Table 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 les résultats JSON reçus lors de l'utilisation de l'action Bloquer l'extension :

[
        {
            "targetKey": {
                "targetResource": "orgunits/example-org-unit-id",
                "additionalTargetKeys": {
                    "app_id": "chrome:exampleextensionid"
                }
            },
            "value": {
                "policySchema": "chrome.users.apps.InstallType",
                "value": {
                    "appInstallType": "BLOCKED"
                }
            },
            "sourceKey": {
                "targetResource": "orgunits/example-org-unit-id"
            },
            "addedSourceKey": {
                "targetResource": "orgunits/example-org-unit-id"
            }
        }
]
Messages de sortie

L'action Bloquer l'extension peut renvoyer les messages de résultat suivants :

Message affiché Description du message

Successfully blocked extension EXTENSION_ID in Organization Unit ORGANIZATION_NAME using Google Workspace.

 L'action a réussi.
Error executing action "Block Extension". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Bloquer l'extension :

Nom du résultat du script Valeur
is_success True ou False

Créer un groupe

Utilisez l'action Créer un groupe pour créer des groupes pour votre organisation dans la console d'administration Google, l'API Groups ou Google Cloud Directory Sync en tant qu'administrateur Google Workspace Groups.

Si vous utilisez Groups for Business, vous pouvez également créer des groupes pour votre organisation dans Google Groupes.

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

Vous pouvez utiliser l'action Créer un groupe dans les cas d'utilisation suivants :

  • Créez des équipes de réponse aux incidents.
  • Contenir les campagnes d'hameçonnage
  • Intégrez de nouveaux utilisateurs et groupes d'utilisateurs.
  • collaborer sur des projets ;
  • Configurez le contrôle des accès pour les données sensibles.

Entrées d'action

L'action Créer un groupe nécessite les paramètres suivants :

Paramètre Description
Email Address

Obligatoire.

Adresse e-mail du nouveau groupe.
Name

Facultatif.

Nom du nouveau groupe.
Description

Facultatif.

Description du nouveau groupe.

Sorties d'action

L'action Créer un groupe fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Table du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON 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 Créer un groupe :

[
   {
      "kind":"admin#directory#group",
      "id":"ID",
      "etag":"TAG/var>",
      "email":"user@example.com",
      "name":"example",
      "description":"",
      "adminCreated":"True"
   }
]
Résultat du script

Le tableau suivant décrit les valeurs de sortie des résultats du script lorsque vous utilisez l'action Créer un groupe :

Nom du résultat du script Valeur
is_success True ou False

Créer une UO

Utilisez l'action Créer une UO pour créer une unité organisationnelle (UO).

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

Vous pouvez utiliser l'action Créer une UO pour résoudre les cas d'utilisation suivants :

  • Intégrez de nouveaux services.
  • Isolez les comptes piratés.
  • Implémentez des règles de résidence des données basées sur la géographie.

Entrées d'action

L'action Créer une UO nécessite les paramètres suivants :

Paramètre Description
Customer ID

Obligatoire.

ID unique du compte Google Workspace du client.

Pour configurer le compte customerId, vous pouvez également utiliser l'espace réservé suivant : my_customer.
Name

Facultatif.

Nom de la nouvelle UO.
Description

Facultatif.

Description de la nouvelle UO.
Parent OU Path

Obligatoire.

Chemin d'accès complet à l'UO parente d'une nouvelle UO.

Sorties d'action

L'action Créer une UO fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Table du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON 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 Créer une UO :

[
   {
      "kind":"admin#directory#orgUnit",
      "etag":"TAG",
      "name":"example",
      "orgUnitPath":"/example_folder",
      "orgUnitId":"id:ID",
      "parentOrgUnitPath":"/",
      "parentOrgUnitId":"id:ID"
   }
]
Résultat du script

Le tableau suivant décrit les valeurs de la sortie des résultats du script lorsque vous utilisez l'action Créer une UO :

Nom du résultat du script Valeur
is_success True ou False

Créer un utilisateur

Utilisez l'action Créer un utilisateur pour créer un utilisateur.

Lorsque vous ajoutez un utilisateur à votre compte Google Workspace, vous lui attribuez une adresse e-mail sur le domaine de votre entreprise et un compte pour accéder aux services Google Workspace.

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

Vous pouvez utiliser l'action Créer un utilisateur pour résoudre les cas d'utilisation suivants :

  • Automatisez l'intégration des nouveaux utilisateurs.
  • Fournissez un accès temporaire aux employés sous contrat.
  • Utilisez des bacs à sable pour la gestion des incidents.

Entrées d'action

L'action Créer un utilisateur nécessite les paramètres suivants :

Paramètre Description
Given Name

Obligatoire.

Prénom de l'utilisateur.
Family Name

Obligatoire.

Nom de famille de l'utilisateur.
Password

Obligatoire.

Mot de passe du nouvel utilisateur.
Email Address

Obligatoire.

Adresse e-mail principale de l'utilisateur.
Phone

Facultatif.

Numéro de téléphone de l'utilisateur.
Gender

Facultatif.

Genre de l'utilisateur.

Les valeurs valides sont les suivantes : female, male, other, unknown.
Department

Facultatif.

Nom du service de l'utilisateur.
Organization

Facultatif.

Nom de l'organisation de l'utilisateur.
Change Password At Next Login

Facultatif.

Si cette option est sélectionnée, le système exige que l'utilisateur modifie son mot de passe lors de sa prochaine tentative de connexion.

Par défaut, cette option n'est pas sélectionnée.

Sorties d'action

L'action Créer un utilisateur fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Table du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON 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 Créer un utilisateur :

[
   {
      "kind":"admin#directory#user",
      "id":"ID",
      "etag":"TAG",
      "primaryEmail":"example@example.com",
      "name":{
         "givenName":"FIRST_NAME",
         "familyName":"LAST_NAME"
      },
      "isAdmin":"False",
      "isDelegatedAdmin":"False",
      "creationTime":"2020-12-22T13:44:29.000Z",
      "organizations":[
         {
            "name":"ExampleOrganization"
         }
      ],
      "phones":[
         {
            "value":"(800) 555‑0175"
         }
      ],
      "gender":{
         "type":"male"
      },
      "customerId":"ID",
      "orgUnitPath":"/",
      "isMailboxSetup":"False"
   }
]
Résultat du script

Le tableau suivant décrit les valeurs de la sortie des résultats du script lorsque vous utilisez l'action Créer un utilisateur :

Nom du résultat du script Valeur
is_success True ou False

Supprimer l'extension

Aperçu. Utilisez l'action Supprimer l'extension pour supprimer une extension Chrome spécifiée d'une liste de blocage d'unité organisationnelle.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Supprimer l'extension nécessite les paramètres suivants :

Paramètre Description
Organization Unit Name

Obligatoire.

Nom de l'unité organisationnelle à partir de laquelle supprimer l'extension.
Extension ID

Obligatoire.

ID de l'extension à supprimer.

Sorties d'action

L'action Delete Extension (Supprimer l'extension) fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Table 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 les résultats JSON reçus lors de l'utilisation de l'action Supprimer l'extension :

[
  {
    "deleted_extensions": ["chrome:exampleextensionid"]
  }
]
Messages de sortie

L'action Delete Extension (Supprimer l'extension) peut renvoyer les messages de sortie suivants :

Message affiché Description du message

Successfully deleted extension EXTENSION_ID from Organization Unit ORGANIZATION_NAME using Google Workspace.

 L'action a réussi.
Error executing action "Delete Extension". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Supprimer l'extension :

Nom du résultat du script Valeur
is_success True ou False

Supprimer le groupe

Utilisez l'action Supprimer le groupe pour supprimer un groupe de répertoire Google Workspace.

Cette action ne s'applique pas aux entités Google SecOps.

Vous pouvez utiliser l'action Supprimer le groupe pour résoudre les cas d'utilisation suivants :

  • Automatiser le départ des utilisateurs
  • Corrigez les incidents de sécurité.
  • Effectuez des nettoyages pour les groupes obsolètes.

Entrées d'action

L'action Supprimer le groupe nécessite les paramètres suivants :

Paramètre Description
Group Email Address

Obligatoire.

Adresse e-mail du groupe à supprimer.

Sorties d'action

L'action Supprimer le groupe fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Table 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 Delete Group (Supprimer le groupe) fournit les messages de sortie suivants :

Message affiché Description du message

Google Workspace group GROUP_EMAIL deleted.

Action was not able to find Google Workspace group for deletion.

L'action a réussi.
Failed to connect to the Google Workspace! Error is ERROR_DESCRIPTION

É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 des résultats du script lorsque vous utilisez l'action Supprimer le groupe :

Nom du résultat du script Valeur
is_success True ou False

Supprimer une UO

Utilisez l'action Supprimer l'UO pour supprimer une unité organisationnelle.

Vous ne pouvez pas supprimer une organisation si elle contient des utilisateurs, des appareils ou des organisations enfants. Avant de supprimer une organisation, déplacez les utilisateurs et les appareils vers d'autres organisations, puis supprimez les organisations enfants.

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

Vous pouvez utiliser l'action Supprimer l'UO pour résoudre les cas d'utilisation suivants :

  • Automatiser le départ des utilisateurs
  • Corrigez les incidents de sécurité.
  • Gérez les ressources de projet et nettoyez les projets.

Entrées d'action

L'action Supprimer l'UO nécessite les paramètres suivants :

Paramètre Description
Customer ID

Obligatoire.

ID unique du compte Google Workspace du client.

Pour configurer le compte customerId, vous pouvez également utiliser l'espace réservé suivant : my_customer.
OU Path

Obligatoire.

Chemin d'accès complet à l'unité organisationnelle.

Si l'unité organisationnelle se trouve sous un chemin racine (/), indiquez son nom sans chemin d'accès.

Sorties d'action

L'action Supprimer l'UO fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Table du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Non disponible
Résultat du script Disponible
Résultat du script

Le tableau suivant décrit les valeurs de la sortie des résultats du script lorsque vous utilisez l'action Supprimer l'UO :

Nom du résultat du script Valeur
is_success True ou False

Supprimer l'utilisateur

Utilisez l'action Supprimer un utilisateur pour supprimer des comptes utilisateur.

Une fois que vous avez supprimé un utilisateur, il ne peut plus accéder aux services Google Workspace de votre organisation ni les utiliser.

Vous pouvez utiliser l'action Supprimer l'utilisateur pour résoudre les cas d'utilisation suivants :

  • Supprimez les employés qui quittent l'entreprise.
  • Réparez les comptes piratés.
  • Automatisez le nettoyage des comptes temporaires.

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

Entrées d'action

L'action Supprimer l'utilisateur nécessite les paramètres suivants :

Paramètre Description
Email Address

Obligatoire.

Adresse e-mail de l'utilisateur à supprimer.

Sorties d'action

L'action Supprimer un utilisateur fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Table du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Non disponible
Résultat du script Disponible
Résultat du script

Le tableau suivant décrit les valeurs de la sortie des résultats du script lorsque vous utilisez l'action Supprimer l'utilisateur :

Nom du résultat du script Valeur
is_success True ou False

Enrichir les entités

Utilisez l'action Enrichir les entités pour enrichir les entités Google SecOps avec des informations provenant de Google Workspace.

Cette action s'exécute sur l'entité User.

Vous pouvez utiliser l'action Enrichir les entités pour résoudre les cas d'utilisation suivants :

  • Enquêter sur les utilisateurs
  • Analysez les e-mails d'hameçonnage.
  • Enquêter sur les tentatives d'exfiltration de données
  • Détecter les logiciels malveillants.

Entrées d'action

Aucun

Sorties d'action

L'action Enrichir les entités fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Table du mur des cas Non disponible
Table d'enrichissement des entités Disponible
Résultat JSON Disponible
Résultat du script Disponible
Enrichissement d'entités

L'action Enrichir les entités est compatible avec l'enrichissement d'entités suivant :

Nom du champ d'enrichissement Logique d'enrichissement
Phones Renvoie la valeur si elle existe dans un résultat JSON.
isDelegatedAdmin Renvoie la valeur si elle existe dans un résultat JSON.
suspended Renvoie la valeur si elle existe dans un résultat JSON.
id Renvoie la valeur si elle existe dans un résultat JSON.
nonEditableAliases Renvoie la valeur si elle existe dans un résultat JSON.
archived Renvoie la valeur si elle existe dans un résultat JSON.
isEnrolledIn2Sv Renvoie la valeur si elle existe dans un résultat JSON.
includeInGlobalAddressList Renvoie la valeur si elle existe dans un résultat JSON.
Relations Renvoie la valeur si elle existe dans un résultat JSON.
isAdmin Renvoie la valeur si elle existe dans un résultat JSON.
etag Renvoie la valeur si elle existe dans un résultat JSON.
lastLoginTime Renvoie la valeur si elle existe dans un résultat JSON.
orgUnitPath Renvoie la valeur si elle existe dans un résultat JSON.
agreedToTerms Renvoie la valeur si elle existe dans un résultat JSON.
externalIds Renvoie la valeur si elle existe dans un résultat JSON.
ipWhitelisted Renvoie la valeur si elle existe dans un résultat JSON.
kind Renvoie la valeur si elle existe dans un résultat JSON.
isEnforcedIn2Sv Renvoie la valeur si elle existe dans un résultat JSON.
isMailboxSetup Renvoie la valeur si elle existe dans un résultat JSON.
emails Renvoie la valeur si elle existe dans un résultat JSON.
organizations Renvoie la valeur si elle existe dans un résultat JSON.
primaryEmail Renvoie la valeur si elle existe dans un résultat JSON.
name Renvoie la valeur si elle existe dans un résultat JSON.
gender Renvoie la valeur si elle existe dans un résultat JSON.
creationTime Renvoie la valeur si elle existe dans un résultat JSON.
changePasswordAtNextLogin Renvoie la valeur si elle existe dans un résultat JSON.
customerId Renvoie la valeur si elle existe dans un résultat JSON.
Résultat JSON

L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Enrich Entities (Enrichir les entités) :

[{
    "Phones":
       [{
          "customType": "",
          "type": "custom",
          "value": "(800) 555‑0175"
       }],
   "isDelegatedAdmin": false,
   "suspended": false,
   "id": "ID",
   "nonEditableAliases": ["user@example.com"],
   "archived": false,
   "isEnrolledIn2Sv": true,
   "includeInGlobalAddressList": true,
   "Relations":
        [{
          "type": "manager",
          "value": "user@example.com"
        }],
   "isAdmin": false,
   "etag": "E_TAG_VALUE",
   "lastLoginTime": "2019-02-11T12:24:41.000Z",
   "orgUnitPath": "/OU-1",
   "agreedToTerms": true,
   "externalIds": [{"type": "organization",
                    "value": ""}],
   "ipWhitelisted": false,
   "kind": "admin#directory#user",
   "isEnforcedIn2Sv": true,
   "isMailboxSetup": true,
   "emails":
       [{
          "primary": true,
          "address": "user@example.com"
        },
        {
          "address": "user@example.com"
        }],
    "organizations":
        [{
           "department": "R&D",
           "customType": "", "name": "Company"
         }],
     "primaryEmail": "user@example.com",
     "name":
         {
            "fullName": "NAME SURNAME",
            "givenName": "NAME",
            "familyName": "SURNAME"
         },
     "gender": {"type": "male"},
     "creationTime": "2017-10-26T06:57:13.000Z",
     "changePasswordAtNextLogin": false,
     "customerId": "CUSTOMER_ID"
}]
Résultat du script

Le tableau suivant décrit les valeurs de la sortie des résultats du script lorsque vous utilisez l'action Enrichir les entités :

Nom du résultat du script Valeur
is_success True ou False

Obtenir les détails de l'extension

Utilisez l'action Obtenir les détails de l'extension pour récupérer des informations sur une extension Chrome spécifique.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action "Get Extension Details" (Obtenir les détails de l'extension) nécessite les paramètres suivants :

Paramètre Description
Extension ID

Obligatoire.

Liste d'ID d'extension à enrichir, séparés par une virgule.
Max Requesting Users To Return

Obligatoire.

Nombre maximal d'utilisateurs à renvoyer ayant demandé l'installation de l'extension.

La valeur maximale est de 1000.
Max Requesting Devices To Return

Obligatoire.

Nombre maximal d'appareils à renvoyer pour lesquels l'installation de l'extension a été demandée.

La valeur maximale est de 1000.

Sorties d'action

L'action Obtenir les détails de l'extension fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Table du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON obtenu lors de l'utilisation de l'action Obtenir les détails de l'extension :

[
  {
    "Entity": "Example Extension Name",
    "EntityResult": {
      "name": "customers/example-customer-id/apps/chrome/exampleextensionid",
      "displayName": "Example Extension Name",
      "description": "A description for an example extension.",
      "appId": "exampleextensionid",
      "revisionId": "11.3.0.0",
      "type": "CHROME",
      "iconUri": "https://lh3.googleusercontent.com/KxYKwMcAzhn_DBMVIb0mtvIOsAME2d8-csv5d_vnKYX6PL3D6BGbVy3hH68ky8nM9yTDGAPl6B77pA7tpu4_jeUkXw",
      "detailUri": "https://chromewebstore.google.com/detail/exampleextensionid",
      "firstPublishTime": "2011-12-14T06:57:01.918Z",
      "latestPublishTime": "2025-07-01T02:05:04.252Z",
      "publisher": "example-publisher",
      "reviewNumber": "5423",
      "reviewRating": 4,
      "chromeAppInfo": {
        "supportEnabled": true,
        "minUserCount": 3000000,
        "permissions": [
          {
            "type": "offscreen"
          },
          {
            "type": "scripting",
            "documentationUri": "https://developer.chrome.com/docs/extensions/reference/scripting/",
            "accessUserData": false
          },
          {
            "type": "storage",
            "documentationUri": "https://developer.chrome.com/docs/extensions/reference/storage/",
            "accessUserData": false
          },
          {
            "type": "tabs",
            "documentationUri": "https://developer.chrome.com/docs/extensions/reference/tabs#type-Tab",
            "accessUserData": true
          }
        ],
        "siteAccess": [
          {
            "hostMatch": "https://*/*"
          },
          {
            "hostMatch": "http://*/*"
          }
        ],
        "isTheme": false,
        "googleOwned": true,
        "isCwsHosted": true,
        "kioskEnabled": false,
        "isKioskOnly": false,
        "type": "EXTENSION",
        "isExtensionPolicySupported": false,
        "manifestVersion": "3",
        "requestingUserDetails": [
          {
            "email": "user@example.com",
            "justification": "Example justification for the request."
          }
        ],
        "requestingDeviceDetails": [
          {
            "device": "example-device-id",
            "justification": "Example justification for the request."
          }
        ]
      }
    }
  }
]
Messages de sortie

L'action Obtenir les détails de l'extension peut renvoyer les messages de sortie suivants :

Message affiché Description du message

Successfully returned information about the following extensions in Google Workspace: EXTENSION_IDS.

Action wasn't able to return information about the following extension in Google Workspace: EXTENSION_IDS.

No information about the provided extensions were found.

 L'action a réussi.
Error executing action "Get Extension Details". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Get Extension Details (Obtenir les détails de l'extension) :

Nom du résultat du script Valeur
is_success True ou False

Obtenir les détails d'un groupe

Utilisez l'action Obtenir les détails du groupe pour récupérer des informations sur un groupe dans Google Workspace.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action Obtenir les détails du groupe nécessite les paramètres suivants :

Paramètre Description
Group Email Addresses

Obligatoire.

Liste d'adresses e-mail de groupe à examiner, séparées par une virgule.

Sorties d'action

L'action Obtenir les détails du groupe fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Table 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 obtenu lors de l'utilisation de l'action Obtenir les détails du groupe :

{
        "Entity": "group@example.com",
        "EntityResult": {
            "kind": "groupsSettings#groups",
            "email": "group@example.com",
            "name": "GROUP_NAME",
            "description": "DESCRIPTION",
            "whoCanJoin": "CAN_REQUEST_TO_JOIN",
            "whoCanViewMembership": "ALL_MEMBERS_CAN_VIEW",
            "whoCanViewGroup": "ALL_MEMBERS_CAN_VIEW",
            "whoCanInvite": "ALL_MANAGERS_CAN_INVITE",
            "whoCanAdd": "ALL_MANAGERS_CAN_ADD",
            "allowExternalMembers": "false",
            "whoCanPostMessage": "ANYONE_CAN_POST",
            "allowWebPosting": "true",
            "primaryLanguage": "en_US",
            "maxMessageBytes": 26214400,
            "isArchived": "false",
            "archiveOnly": "false",
            "messageModerationLevel": "MODERATE_NONE",
            "spamModerationLevel": "MODERATE",
            "replyTo": "REPLY_TO_IGNORE",
            "includeCustomFooter": "false",
            "customFooterText": "",
            "sendMessageDenyNotification": "false",
            "defaultMessageDenyNotificationText": "",
            "showInGroupDirectory": "true",
            "allowGoogleCommunication": "false",
            "membersCanPostAsTheGroup": "false",
            "messageDisplayFont": "DEFAULT_FONT",
            "includeInGlobalAddressList": "true",
            "whoCanLeaveGroup": "ALL_MEMBERS_CAN_LEAVE",
            "whoCanContactOwner": "ANYONE_CAN_CONTACT",
            "whoCanAddReferences": "NONE",
            "whoCanAssignTopics": "NONE",
            "whoCanUnassignTopic": "NONE",
            "whoCanTakeTopics": "NONE",
            "whoCanMarkDuplicate": "NONE",
            "whoCanMarkNoResponseNeeded": "NONE",
            "whoCanMarkFavoriteReplyOnAnyTopic": "NONE",
            "whoCanMarkFavoriteReplyOnOwnTopic": "NONE",
            "whoCanUnmarkFavoriteReplyOnAnyTopic": "NONE",
            "whoCanEnterFreeFormTags": "NONE",
            "whoCanModifyTagsAndCategories": "NONE",
            "favoriteRepliesOnTop": "true",
            "whoCanApproveMembers": "ALL_MANAGERS_CAN_APPROVE",
            "whoCanBanUsers": "OWNERS_AND_MANAGERS",
            "whoCanModifyMembers": "OWNERS_AND_MANAGERS",
            "whoCanApproveMessages": "OWNERS_AND_MANAGERS",
            "whoCanDeleteAnyPost": "OWNERS_AND_MANAGERS",
            "whoCanDeleteTopics": "OWNERS_AND_MANAGERS",
            "whoCanLockTopics": "OWNERS_AND_MANAGERS",
            "whoCanMoveTopicsIn": "OWNERS_AND_MANAGERS",
            "whoCanMoveTopicsOut": "OWNERS_AND_MANAGERS",
            "whoCanPostAnnouncements": "OWNERS_AND_MANAGERS",
            "whoCanHideAbuse": "NONE",
            "whoCanMakeTopicsSticky": "NONE",
            "whoCanModerateMembers": "OWNERS_AND_MANAGERS",
            "whoCanModerateContent": "OWNERS_AND_MANAGERS",
            "whoCanAssistContent": "NONE",
            "customRolesEnabledForSettingsToBeMerged": "false",
            "enableCollaborativeInbox": "false",
            "whoCanDiscoverGroup": "ALL_IN_DOMAIN_CAN_DISCOVER",
            "defaultSender": "DEFAULT_SELF"
        }
    }
Messages de sortie

L'action Obtenir les détails du groupe fournit les messages de sortie suivants :

Message affiché Description du message

Successfully enriched the following groups using information from Google Workspace: GROUPS

Action wasn't able to enrich the following group using information from Google Workspace: GROUPS

None of the groups were enriched.

 L'action a réussi.
Error executing action "Get Group Details". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant décrit les valeurs de la sortie des résultats du script lorsque vous utilisez l'action Get Group Details (Obtenir les détails du groupe) :

Nom du résultat du script Valeur
is_success True ou False

Obtenir des informations sur le navigateur hôte

Utilisez l'action Obtenir les détails du navigateur hôte pour récupérer des informations sur les navigateurs associés à une entité Hostname Google SecOps spécifiée.

Cette action s'exécute sur l'entité Hostname de Google SecOps.

Entrées d'action

Aucun

Sorties d'action

L'action Obtenir les détails du navigateur hôte fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Table du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON obtenu lors de l'utilisation de l'action Get Host Browser Details (Obtenir les détails du navigateur hôte) :

{
   "Entity": "example.host.com",
   "EntityResult": [
      {
         "deviceId": "example-device-id",
         "kind": "admin#directory#browserdevice",
         "lastPolicyFetchTime": "2025-07-25T12:11:17.546Z",
         "osPlatform": "Linux",
         "osArchitecture": "x86_64",
         "osVersion": "6.12.27-1rodete1-amd64",
         "machineName": "example.host.com",
         "lastRegistrationTime": "2025-07-07T07:45:20.504Z",
         "extensionCount": "15",
         "policyCount": "23",
         "lastDeviceUser": "example-user",
         "lastActivityTime": "2025-07-26T12:13:55.385Z",
         "osPlatformVersion": "Linux 6.12.27-1rodete1-amd64",
         "browserVersions": [
            "140.0.7259.2 (Dev)"
         ],
         "lastStatusReportTime": "2025-07-26T07:46:00.919Z",
         "lastDeviceUsers": [
            {
               "userName": "example-user",
               "lastStatusReportTime": "2025-07-26T07:46:00.919Z"
            }
         ],
         "machinePolicies": [
            {
               "source": "MACHINE_LEVEL_USER_CLOUD",
               "name": "CloudReportingEnabled",
               "value": "true"
            }
         ],
         "browsers": [
            {
               "browserVersion": "140.0.7259.2",
               "channel": "DEV",
               "lastStatusReportTime": "2025-07-26T07:46:00.919Z",
               "executablePath": "/opt/google/chrome-unstable",
               "profiles": [
                  {
                     "name": "Example User Profile",
                     "id": "/home/example_user/.config/google-chrome/Default",
                     "lastStatusReportTime": "2025-07-26T07:46:00.919Z",
                     "lastPolicyFetchTime": "2025-07-25T12:11:17.546Z",
                     "chromeSignedInUserEmail": "user@example.com",
                     "extensions": [
                        {
                           "extensionId": "exampleextensionid",
                           "version": "2.0.6",
                           "permissions": [
                              "alarms",
                              "contextMenus",
                              "management",
                              "storage",
                              "https://accounts.google.com/*",
                              "https://appengine.google.com/*",
                              "https://example.com/*",
                              "https://example.org/*",
                              "https://example-api.com/*",
                              "https://docs.example.com/*",
                              "https://internal.example.net/*",
                              "https://partners.example.com/*",
                              "https://www.google.com/*"
                           ],
                           ],
                           "name": "Example Extension",
                           "description": "This is a description for an example extension.",
                           "appType": "EXTENSION",
                           "homepageUrl": "https://chromewebstore.google.com/detail/exampleextensionid",
                           "installType": "ADMIN",
                           "manifestVersion": 3
                        }
                     ],
                     "userPolicies": [
                        {
                           "source": "USER_CLOUD",
                           "name": "CloudProfileReportingEnabled",
                           "value": "true"
                        }
                     ]
                  }
               ],
               "pendingInstallVersion": "140.0.7312.0"
            }
         ],
         "virtualDeviceId": "example-virtual-device-id",
         "orgUnitPath": "/",
         "deviceIdentifiersHistory": {
            "records": [
               {
                  "identifiers": {
                     "machineName": "example.host.com"
                  },
                  "firstRecordTime": "2025-06-03T08:06:33.895Z",
                  "lastActivityTime": "2025-07-26T07:46:01.325Z"
               }
            ]
         }
      }
   ]
}
Messages de sortie

L'action Obtenir les détails du navigateur hôte peut renvoyer les messages de sortie suivants :

Message affiché Description du message

Successfully returned browsers related to the following hostnames in Google Workspace: HOSTNAME.

No browsers were associated with the following hostnames in Google Workspace: HOSTNAME.

No browsers were associated with provided hostnames.

 L'action a réussi.
Error executing action "Get Host Browser Details". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Obtenir les détails du navigateur hôte :

Nom du résultat du script Valeur
is_success True ou False

Lister les membres d'un groupe

Utilisez l'action Lister les membres du groupe pour lister les membres d'un groupe Google Workspace.

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

Vous pouvez utiliser l'action Lister les membres du groupe pour résoudre les cas d'utilisation suivants :

  • Automatisez l'intégration et la suppression des utilisateurs.
  • Effectuez un audit de sécurité.
  • Répondez aux incidents.
  • Prend en charge l'accès dynamique aux ressources.

Entrées d'action

L'action Lister les membres du groupe nécessite les paramètres suivants :

Paramètre Description
Group Email Address

Obligatoire.

Adresse e-mail du groupe.
Include Derived Membership

Facultatif.

Si cette option est sélectionnée, la liste des actions indique les appartenances indirectes des utilisateurs du groupe.

Cette option est sélectionnée par défaut.

Sorties d'action

L'action Lister les membres du groupe fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Table du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON 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 Lister les membres du groupe :

{
   "status": "ACTIVE",
   "kind": "admin#directory#member",
   "email": "user1@example.com",
   "etag": "E_TAG_VALUE",
   "role": "MEMBER",
   "type": "USER",
   "id": "ID"
  },{
   "status": "ACTIVE",
   "kind": "admin#directory#member",
   "email": "user2@example.com",
   "etag": "E_TAG_VALUE",
   "role": "MEMBER",
   "type": "USER", "id": "ID"
}
Résultat du script

Le tableau suivant décrit les valeurs de sortie des résultats du script lorsque vous utilisez l'action Lister les membres du groupe :

Nom du résultat du script Valeur
members True ou False

Lister les privilèges de groupe

Utilisez l'action Lister les droits d'accès au groupe pour lister les rôles et les droits d'accès associés au groupe Google Workspace.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées d'action

L'action List Group Privileges (Lister les droits d'accès au groupe) nécessite les paramètres suivants :

Paramètre Description
Group Email Addresses

Facultatif.

Liste de groupes à examiner, séparés par une virgule.
Check Roles

Facultatif.

Liste de rôles séparés par une virgule à vérifier et qui sont associés au groupe.
Check Privileges

Facultatif.

Liste d'autorisations séparées par une virgule à vérifier et qui sont liées au groupe.

Ce paramètre nécessite que vous sélectionniez le paramètre Développer les privilèges. Si vous avez configuré le paramètre Vérifier les rôles, l'action vérifie les droits d'accès uniquement pour les rôles que vous avez listés.
Expand Privileges

Facultatif.

Si cette option est sélectionnée, l'action renvoie des informations sur tous les droits d'accès uniques associés au groupe.
Max Roles To Return

Obligatoire.

Nombre maximal de rôles associés au groupe à renvoyer.

La valeur par défaut est 100.
Max Privileges To Return

Obligatoire.

Nombre maximal de droits d'accès associés au groupe à renvoyer.

La valeur par défaut est 100.

Sorties d'action

L'action Lister les privilèges du groupe fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Table 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 List Group Privileges (Lister les privilèges du groupe) :

{
    "Entity": "user@example.com",
    "EntityResult": {
        "roles": [
            "Role1",
            "_GROUPS_EDITOR_ROLE",
            "example-role"
        ],
        "unique_privileges": [
            "VIEW_SITE_DETAILS",
            "ACCESS_EMAIL_LOG_SEARCH",
            "ACCESS_ADMIN_QUARANTINE",
            "ACCESS_RESTRICTED_QUARANTINE",
            "ADMIN_QUALITY_DASHBOARD_ACCESS",
            "MANAGE_DLP_RULE",
            "DASHBOARD_ACCESS",
            "MANAGE_GSC_RULE",
            "VIEW_GSC_RULE",
            "SECURITY_HEALTH_DASHBOARD_ACCESS",
            "SIT_CALENDAR_VIEW_METADATA",
            "SIT_CHAT_VIEW_METADATA",
            "SIT_CHROME_VIEW_METADATA",
            "SIT_DEVICE_UPDATE_DELETE",
            "SIT_DEVICE_VIEW_METADATA",
            "SIT_DRIVE_UPDATE_DELETE"
        ]
    }
}
Messages de sortie

L'action List Group Privileges (Lister les droits d'accès aux groupes) fournit les messages de sortie suivants :

Message affiché Description du message

Successfully fetched information for the following groups using information from Google Workspace: GROUPS

Action wasn't able to fetch information for the following groups using information from Google Workspace: GROUPS

None of the specific roles/privileges were found for the following groups in Google Workspace: GROUPS

None of the specific roles/privileges were found for the provided groups in Google Workspace.

No information was found for the provided groups in Google Workspace.

 L'action a réussi.
Error executing action "List Group Privileges". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant décrit les valeurs de la sortie des résultats du script lorsque vous utilisez l'action Lister les droits d'accès aux groupes :

Nom du résultat du script Valeur
is_success True ou False

Lister l'UO du compte

Utilisez l'action Lister les UO du compte pour lister les unités organisationnelles d'un compte.

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

Vous pouvez utiliser l'action Lister les UO du compte pour résoudre les cas d'utilisation suivants :

  • Automatisez le départ des utilisateurs.
  • Effectuez un audit de sécurité ciblé.
  • Automatiser la gestion des membres d'un groupe
  • Simplifiez le provisionnement des utilisateurs.
  • Automatisez les rapports et les audits de conformité.

Entrées d'intégration

L'action Lister les UO du compte nécessite les paramètres suivants :

Paramètre Description
Customer ID

Obligatoire.

ID unique du compte Google Workspace du client.

Pour représenter la valeur customerId du compte, utilisez l'espace réservé my_customer.
Organization Unit Path

Facultatif.

Chemin d'accès à l'unité organisationnelle à renvoyer.

La valeur par défaut est /.
Max Organization Units

Obligatoire.

Nombre maximal d'unités organisationnelles à renvoyer.

La valeur maximale est de 100.

La valeur par défaut est 50.

Sorties d'action

L'action Lister l'UO du compte fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Table du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON 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 List OU of Account (Lister les UO du compte) :

[{
   "kind": "admin#directory#orgUnit",
   "parentOrgUnitPath": "/",
   "name": "OU-1",
   "etag": "E_TAG_VALUE",
   "orgUnitPath": "/OU-1",
   "parentOrgUnitId": "id:1455",
   "blockInheritance": false,
   "orgUnitId": "id:123",
   "description": ""
}]
Résultat du script

Le tableau suivant décrit les valeurs de la sortie du résultat du script lorsque vous utilisez l'action Lister les UO du compte :

Nom du résultat du script Valeur
organizational_units True ou False

Lister les droits d'utilisateur

Utilisez l'action Lister les droits d'accès des utilisateurs pour lister les rôles et les droits d'accès associés à l'utilisateur dans Google Workspace.

Cette action s'exécute sur l'entité User de Google SecOps.

Entrées d'action

L'action Lister les droits d'accès des utilisateurs nécessite les paramètres suivants :

Paramètre Description
User Email Addresses

Facultatif.

Liste d'utilisateurs à examiner, séparés par une virgule.

L'action exécute les valeurs que vous configurez pour ce paramètre en même temps que l'entité User.
Check Roles

Facultatif.

Liste de rôles séparés par une virgule à vérifier pour l'utilisateur.
Check Privileges

Facultatif.

Liste d'autorisations séparées par une virgule à vérifier pour l'utilisateur.

Ce paramètre nécessite que vous sélectionniez le paramètre Développer les privilèges. Si vous avez configuré le paramètre Vérifier les rôles, l'action vérifie les droits d'accès uniquement pour les rôles que vous avez listés.
Include Inherited Roles

Facultatif.

Si cette option est sélectionnée, l'action renvoie également les rôles utilisateur hérités des groupes.
Expand Privileges

Facultatif.

Si cette option est sélectionnée, l'action renvoie des informations sur tous les privilèges uniques associés à l'utilisateur.
Max Roles To Return

Obligatoire.

Nombre maximal de rôles associés à l'utilisateur à renvoyer.

La valeur par défaut est 100.
Max Privileges To Return

Obligatoire.

Nombre maximal de droits d'accès associés à l'utilisateur à renvoyer.

La valeur par défaut est 100.

Sorties d'action

L'action Lister les droits d'utilisateur fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Table 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 Lister les privilèges utilisateur :

{
    "Entity": "user@example.com",
    "EntityResult": {
        "roles": [
            "Role1",
            "_GROUPS_EDITOR_ROLE",
            "example-role"
        ],
        "unique_privileges": [
            "VIEW_SITE_DETAILS",
            "ACCESS_EMAIL_LOG_SEARCH",
            "ACCESS_ADMIN_QUARANTINE",
            "ACCESS_RESTRICTED_QUARANTINE",
            "ADMIN_QUALITY_DASHBOARD_ACCESS",
            "MANAGE_DLP_RULE",
            "DASHBOARD_ACCESS",
            "MANAGE_GSC_RULE",
            "VIEW_GSC_RULE",
            "SECURITY_HEALTH_DASHBOARD_ACCESS",
            "SIT_CALENDAR_VIEW_METADATA",
            "SIT_CHAT_VIEW_METADATA",
            "SIT_CHROME_VIEW_METADATA",
            "SIT_DEVICE_UPDATE_DELETE",
            "SIT_DEVICE_VIEW_METADATA",
            "SIT_DRIVE_UPDATE_DELETE"
        ]
    }
}
Messages de sortie

L'action Lister les droits d'accès de l'utilisateur fournit les messages de sortie suivants :

Message affiché Description du message

Successfully enriched the following users using information from Google Workspace: USERS

Action wasn't able to enrich the following users using information from Google Workspace: USERS

None of the specific roles/privileges were found for the following users in Google Workspace: USERS

None of the specific roles/privileges were found for the provided users in Google Workspace.

None of the provided users were enriched in Google Workspace.

L'action a réussi.
Error executing action "List User Privileges". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant décrit les valeurs de sortie des résultats du script lorsque vous utilisez l'action Lister les privilèges utilisateur :

Nom du résultat du script Valeur
is_success True ou False

Répertorier les utilisateurs

Utilisez l'action Lister les utilisateurs pour lister les utilisateurs présents dans un compte.

Cette action ne s'applique pas aux entités Google SecOps.

Vous pouvez utiliser l'action Lister les utilisateurs pour résoudre les cas d'utilisation suivants :

  • Identifier les comptes potentiellement piratés
  • Automatisez les processus de désintégration.
  • Auditer et gérer les droits d'accès des utilisateurs
  • Enquêter sur les activités suspectes.
  • Gérez les licences et les ressources utilisateur.

Entrées d'action

L'action Lister les utilisateurs nécessite les paramètres suivants :

Paramètre Description
Customer ID

Facultatif.

ID unique du compte Google Workspace du client.

Si vous ne fournissez pas la valeur de ce paramètre, l'action utilise automatiquement l'espace réservé my_customer pour représenter un numéro client du compte.
Domain

Facultatif.

Domaine dans lequel rechercher des utilisateurs.
Manager Email

Facultatif.

Adresse e-mail du responsable d'un utilisateur.
Return Only Admin Accounts?

Facultatif.

Si cette option est sélectionnée, l'action ne renvoie que les comptes administrateur.

(non sélectionnée par défaut).
Return Only Delegated Admin Accounts?

Facultatif.

Si cette option est sélectionnée, l'action ne renvoie que les comptes administrateur délégués.

(non sélectionnée par défaut).
Return Only Suspended Users?

Facultatif.

Si cette option est sélectionnée, l'action ne renvoie que les comptes suspendus.

(non sélectionnée par défaut).
Org Unit Path

Facultatif.

Chemin complet d'une unité organisationnelle à partir de laquelle récupérer les utilisateurs. Le chemin d'accès correspond à toutes les chaînes d'unités organisationnelles listées sous l'unité cible.
Department

Facultatif.

Service de l'organisation à partir duquel récupérer les utilisateurs.
Record Limit

Facultatif.

Nombre maximal d'enregistrements de données à renvoyer pour l'action.

La valeur par défaut est 20.
Custom Query Parameter

Facultatif.

Paramètre de requête personnalisé à ajouter à l'appel de recherche de la liste des utilisateurs, tel que orgName='Human Resources'.

Vous pouvez configurer ce paramètre avec le champ email, ou laisser le champ email vide et configurer le paramètre Email Addresses. Si vous configurez à la fois le champ email et le paramètre Email Addresses, la requête générée échoue.
Return only users without 2fa?

Facultatif.

Si cette option est sélectionnée, l'action ne renvoie que les utilisateurs pour lesquels l'authentification à deux facteurs (A2F) n'est pas activée.

Non sélectionnée par défaut.
Email Addresses

Facultatif.

Liste d'adresses e-mail à rechercher, séparées par une virgule.

Si vous configurez ce paramètre, ne configurez pas le champ email dans le paramètre Custom Query Parameter.

Si vous configurez ce paramètre, l'action ignore le paramètre Record Limit.

Sorties d'action

L'action Lister les utilisateurs fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Table du mur des cas Disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Table du mur des cas

L'action Lister les utilisateurs fournit le tableau suivant sur un mur des cas :

Nom de la table : Utilisateurs Google G Suite

Colonnes du tableau :

  • ID
  • E-mail
  • Prénom
  • Nom de famille
  • Est administrateur ?
  • Administrateur délégué ?
  • Heure de création
  • Heure de la dernière connexion
  • Suspendu ?
  • La campagne est-elle archivée ?
  • Modifier le mot de passe à la prochaine connexion ?
  • Numéro client
  • Chemin d'accès de l'unité organisationnelle
  • La boîte aux lettres est-elle configurée ?
  • Adresse e-mail de récupération
Résultat JSON

L'exemple suivant décrit le résultat JSON reçu lors de l'utilisation de l'action Lister les utilisateurs :

{
    "kind": "admin#directory#users",
    "etag": "E_TAG_VALUE",
    "users": [
        {
            "kind": "admin#directory#user",
            "id": "ID",
            "etag": "E_TAG_VALUE",
            "primaryEmail": "user@example.com",
            "name": {
                "givenName": "NAME",
                "familyName": "SURNAME",
                "fullName": "NAME SURNAME"
            },
            "isAdmin": true,
            "isDelegatedAdmin": false,
            "lastLoginTime": "2020-12-22T06:40:34.000Z",
            "creationTime": "2020-07-22T09:23:28.000Z",
            "agreedToTerms": true,
            "suspended": false,
            "archived": false,
            "changePasswordAtNextLogin": false,
            "ipWhitelisted": false,
            "emails": [
                {
                    "address": "user@example.com",
                    "primary": true
                },
                {
                    "address": "user@example.com"
                }
            ],
            "nonEditableAliases": [
                "user@example.com"
            ],
            "customerId": "CUSTOMER_ID",
            "orgUnitPath": "/Management",
            "isMailboxSetup": true,
            "isEnrolledIn2Sv": false,
            "isEnforcedIn2Sv": false,
            "includeInGlobalAddressList": true,
            "recoveryEmail": "email@example.com"
        }
    ]
}
Messages de sortie

L'action Lister les utilisateurs fournit les messages de sortie suivants :

Message affiché Description du message

Action successfully returned the Google Workspace Directory user list.

No users were returned.

 L'action a réussi.
Failed to connect to the Google Workspace! 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 décrit les valeurs de sortie des résultats du script lorsque vous utilisez l'action Lister les utilisateurs :

Nom du résultat du script Valeur
is_success True ou False

Ping

Utilisez l'action Ping pour tester la connectivité à Google Workspace.

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

Entrées d'action

Aucun

Sorties d'action

L'action Ping fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Table du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Non disponible
Résultat du script Disponible
Résultat du script

Le tableau suivant décrit les valeurs de la sortie des résultats du script lorsque vous utilisez l'action Ping :

Nom du résultat du script Valeur
is_success True ou False

Retirer des membres d'un groupe

Utilisez l'action Supprimer des membres d'un groupe pour supprimer des membres d'un groupe Google Workspace.

Cette action s'exécute sur l'entité User de Google SecOps.

Vous pouvez utiliser l'action Lister les utilisateurs pour résoudre les cas d'utilisation suivants :

  • Automatisez le départ des utilisateurs.
  • Gérez les groupes dynamiques.
  • Résolvez les problèmes de contrôle des accès.

Entrées d'action

L'action Remove Members From Group (Supprimer des membres d'un groupe) nécessite les paramètres suivants :

Paramètre Description
Group Email Address

Obligatoire.

Adresse e-mail du groupe dont les membres doivent être supprimés.
User Email Addresses

Facultatif.

Liste d'utilisateurs à supprimer du groupe, séparés par une virgule.

L'action exécute les valeurs que vous configurez pour ce paramètre en même temps que l'entité User.

Sorties d'action

L'action Retirer des membres d'un groupe fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Table du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Non disponible
Résultat du script Disponible
Résultat du script

Le tableau suivant décrit les valeurs de la sortie des résultats du script lorsque vous utilisez l'action Supprimer des membres du groupe :

Nom du résultat du script Valeur
is_success True ou False

Révoquer les sessions utilisateur

Utilisez l'action Révoquer les sessions utilisateur pour révoquer les sessions Web et sur appareil de l'utilisateur, et réinitialiser ses cookies de connexion dans Google Workspace.

Cette action s'exécute sur l'entité User de Google SecOps.

Entrées d'action

L'action Révoquer les sessions utilisateur nécessite les paramètres suivants :

Paramètre Description
User Email Addresses

Facultatif.

Liste d'utilisateurs à déconnecter, séparés par une virgule. L'action exécute les valeurs de ce paramètre avec les entités User de Google SecOps.

Sorties d'action

L'action Révoquer les sessions utilisateur fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Table 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 Révoquer les sessions utilisateur :

[
   {
       "Entity": "ENTITY_ID",
       "EntityResult": {
           "Status": "done"
       }
   }
]
Messages de sortie

L'action Révoquer les sessions utilisateur peut renvoyer les messages de sortie suivants :

Message affiché Description du message

Successfully signed out the following users using Google Workspace: USERS

Action wasn't able to sign out the following users using Google Workspace: USERS

None of the provided users were found in Google Workspace.

L'action a réussi.
Error executing action "Revoke User Sessions". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Révoquer les sessions utilisateur :

Nom du résultat du script Valeur
is_success True ou False

Rechercher des événements d'activité utilisateur

Utilisez l'action Rechercher des événements d'activité utilisateur pour récupérer les événements d'activité d'une application pour une entité User Google SecOps spécifiée.

Cette action s'exécute sur l'entité User de Google SecOps.

Entrées d'action

L'action Rechercher des événements d'activité utilisateur nécessite les paramètres suivants :

Paramètre Description
User Email Addresses

Facultatif.

Liste d'adresses e-mail d'utilisateurs supplémentaires à traiter, séparées par une virgule.

L'action traite tous les utilisateurs de cette liste, en plus d'une entité User (si elle est fournie).
Application Names

Obligatoire.

Liste des applications pour lesquelles interroger les événements d'activité.

Pour obtenir la liste complète des applications compatibles, consultez la documentation ApplicationName.
Event Type Filter

Facultatif.

Liste des types d'événements à récupérer, séparés par une virgule.
Time Frame

Facultatif.

Période pour la recherche d'activité.

Les valeurs possibles sont les suivantes :

  • Last Hour
  • Last 6 Hours
  • Last 24 Hours
  • Last Week
  • Last Month
  • Custom

Si Custom est sélectionné, le paramètre Start Time est obligatoire.

La valeur par défaut est Last Hour.
Start Time

Facultatif.

Début de la période pour la recherche d'activité.

Ce paramètre est obligatoire si Custom est sélectionné pour le paramètre Time Frame.

Configurez la valeur au format ISO 8601.
End Time

Facultatif.

Fin de la période pour la recherche d'activité.

Ce paramètre est facultatif lorsque Custom est sélectionné pour le paramètre Time Frame. S'il n'est pas fourni, il est défini par défaut sur l'heure actuelle.

Configurez la valeur au format ISO 8601.
Max Events To Return

Obligatoire.

Nombre maximal d'événements à renvoyer par utilisateur.

L'action traite un maximum de 1000 événements par utilisateur et par application.

La valeur par défaut est 200.

La valeur maximale est de 1000.

Sorties d'action

L'action Rechercher des événements d'activité utilisateur fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Table 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 Rechercher des événements d'activité utilisateur :

{
   "Entity": "user@example.com",
   "EntityResult": [
      {
         "applicationName": "login",
         "type": "login",
         "name": "login_success",
         "parameters": [
            {
               "name": "login_type",
               "value": "google_password"
            },
            {
               "name": "login_challenge_method",
               "multiValue": [
                  "password"
               ]
            },
            {
               "name": "is_suspicious",
               "boolValue": false
            }
         ]
      },
      {
         "applicationName": "token",
         "type": "auth",
         "name": "authorize",
         "parameters": [
            {
               "name": "client_id",
               "value": "example-client-id.apps.googleusercontent.com"
            },
            {
               "name": "app_name",
               "value": "Google Chrome"
            },
            {
               "name": "client_type",
               "value": "NATIVE_DESKTOP"
            },
            {
               "name": "scope_data",
               "multiMessageValue": [
                  {
                     "parameter": [
                        {
                           "name": "scope_name",
                           "value": "https://www.google.com/accounts/OAuthLogin"
                        },
                        {
                           "name": "product_bucket",
                           "multiValue": [
                              "IDENTITY"
                           ]
                        }
                     ]
                  }
               ]
            },
            {
               "name": "scope",
               "multiValue": [
                  "https://www.google.com/accounts/OAuthLogin"
               ]
            }
         ]
      }
   ]
}
Messages de sortie

L'action Rechercher des événements d'activité utilisateur peut renvoyer les messages de sortie suivants :

Message affiché Description du message

Successfully found events for the following users in Google Workspace: USERS.

No events were found for the following users in Google Workspace: USERS.

No events were found for the provided users in Google Workspace.

 L'action a réussi.
Error executing action "Search User Activity Events". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lorsque vous utilisez l'action Rechercher des événements d'activité utilisateur :

Nom du résultat du script Valeur
is_success True ou False

Mettre à jour l'UO

Utilisez l'action Mettre à jour l'UO pour mettre à jour une unité organisationnelle (UO).

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

Vous pouvez utiliser l'action Mettre à jour l'UO pour résoudre les cas d'utilisation suivants :

  • Gérez les groupes de sécurité.
  • Automatiser l'intégration et la suppression des utilisateurs
  • Implémentez des règles de séparation des données.

Entrées d'action

L'action Mettre à jour l'UO nécessite les paramètres suivants :

Paramètre Description
Customer ID

Obligatoire.

ID unique du compte Google Workspace du client.

Pour représenter la valeur customerId du compte, utilisez l'espace réservé my_customer.
Name

Facultatif.

Nom de l'UO.
Description

Facultatif.

Description de l'UO.
OU Path

Obligatoire.

Chemin d'accès complet à l'UO.

Si l'UO se trouve sous le chemin racine /, ne fournissez que le nom de l'UO sans chemin d'accès.

Sorties d'action

L'action Mettre à jour l'UO fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Table du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Non disponible
Résultat du script Disponible
Résultat du script

Le tableau suivant décrit les valeurs de sortie des résultats du script lorsque vous utilisez l'action Mettre à jour l'UO :

Nom du résultat du script Valeur
is_success True ou False

Mettre à jour le compte utilisateur

Utilisez l'action Mettre à jour l'utilisateur pour mettre à jour un utilisateur du répertoire Google Workspace.

Cette action ne s'applique pas aux entités Google SecOps.

Vous pouvez utiliser l'action Mettre à jour l'utilisateur pour résoudre les cas d'utilisation suivants :

  • Désactivez le compte piraté.
  • Appliquez une réinitialisation du mot de passe après avoir détecté une activité suspecte.
  • Mettez à jour les informations sur le service après avoir transféré un employé.
  • Suspendez les comptes inactifs.

Entrées d'action

L'action Mettre à jour l'utilisateur nécessite les paramètres suivants :

Paramètre Description
Email Address

Obligatoire.

Liste d'adresses e-mail principales séparées par une virgule, utilisées pour identifier les utilisateurs à modifier.
Given Name

Facultatif.

Prénom de l'utilisateur.
Family Name

Facultatif.

Nom de famille de l'utilisateur.
Password

Facultatif.

Mot de passe du nouvel utilisateur.
Phone

Facultatif.

Numéro de téléphone de l'utilisateur.

Cette action met à jour le type de numéro de téléphone custom.
Gender

Facultatif.

Genre de l'utilisateur.

Les valeurs valides sont les suivantes : female, male, other, unknown.
Department

Facultatif.

Nom du service de l'utilisateur.
Organization

Facultatif.

Nom de l'organisation de l'utilisateur.
Change Password At Next Login

Facultatif.

Si cette option est sélectionnée, le système exige que l'utilisateur modifie son mot de passe lors de sa prochaine tentative de connexion.

Par défaut, cette option n'est pas sélectionnée.
User Status

Facultatif.

État de l'utilisateur à modifier.

Par défaut, l'action ne modifie pas l'état de l'utilisateur.

Les valeurs possibles sont les suivantes :
  • Not Changed
  • Blocked
  • Unblocked

Sorties d'action

L'action Mettre à jour l'utilisateur fournit les sorties suivantes :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Table 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 Mettre à jour l'utilisateur fournit les messages de sortie suivants :

Message affiché Description du message

Successfully updated the following users in Google Workspace: EMAIL_ADDRESSES.

Action wasn't able to update the following users in Google Workspace: EMAIL_ADDRESSES

None of the provided users were updated.

 L'action a réussi.
Error executing action "Update User". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.
Résultat du script

Le tableau suivant décrit les valeurs de sortie des résultats du script lorsque vous utilisez l'action Mettre à jour l'utilisateur :

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.