Intégrer Microsoft Entra ID à Google SecOps
Ce document explique comment intégrer Microsoft Entra ID à Google Security Operations (Google SecOps).
Cette intégration utilise un ou plusieurs composants Open Source. Vous pouvez télécharger une copie compressée du code source complet de cette intégration à partir du bucket Cloud Storage.
Cas d'utilisation
L'intégration de Microsoft Entra ID à Google SecOps peut vous aider à résoudre les cas d'utilisation suivants :
Gestion des comptes utilisateur : utilisez les fonctionnalités de Google SecOps pour automatiser la désactivation et l'activation des comptes utilisateur dans Microsoft Entra ID en fonction d'événements liés à la sécurité, tels qu'une suspicion de compromission ou le départ d'un employé.
Réinitialisation du mot de passe : utilisez les fonctionnalités de Google SecOps pour orchestrer la réinitialisation des mots de passe des comptes piratés ou des utilisateurs dont le compte est verrouillé. La réinitialisation des mots de passe peut vous aider à simplifier le processus de récupération des mots de passe et à réduire le nombre de demandes d'assistance.
Gestion des groupes : utilisez les fonctionnalités de Google SecOps pour automatiser la création, la modification et la suppression de groupes Microsoft Entra ID.
Application des règles d'accès conditionnel : utilisez les règles d'accès conditionnel Microsoft Entra ID dans les playbooks Google SecOps pour contrôler l'accès de manière dynamique en fonction du contexte et permettre un contrôle précis de l'accès aux ressources en fonction de facteurs tels que l'emplacement, l'appareil et le risque utilisateur.
Alertes de sécurité et réponse aux incidents : intégrez les alertes de sécurité Microsoft Entra ID à Google SecOps pour automatiser les workflows de réponse aux incidents.
Avant de commencer
Avant de configurer l'intégration dans Google SecOps, vérifiez que les conditions suivantes sont remplies dans votre environnement Microsoft :
Enregistrement d'une application Azure : vous devez enregistrer une application dans le centre d'administration Microsoft Entra pour obtenir un ID client et un ID de locataire.
Pour obtenir des instructions détaillées, consultez Inscrire une application dans Microsoft Entra ID.
Autorisations d'API : accordez les autorisations d'application Microsoft Graph > suivantes à votre application et fournissez le consentement administrateur :
Directory.Read.AllDirectory.ReadWrite.AllGroup.ReadWrite.AllUser.ReadWrite.AllAuditLog.Read.All(obligatoire pour utiliser le paramètre Inclure les détails de l'authentification multifacteur)
Attributions de rôles : pour exécuter des actions liées aux mots de passe, telles que Forcer la mise à jour du mot de passe ou Réinitialiser le mot de passe utilisateur, vous devez attribuer le rôle
Password Administratorà votre application dans Microsoft Entra ID.Code secret du client : générez un code secret du client dans la section Certificats et secrets de votre application Azure. Enregistrez immédiatement la valeur du secret (et non l'ID du secret), car elle ne s'affiche qu'une seule fois et est requise pour la configuration.
Paramètres d'intégration
L'intégration de Microsoft Entra ID nécessite les paramètres suivants :
| Paramètre | Description |
|---|---|
Login API Root |
Optional
Racine de l'API utilisée pour s'authentifier auprès de la plate-forme d'identité Microsoft. La valeur par défaut est |
API Root |
Optional
Racine de l'API de l'instance Azure Active Directory. La valeur par défaut est |
Client ID |
Obligatoire
ID d'application (client) de votre compte Microsoft Entra ID. |
Client Secret |
Obligatoire
Valeur du code secret du client de votre compte Microsoft Entra ID. |
Directory ID |
Obligatoire
Valeur de l'ID d'annuaire (locataire) de votre compte Microsoft Entra ID. |
Verify SSL |
Optional
Si cette option est sélectionnée, l'intégration vérifie que le certificat SSL utilisé pour se connecter au serveur Microsoft Entra ID 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 prise en charge de plusieurs instances, consultez Prendre en charge plusieurs instances.
Actions
Pour en savoir plus sur les actions, consultez Répondre aux actions en attente depuis votre bureau et Exécuter une action manuelle dans votre demande.
Ajouter un utilisateur à un groupe
Utilisez l'action Ajouter un utilisateur à un groupe pour ajouter un utilisateur au groupe Microsoft Entra ID spécifique. Cette action nécessite que vous configuriez l'entité User au format username@domain.
Cette action s'exécute sur l'entité Google SecOps User.
Entrées de l'action
L'action Ajouter un utilisateur à un groupe nécessite les paramètres suivants :
| Paramètre | Description |
|---|---|
Group ID |
Obligatoire
ID du groupe Microsoft Entra ID auquel ajouter l'utilisateur, par exemple |
Sorties de l'action
L'action Ajouter un utilisateur à un groupe fournit les résultats suivants :
| Type de sortie de l'action | Disponibilité |
|---|---|
| Pièce jointe du mur des cas | Non disponible |
| Lien vers le mur des cas | Non disponible |
| Tableau du mur des cas | Non disponible |
| Table d'enrichissement | Non disponible |
| Résultat JSON | Non disponible |
| Messages de sortie | Disponible |
| Résultat du script | Disponible |
Messages de sortie
L'action Ajouter un utilisateur à un groupe peut renvoyer les messages de sortie suivants :
| Message de sortie | Description du message |
|---|---|
|
L'action a réussi. |
Member could not be added successfully. |
É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 Ajouter un utilisateur à un groupe :
| Nom du résultat du script | Valeur |
|---|---|
is_success |
True ou False |
Désactiver le compte
Utilisez l'action Désactiver le compte pour désactiver un compte dans Microsoft Entra ID.
Cette action nécessite que vous configuriez l'entité User au format username@domain.
Pour exécuter l'action Désactiver le compte, accordez des droits d'administrateur au compte Microsoft Entra ID que vous utilisez dans l'intégration.
Cette action s'exécute sur l'entité Google SecOps User.
Configurer des autorisations supplémentaires
L'action Désactiver le compte nécessite que vous configuriez également l'autorisation d'API suivante pour l'application :
User.EnableDisableAccount.All
Pour savoir comment configurer les autorisations d'API dans Microsoft Entra ID, consultez la section Configurer les autorisations d'API de ce document.
Entrées de l'action
Aucune.
Sorties de l'action
L'action Désactiver le compte fournit les résultats suivants :
| Type de sortie de l'action | Disponibilité |
|---|---|
| Pièce jointe du mur des cas | Non disponible |
| Lien vers le mur des cas | Non disponible |
| Tableau du mur des cas | Non disponible |
| Table d'enrichissement | Non disponible |
| Résultat JSON | Non disponible |
| Messages de sortie | Disponible |
| Résultat du script | Disponible |
Messages de sortie
L'action Désactiver le compte peut renvoyer les messages de sortie suivants :
| Message de sortie | Description du message |
|---|---|
|
L'action a réussi. |
Disable user account was not successful. |
É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 indique la valeur de la sortie du résultat du script lorsque vous utilisez l'action Désactiver le compte :
| Nom du résultat du script | Valeur |
|---|---|
is_success |
True ou False |
Activer le compte
Utilisez l'action Activer le compte pour activer un compte dans Microsoft Entra ID.
Cette action nécessite que vous configuriez l'entité User au format username@domain.
Cette action s'exécute sur l'entité Google SecOps User.
Configurer des autorisations supplémentaires
L'action Activer le compte nécessite que vous configuriez également l'autorisation d'API suivante pour l'application :
User.EnableDisableAccount.All
Pour savoir comment configurer les autorisations d'API dans Microsoft Entra ID, consultez la section Configurer les autorisations d'API de ce document.
Entrées de l'action
Aucune.
Sorties de l'action
L'action Activer le compte fournit les résultats suivants :
| Type de sortie de l'action | Disponibilité |
|---|---|
| Pièce jointe du mur des cas | Non disponible |
| Lien vers le mur des cas | Non disponible |
| Tableau du mur des cas | Non disponible |
| Table d'enrichissement | Non disponible |
| Résultat JSON | Non disponible |
| Messages de sortie | Disponible |
| Résultat du script | Disponible |
Messages de sortie
L'action Activer le compte peut renvoyer les messages de sortie suivants :
| Message de sortie | Description du message |
|---|---|
|
L'action a réussi. |
Enable user account was not successful. |
Échec de l'action. Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants. |
Résultat du script
Le tableau suivant liste la valeur de la sortie du résultat du script lors de l'utilisation de l'action Activer le compte :
| Nom du résultat du script | Valeur |
|---|---|
is_success |
True ou False |
Enrichir l'hôte
Utilisez l'action Enrichir l'hôte pour enrichir l'entité Google SecOps Host avec des informations provenant de Microsoft Entra ID. Cette action recherche une correspondance pour une entité Host fournie à l'aide du champ displayName de l'appareil dans Microsoft Entra ID.
Cette action s'exécute sur l'entité Google SecOps Host.
Entrées de l'action
Aucune.
Sorties de l'action
L'action Enrichir l'hôte 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 des entités | Disponible |
| Résultat JSON | Disponible |
| Messages de sortie | Disponible |
| Résultat du script | Disponible |
Table d'enrichissement des entités
L'action Enrichir l'hôte accepte l'enrichissement d'entité suivant :
| Champ d'enrichissement | Logique |
|---|---|
AAD_Name |
Renvoie si elle existe dans le résultat JSON. |
AAD_Enabled |
Renvoie si elle existe dans le résultat JSON. |
AAD_Property Device ID |
Renvoie si elle existe dans le résultat JSON. |
AAD_OS |
Renvoie si elle existe dans le résultat JSON. |
AAD_Version |
Renvoie si elle existe dans le résultat JSON. |
AAD_Profile Type |
Renvoie si elle existe dans le résultat JSON. |
AAD_Compliant |
Renvoie si elle existe dans le résultat JSON. |
AAD_Last Sign In |
Renvoie si elle existe dans le résultat JSON. |
Résultat JSON
L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Enrich Host (Enrichir l'hôte) :
[
{
"EntityResult": {
"deletedDateTime": "1234569",
"complianceExpirationDateTime": "1234567",
"profileType": "RegisteredDevice",
"key": "007",
"if":"889922-aaaa-123123"
},
"Entity": "us-lt-v13001"
}
]
Messages de sortie
L'action Enrich Host peut renvoyer les messages de sortie suivants :
| Message de sortie | Description du message |
|---|---|
|
L'action a réussi. |
Host details were not found. |
É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 Enrichir l'hôte :
| Nom du résultat du script | Valeur |
|---|---|
is_success |
True ou False |
Enrichir l'utilisateur
Utilisez l'action Enrichir l'utilisateur pour enrichir l'entité Google SecOps User avec des informations provenant de Microsoft Entra ID. Cette action nécessite que vous configuriez l'entité User au format username@domain.
Cette action s'exécute sur l'entité Google SecOps Host.
Entrées de l'action
L'action Enrichir l'utilisateur nécessite les paramètres suivants :
| Paramètre | Description |
|---|---|
Include MFA Details |
Facultatif. Si cette option est sélectionnée, l'action renvoie les détails de MFA de l'utilisateur. |
Include Last Sign In Details |
Facultatif. Si cette option est sélectionnée, l'action récupère l'activité de connexion de l'utilisateur (y compris les codes temporels de connexion interactifs et non interactifs). |
Sorties de l'action
L'action Enrichir l'utilisateur 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 des entités | Disponible |
| Résultat JSON | Disponible |
| Messages de sortie | Disponible |
| Résultat du script | Disponible |
Table d'enrichissement des entités
L'action Enrichir l'utilisateur accepte l'enrichissement d'entité suivant :
| Champ d'enrichissement | Logique |
|---|---|
AAD_Name |
Renvoie si elle existe dans le résultat JSON. |
AAD_Mobile Phone |
Renvoie si elle existe dans le résultat JSON. |
AAD_Preferred Language |
Renvoie si elle existe dans le résultat JSON. |
AAD_Job Title |
Renvoie si elle existe dans le résultat JSON. |
AAD_Username |
Renvoie si elle existe dans le résultat JSON. |
Résultat JSON
L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Enrich User :
[
{
"Entity": "user@domain.com",
"EntityResult": {
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users/$entity",
"accountEnabled": true,
"ageGroup": null,
"businessPhones": [],
"city": "New York",
"companyName": "ExampleCorp",
"consentProvidedForMinor": null,
"country": "US",
"createdDateTime": "2025-01-01T00:00:00Z",
"creationType": null,
"department": "Security",
"displayName": "User Name",
"mail": "user@domain.com",
"employeeId": "12345",
"employeeHireDate": null,
"employeeType": null,
"externalUserStateChangeDateTime": null,
"faxNumber": null,
"givenName": "User",
"imAddresses": [],
"externalUserState": null,
"jobTitle": "Security Analyst",
"surname": "Surname",
"lastPasswordChangeDateTime": "2025-01-01T00:00:00Z",
"legalAgeGroupClassification": null,
"mailNickname": "usernickname",
"mobilePhone": "+11234567890",
"id": "user-id-12345",
"officeLocation": null,
"onPremisesSamAccountName": null,
"onPremisesDistinguishedName": null,
"onPremisesDomainName": null,
"onPremisesImmutableId": null,
"onPremisesLastSyncDateTime": null,
"onPremisesProvisioningErrors": [],
"onPremisesSecurityIdentifier": null,
"onPremisesSyncEnabled": null,
"onPremisesUserPrincipalName": null,
"otherMails": [],
"passwordPolicies": "None",
"preferredDataLocation": null,
"preferredLanguage": "en-US",
"proxyAddresses": [],
"signInSessionsValidFromDateTime": "2025-01-01T00:00:00Z",
"state": "NY",
"streetAddress": "123 Main St",
"usageLocation": "US",
"userPrincipalName": "user@domain.com",
"userType": "Member",
"postalCode": "10001",
"deletedDateTime": null,
"showInAddressList": null,
"isResourceAccount": null,
"refreshTokensValidFromDateTime": "2025-01-01T00:00:00Z",
"employeeOrgData": null,
"passwordProfile": null,
"authorizationInfo": {
"certificateUserIds": []
},
"mfa_details": {
"id": "user-id-12345",
"userPrincipalName": "user@domain.com",
"userDisplayName": "User Name",
"userType": "member",
"isAdmin": false,
"isSsprRegistered": true,
"isSsprEnabled": true,
"isSsprCapable": true
"isMfaRegistered": true,
"isMfaCapable": true,
"isPasswordlessCapable": false,
"methodsRegistered": [
"email",
"mobilePhone"
],
"defaultMfaMethod": "mobilePhone",
"isSystemPreferredAuthenticationMethodEnabled": false,
"systemPreferredAuthenticationMethods": [],
"userPreferredMethodForSecondaryAuthentication": "oath",
"lastUpdatedDateTime": "2026-01-01T00:00:00Z"
}
}
}
]
Messages de sortie
L'action Enrichir l'utilisateur peut renvoyer les messages de sortie suivants :
| Message de sortie | Description du message |
|---|---|
|
L'action a réussi. |
Users list fetch was not successful. |
Échec de l'action. Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants. |
Résultat du script
Le tableau suivant liste la valeur de la sortie du résultat du script lors de l'utilisation de l'action Enrichir l'utilisateur :
| Nom du résultat du script | Valeur |
|---|---|
is_success |
True ou False |
Forcer la mise à jour du mot de passe
Utilisez l'action Forcer la mise à jour du mot de passe pour forcer l'utilisateur à mettre à jour son mot de passe. Cette action oblige l'utilisateur à modifier son mot de passe lors de sa prochaine tentative de connexion.
L'action Forcer la mise à jour du mot de passe attend que vous configuriez l'entité User au format username@domain.
Cette action s'exécute sur l'entité Google SecOps User.
Configurer des autorisations supplémentaires
L'action Forcer la mise à jour du mot de passe nécessite que vous configuriez également l'autorisation d'API suivante pour l'application :
User-PasswordProfile.ReadWrite.All
Pour savoir comment configurer les autorisations d'API dans Microsoft Entra ID, consultez la section Configurer les autorisations d'API de ce document.
Attribuer un rôle à votre application
L'action Forcer la mise à jour du mot de passe nécessite que vous attribuiez le rôle Password
Administrator à votre application.
Pour attribuer le rôle Password Administrator à votre application, procédez comme suit :
- Connectez-vous au portail Azure à l'aide de votre compte Microsoft.
- Dans Microsoft Entra ID, recherchez Roles and administrators (Rôles et administrateurs).
- Sélectionnez ou recherchez le rôle
Password Administratordans la liste. - Cliquez sur Ajouter une attribution.
- Sélectionnez un compte (membre) que vous utilisez dans l'intégration, puis cliquez sur Suivant.
- Saisissez une justification pour l'attribution d'un rôle.
- Cliquez sur Attribuer.
Entrées de l'action
Aucune.
Sorties de l'action
L'action Forcer la mise à jour du mot de passe fournit les résultats suivants :
| Type de sortie de l'action | Disponibilité |
|---|---|
| Pièce jointe du mur des cas | Non disponible |
| Lien vers le mur des cas | Non disponible |
| Tableau du mur des cas | Non disponible |
| Table d'enrichissement | Non disponible |
| Résultat JSON | Non disponible |
| Messages de sortie | Disponible |
| Résultat du script | Disponible |
Messages de sortie
L'action Forcer la mise à jour du mot de passe peut renvoyer les messages de sortie suivants :
| Message de sortie | Description du message |
|---|---|
|
L'action a réussi. |
Attempt to Force user password update was not successful.
|
É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 Forcer la mise à jour du mot de passe :
| Nom du résultat du script | Valeur |
|---|---|
is_success |
True ou False |
Obtenir les coordonnées du responsable
Utilisez l'action Obtenir les coordonnées du responsable pour obtenir les coordonnées du responsable de l'utilisateur.
L'action Obtenir les coordonnées du responsable attend que vous configuriez l'entité User au format username@domain.
Cette action s'exécute sur l'entité Google SecOps User.
Entrées de l'action
L'action Obtenir les coordonnées du responsable nécessite le paramètre suivant :
| Paramètre | Description |
|---|---|
Fields To Return |
Facultatif. Liste d'attributs de profil de responsable spécifiques à récupérer, séparés par une virgule. Si aucune valeur n'est fournie, l'action renvoie l'ensemble d'attributs par défaut défini par l'API. La valeur par défaut est |
Include MFA Details |
Facultatif. Si cette option est sélectionnée, l'action renvoie les détails de MFA de l'utilisateur. |
Include Last Sign In Details |
Facultatif. Si cette option est sélectionnée, l'action récupère l'activité de connexion de l'utilisateur (y compris les codes temporels de connexion interactifs et non interactifs). |
Sorties de l'action
L'action Obtenir les coordonnées du responsable 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 | Disponible |
| Table d'enrichissement des entités | Disponible |
| Résultat JSON | Disponible |
| Messages de sortie | Disponible |
| Résultat du script | Disponible |
Tableau du mur des cas
L'action Obtenir les coordonnées du responsable peut renvoyer le tableau suivant dans Google SecOps :
Nom de la table : Manager contact
Colonnes :
- Nom
- Numéro de téléphone
Table d'enrichissement des entités
L'action Obtenir les coordonnées du responsable est compatible avec l'enrichissement d'entité suivant :
| Champ d'enrichissement | Logique |
|---|---|
Display Name |
Renvoie si elle existe dans le résultat JSON. |
Mobile Phone |
Renvoie si elle existe dans le résultat JSON. |
@odata.context |
Renvoie si elle existe dans le résultat JSON. |
AAD_Job Title |
Renvoie si elle existe dans le résultat JSON. |
AAD_Username |
Renvoie si elle existe dans le résultat JSON. |
Résultat JSON
L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Obtenir les coordonnées du responsable :
[
{
"Entity": "user@example.com",
"EntityResult": {
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users/$entity",
"accountEnabled": true,
"ageGroup": null,
"businessPhones": [],
"city": "Anytown",
"companyName": "Example Corporation",
"consentProvidedForMinor": null,
"country": "US",
"createdDateTime": "2025-01-01T00:00:00Z",
"creationType": null,
"department": "Security Operations",
"displayName": "Internal User",
"mail": "user@example.com",
"employeeId": "ID-00001",
"employeeHireDate": null,
"employeeType": "Full-time",
"externalUserStateChangeDateTime": null,
"faxNumber": null,
"givenName": "Alex",
"imAddresses": [],
"externalUserState": null,
"jobTitle": "Security Lead",
"surname": "Doe",
"lastPasswordChangeDateTime": "2025-01-01T00:00:00Z",
"legalAgeGroupClassification": null,
"mailNickname": "alexdoe",
"mobilePhone": "+1 555-0100",
"id": "00000000-0000-0000-0000-000000000000",
"officeLocation": null,
"usageLocation": "US",
"userPrincipalName": "user@example.com",
"userType": "Member",
"postalCode": "00000",
"deletedDateTime": null,
"showInAddressList": null,
"isResourceAccount": null,
"refreshTokensValidFromDateTime": "2025-01-01T00:00:00Z",
"employeeOrgData": null,
"authorizationInfo": {
"certificateUserIds": []
},
"sponsors": [],
"mfa_details": {
"id": "00000000-0000-0000-0000-000000000000",
"userPrincipalName": "user@example.com",
"userDisplayName": "Internal User",
"userType": "member",
"isAdmin": true,
"isSsprRegistered": false,
"isSsprEnabled": true,
"isSsprCapable": false,
"isMfaRegistered": true,
"isMfaCapable": true,
"isPasswordlessCapable": false,
"methodsRegistered": [
"mobilePhone",
"softwareOneTimePasscode"
],
"defaultMfaMethod": "softwareOneTimePasscode",
"isSystemPreferredAuthenticationMethodEnabled": true,
"systemPreferredAuthenticationMethods": [
"SoftwareOTP"
],
"userPreferredMethodForSecondaryAuthentication": "oath",
"lastUpdatedDateTime": "2026-01-01T00:00:00Z"
}
}
}
]
Messages de sortie
L'action Obtenir les coordonnées du responsable peut renvoyer les messages de sortie suivants :
| Message de sortie | Description du message |
|---|---|
|
L'action a réussi. |
Could not fetch user manager's details successfully. |
Échec de l'action. Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants. |
Résultat du script
Le tableau suivant liste la valeur de la sortie du résultat du script lorsque vous utilisez l'action Obtenir les coordonnées du responsable :
| Nom du résultat du script | Valeur |
|---|---|
is_success |
True ou False |
L'utilisateur est-il dans le groupe ?
Utilisez l'action Is User in Group (L'utilisateur est-il dans le groupe ?) pour vérifier si l'utilisateur est membre d'un groupe Microsoft Entra ID spécifique. Cette action nécessite que vous configuriez l'entité User au format username@domain.
Cette action s'exécute sur l'entité Google SecOps User.
Entrées de l'action
L'action L'utilisateur est-il dans le groupe nécessite les paramètres suivants :
| Paramètre | Description |
|---|---|
Group ID |
Obligatoire
ID du groupe Microsoft Entra ID auquel ajouter l'utilisateur, par exemple |
Sorties de l'action
L'action Is User in Group (L'utilisateur est-il dans le groupe) fournit les résultats suivants :
| Type de sortie de l'action | Disponibilité |
|---|---|
| Pièce jointe du mur des cas | Non disponible |
| Lien vers le mur des cas | Non disponible |
| Tableau du mur des cas | Non disponible |
| Table d'enrichissement | Non disponible |
| Résultat JSON | Disponible |
| Messages de sortie | Disponible |
| Résultat du script | Disponible |
Résultat JSON
L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Is User in Group (L'utilisateur est-il dans le groupe) :
[
{
"EntityResult": "true",
"Entity": "user@example.com"
}
]
Messages de sortie
L'action L'utilisateur est-il dans le groupe peut renvoyer les messages de sortie suivants :
| Message de sortie | Description du message |
|---|---|
|
L'action a réussi. |
User was not found in the group. |
É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 L'utilisateur est-il dans le groupe :
| Nom du résultat du script | Valeur |
|---|---|
is_success |
True ou False |
Répertorier les groupes
Utilisez l'action Lister les groupes pour lister les groupes Microsoft Entra ID à l'aide des critères de recherche spécifiés.
Pour l'action Répertorier les groupes, le filtrage fonctionne avec le champ Name.
Cette action ne s'exécute pas sur les entités Google SecOps.
Entrées de l'action
L'action Lister les groupes nécessite les paramètres suivants :
| Paramètre | Description |
|---|---|
Order By |
Optional
Ordre de tri des groupes renvoyés par leur nom. La valeur par défaut est Les valeurs possibles sont les suivantes :
|
Results Limit |
Optional
Nombre maximal de groupes à renvoyer. |
Filter Logic |
Optional
Logique permettant de filtrer les groupes par nom. La valeur par défaut est Les valeurs possibles sont les suivantes :
|
Filter Value |
Optional
Valeur permettant de filtrer les groupes à l'aide de la logique de filtre sélectionnée. Cette valeur s'applique au nom du groupe. Si vous sélectionnez Si vous ne définissez pas de valeur, le filtre ne s'applique pas. |
Sorties de l'action
L'action Lister les groupes 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 | Disponible |
| Table d'enrichissement des entités | Disponible |
| Résultat JSON | Disponible |
| Messages de sortie | Disponible |
| Résultat du script | Disponible |
Tableau du mur des cas
L'action Lister les groupes peut renvoyer le tableau suivant dans Google SecOps :
Nom de la table : Groups
Colonnes :
- Nom
- ID
- Description
- Messagerie
- Date et heure de création
- Type de groupe
Table d'enrichissement des entités
L'action Lister les groupes accepte l'enrichissement d'entité suivant :
| Champ d'enrichissement | Logique |
|---|---|
Group Type |
Renvoie si elle existe dans le résultat JSON. |
ID |
Renvoie si elle existe dans le résultat JSON. |
Name |
Renvoie si elle existe dans le résultat JSON. |
Description |
Renvoie si elle existe dans le résultat JSON. |
Created Time |
Renvoie si elle existe dans le résultat JSON. |
Résultat JSON
L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Lister les groupes :
[
{
"Group_Type": "managed",
"Id": "1212-12312-123",
"Name": "Group Name",
"Description": "This group is ...",
"Created_Time": "2019-10-24T19:10:18Z",
"onPremisesSamAccountName": "alext"
}
]
Messages de sortie
L'action Lister les groupes peut renvoyer les messages de sortie suivants :
| Message de sortie | Description du message |
|---|---|
|
L'action a réussi. |
Groups list fetch was not successful. |
É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 Lister les groupes :
| Nom du résultat du script | Valeur |
|---|---|
is_success |
True ou False |
Lister les membres du groupe
Utilisez l'action Répertorier les membres du groupe pour lister les membres du groupe Microsoft Entra ID spécifié.
La logique de filtrage fonctionne en fonction de la valeur du paramètre Filter Key.
Cette action ne s'exécute pas sur les entités Google SecOps.
Entrées de l'action
L'action Lister les membres du groupe nécessite les paramètres suivants :
| Paramètre | Description |
|---|---|
Max Records To Return |
Optional
Nombre maximal d'enregistrements à renvoyer. La valeur par défaut est 50. |
Group Name |
Optional
Nom du groupe Microsoft Entra ID dont vous souhaitez lister les membres. |
Group ID |
Optional
ID du groupe Microsoft Entra ID dont vous souhaitez lister les membres. Si vous configurez les paramètres |
Filter Key |
Optional
Champ permettant de filtrer les membres du groupe, par exemple Les valeurs possibles sont les suivantes :
|
Filter Logic |
Optional
Logique à appliquer au filtre. Les valeurs possibles sont les suivantes :
|
Filter Value |
Optional
Valeur à utiliser pour filtrer les membres du groupe en fonction des valeurs de paramètre Si vous sélectionnez Si vous ne définissez pas de valeur, le filtre ne s'applique pas. |
Sorties de l'action
L'action Lister les membres du groupe 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 | Disponible |
| Table d'enrichissement | Non disponible |
| Résultat JSON | Disponible |
| Messages de sortie | Disponible |
| Résultat du script | Disponible |
Tableau du mur des cas
L'action Lister les membres du groupe peut renvoyer le tableau suivant dans Google SecOps :
Nom du tableau : Membres disponibles du groupe
Colonnes :
- ID
- Nom principal de l'utilisateur
- Nom à afficher
- Surname
- Prénom
- Messagerie
- Fonction
- Téléphones professionnels
- Téléphone mobile
- Emplacement du bureau
- Langue préférée
Résultat JSON
L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Lister les membres du groupe :
[
{
"@odata.type": "#microsoft.graph.user",
"id": "b786d3cf-e97d-4511-b61c-0559e9f4da75",
"businessPhones": [],
"displayName": "Alex T",
"givenName": "Alex",
"jobTitle": "Software Engineer",
"mail": "alex.t@example.com",
"mobilePhone": null,
"officeLocation": "Building A",
"preferredLanguage": "en-US",
"surname": "T",
"userPrincipalName": "alex.t@example.com"
}
]
Messages de sortie
L'action Répertorier les membres du groupe peut renvoyer les messages de sortie suivants :
| Message de sortie | Description du message |
|---|---|
|
L'action a réussi. |
Error executing action "List Members in the Group". 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 Lister les membres du groupe :
| Nom du résultat du script | Valeur |
|---|---|
is_success |
True ou False |
Lister les groupes d'utilisateurs
Utilisez l'action Lister les groupes d'utilisateurs pour lister les groupes Microsoft Entra ID dont l'utilisateur est membre.
Vous pouvez fournir le nom d'utilisateur en tant qu'entité ou paramètre d'entrée d'action. Si vous configurez le nom d'utilisateur à la fois comme entité et comme paramètre d'entrée, l'action utilise le paramètre d'entrée.
Pour configurer le nom d'utilisateur, suivez le format username@domain.
Cette action s'exécute sur l'entité Google SecOps Username.
Entrées de l'action
L'action Lister les groupes d'utilisateurs nécessite les paramètres suivants :
| Paramètre | Description |
|---|---|
User Name |
Optional
Liste de noms d'utilisateur séparés par une virgule pour lesquels récupérer les appartenances à des groupes, par exemple |
Return Only Security Enabled Groups |
Optional
Si cette option est sélectionnée, l'action ne renvoie que les groupes de sécurité auxquels l'utilisateur appartient. Non sélectionné par défaut. |
Return Detailed Groups Information |
Optional
Si cette option est sélectionnée, l'action renvoie des informations détaillées sur les groupes Microsoft Entra ID. Non sélectionné par défaut. |
Filter Key |
Optional
Clé à utiliser pour filtrer les groupes. La valeur par défaut est Les valeurs possibles sont les suivantes :
|
Filter Logic |
Optional
Logique à appliquer lors du filtrage des groupes. La valeur par défaut est Les valeurs possibles sont les suivantes :
|
Filter Value |
Optional
Valeur à utiliser pour filtrer les groupes. Si vous sélectionnez Si vous ne définissez pas de valeur, le filtre ne s'applique pas. |
Max Records To Return |
Optional
Nombre maximal d'enregistrements à renvoyer. Si vous ne définissez pas de valeur, l'action renvoie 50 enregistrements par défaut. |
Sorties de l'action
L'action Lister l'appartenance aux groupes de l'utilisateur 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 | Disponible |
| Table d'enrichissement | Non disponible |
| Résultat JSON | Disponible |
| Messages de sortie | Disponible |
| Résultat du script | Disponible |
Tableau du mur des cas
L'action Lister les groupes d'utilisateurs peut renvoyer le tableau suivant dans Google SecOps :
Nom de la table : Group Memberships
Colonnes :
- ID
- Nom à afficher
- Description
- Sécurité activée
- Identifiant de sécurité
- Date et heure de création
- Classification
- Visibilité
- Messagerie
- Messagerie activée
- Mail Nickname (Pseudo de messagerie)
Résultat JSON
L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Lister les groupes d'un utilisateur :
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(Edm.String)",
"value": [
"ID",
"ID",
"ID",
]
}
Messages de sortie
L'action Lister l'appartenance aux groupes de l'utilisateur peut renvoyer les messages de sortie suivants :
| Message de sortie | Description du message |
|---|---|
|
L'action a réussi. |
Error executing action "List User's Groups Membership". 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 Lister les groupes d'appartenance de l'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 Microsoft Entra ID à l'aide des critères de recherche spécifiés.
Pour l'action Lister les utilisateurs, le filtrage fonctionne avec le champ Username (userPrincipalName).
Cette action ne s'exécute pas sur les entités Google SecOps.
Entrées de l'action
L'action Lister les utilisateurs nécessite les paramètres suivants :
| Paramètre | Description |
|---|---|
Filter |
Optional
Champs à inclure dans les résultats. La valeur par défaut est Les valeurs possibles sont les suivantes :
|
Order By Field |
Optional
Champ selon lequel trier les résultats. La valeur par défaut est Les valeurs possibles sont les suivantes :
|
Order By |
Optional
Ordre des résultats (croissant ou décroissant). La valeur par défaut est Les valeurs possibles sont les suivantes :
|
Results Limit |
Optional
Nombre maximal d'utilisateurs à renvoyer. |
Advanced Filter Logic |
Optional
Logique à utiliser pour le filtrage avancé qui s'applique au champ La valeur par défaut est Les valeurs possibles sont les suivantes :
|
Advanced Filter Value |
Optional
Valeur à utiliser dans le filtre avancé pour le champ Si vous sélectionnez Si vous ne définissez pas de valeur, le filtre ne s'applique pas. |
Sorties de l'action
L'action Lister les utilisateurs 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 | Disponible |
| Table d'enrichissement des entités | Disponible |
| Résultat JSON | Disponible |
| Messages de sortie | Disponible |
| Résultat du script | Disponible |
Tableau du mur des cas
L'action Lister les utilisateurs peut renvoyer le tableau suivant dans Google SecOps :
Nom de la table : Users
Colonnes :
- Nom
- Username (Nom d'utilisateur)
- ID
- Prénom
- Langue préférée
- Messagerie
- Téléphone mobile
- Surname
- Fonction
Table d'enrichissement des entités
L'action Lister les utilisateurs est compatible avec l'enrichissement d'entité suivant :
| Champ d'enrichissement | Logique |
|---|---|
Username |
Renvoie si elle existe dans le résultat JSON. |
Surname |
Renvoie si elle existe dans le résultat JSON. |
Name |
Renvoie si elle existe dans le résultat JSON. |
Job Title |
Renvoie si elle existe dans le résultat JSON. |
Mail |
Renvoie si elle existe dans le résultat JSON. |
Résultat JSON
L'exemple suivant montre le résultat JSON reçu lors de l'utilisation de l'action Lister les utilisateurs :
[
{
"Group Type": "managed",
"Id": "ID",
"Name": "Example",
"Description": "Example",
"Created Time":"2019-10-24T19:10:18Z"
}
]
Messages de sortie
L'action Lister les utilisateurs peut renvoyer les messages de sortie suivants :
| Message de sortie | Description du message |
|---|---|
|
L'action a réussi. |
User list fetch was not successful. |
É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 Lister les utilisateurs :
| Nom du résultat du script | Valeur |
|---|---|
is_success |
True ou False |
Ping
Utilisez l'action Ping pour tester la connectivité à Microsoft Entra ID.
Cette action s'exécute sur toutes 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 | Non disponible |
| Messages de sortie | Disponible |
| Résultat du script | Disponible |
Messages de sortie
L'action Ping peut renvoyer les messages de sortie suivants :
| Message de sortie | Description du message |
|---|---|
|
L'action a réussi. |
Connection could not be established successfully. |
Échec de l'action. Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants. |
Résultat du script
Le tableau suivant répertorie la valeur de la sortie du résultat du script lorsque vous utilisez l'action Ping :
| Nom du résultat du script | Valeur |
|---|---|
is_success |
True ou False |
Supprimer l'utilisateur du groupe
Utilisez l'action Supprimer l'utilisateur du groupe pour supprimer un utilisateur du groupe spécifié dans Microsoft Entra ID.
Vous pouvez fournir le nom d'utilisateur en tant qu'entité ou paramètre d'entrée d'action. Si vous configurez le nom d'utilisateur à la fois comme entité et comme paramètre d'entrée, l'action utilise le paramètre d'entrée.
Pour configurer le nom d'utilisateur, suivez le format username@domain.
Cette action s'exécute sur l'entité Google SecOps Username.
Entrées de l'action
L'action Supprimer l'utilisateur du groupe nécessite les paramètres suivants :
| Paramètre | Description |
|---|---|
User Name |
Optional
Chaîne de noms d'utilisateur séparés par une virgule à supprimer du groupe spécifié.
Pour configurer cette valeur de paramètre, utilisez le format Si vous ne définissez pas de valeur, l'action s'exécute sur les noms d'utilisateur des entités utilisateur d'un incident d'action. |
Group Name |
Optional
Nom du groupe dont vous souhaitez supprimer l'utilisateur. |
Group ID |
Optional
ID du groupe dont vous souhaitez supprimer l'utilisateur. Si vous définissez les paramètres |
Sorties de l'action
L'action Supprimer l'utilisateur du groupe fournit les résultats suivants :
| Type de sortie de l'action | Disponibilité |
|---|---|
| Pièce jointe du mur des cas | Non disponible |
| Lien vers le mur des cas | Non disponible |
| Tableau du mur des cas | Non disponible |
| Table d'enrichissement | Non disponible |
| Résultat JSON | Non disponible |
| Messages de sortie | Disponible |
| Résultat du script | Disponible |
Messages de sortie
L'action Supprimer l'utilisateur du groupe peut renvoyer les messages de sortie suivants :
| Message de sortie | Description du message |
|---|---|
|
L'action a réussi. |
Error executing action "Remove User from the Group". 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 Supprimer l'utilisateur du groupe :
| Nom du résultat du script | Valeur |
|---|---|
is_success |
True ou False |
Réinitialiser le mot de passe utilisateur
Utilisez l'action Réinitialiser le mot de passe utilisateur pour réinitialiser le mot de passe utilisateur sur celui que vous spécifiez dans l'action. Cette action oblige l'utilisateur à modifier son mot de passe lors de sa prochaine tentative de connexion.
L'action Réinitialiser le mot de passe utilisateur attend que vous configuriez l'entité User au format username@domain.
Cette action s'exécute sur l'entité Google SecOps User.
Attribuer un rôle à votre application
L'action Réinitialiser le mot de passe de l'utilisateur nécessite d'attribuer le rôle Password
Administrator à votre application.
Pour attribuer le rôle Password Administrator à votre application, procédez comme suit :
- Connectez-vous au portail Azure à l'aide de votre compte Microsoft.
- Dans Microsoft Entra ID, recherchez Roles and administrators (Rôles et administrateurs).
- Sélectionnez ou recherchez le rôle
Password Administratordans la liste. - Cliquez sur Ajouter une attribution.
- Sélectionnez un compte (membre) que vous utilisez dans l'intégration, puis cliquez sur Suivant.
- Saisissez une justification pour l'attribution d'un rôle.
- Cliquez sur Attribuer.
Entrées de l'action
L'action Réinitialiser le mot de passe utilisateur nécessite les paramètres suivants :
| Paramètre | Description |
|---|---|
Password |
Obligatoire
Nouveau mot de passe à définir pour l'utilisateur. |
Sorties de l'action
L'action Réinitialiser le mot de passe utilisateur fournit les résultats suivants :
| Type de sortie de l'action | Disponibilité |
|---|---|
| Pièce jointe du mur des cas | Non disponible |
| Lien vers le mur des cas | Non disponible |
| Tableau du mur des cas | Non disponible |
| Table d'enrichissement | Non disponible |
| Résultat JSON | Non disponible |
| Messages de sortie | Disponible |
| Résultat du script | Disponible |
Messages de sortie
L'action Réinitialiser le mot de passe utilisateur peut renvoyer les messages de sortie suivants :
| Message de sortie | Description du message |
|---|---|
|
L'action a réussi. |
User password reset was not successful. |
Échec de l'action. Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants. |
Résultat du script
Le tableau suivant liste la valeur de la sortie du résultat du script lors de l'utilisation de l'action Réinitialiser le mot de passe de l'utilisateur :
| Nom du résultat du script | Valeur |
|---|---|
is_success |
True ou False |
Révoquer la session utilisateur
Utilisez l'action Révoquer la session utilisateur pour révoquer une session utilisateur.
Cette action s'exécute sur les entités Google SecOps suivantes :
UsernameEmail Address
Entrées de l'action
Aucune.
Sorties de l'action
L'action Révoquer la session utilisateur 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
Les exemples suivants montrent les résultats JSON reçus lors de l'utilisation de l'action Révoquer la session utilisateur :
Si l'utilisateur existe :
{ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Edm.Boolean", "value": true }Si l'utilisateur est introuvable :
{ "error": "User not found." }
Messages de sortie
L'action Révoquer la session utilisateur peut renvoyer les messages de sortie suivants :
| Message de sortie | Description du message |
|---|---|
|
L'action a réussi. |
Error executing action "Revoke User Session". 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 Révoquer la session 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.