Azure AD (Entra ID)

Le connecteur Azure AD (Entra ID) vous permet d'effectuer des opérations d'insertion, de suppression, de mise à jour et de lecture sur Azure Active Directory.

Avant de commencer

Avant d'utiliser le connecteur Azure AD (Entra ID), effectuez les tâches suivantes:

  • Dans votre projet Google Cloud :
    • Accorder à l'utilisateur le rôle IAM roles/connectors.admin configuration du connecteur.
    • Attribuez les rôles IAM suivants au compte de service que vous souhaitez utiliser pour le connecteur :
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Un compte de service est un compte Google spécial destiné à représenter un utilisateur non humain qui doit s'authentifier et obtenir les autorisations permettant d'accéder aux données des API Google. Si vous ne possédez pas de compte de service, vous devez en créer un. Pour plus d'informations, consultez la section Créer un compte de service.

    • Activez les services suivants :
      • secretmanager.googleapis.com (API Secret Manager)
      • connectors.googleapis.com (API Connectors)

      Pour savoir comment activer des services, consultez la page Activer des services.

    Si ces services ou autorisations n'ont pas encore été activés pour votre projet, vous êtes invité à les activer lors de la configuration du connecteur.

Configurer le connecteur

Pour configurer le connecteur, vous devez créer une connexion à votre source de données (système backend). Une connexion est spécifique à une source de données. Cela signifie que si vous disposez de nombreuses sources de données, vous devez créer une connexion distincte pour chacune d'elles. Pour créer une connexion, procédez comme suit :

  1. Dans la console Cloud, accédez à la page Integration Connectors > Connections (Connecteurs d'intégration > Connexions), puis sélectionnez ou créez un projet Google Cloud.

    Accéder à la page "Connexions"

  2. Cliquez sur + Créer pour ouvrir la page Créer une connexion.
  3. Dans la section Emplacement, choisissez l'emplacement de la connexion.
    1. Région : sélectionnez un emplacement dans la liste déroulante.

      Les régions disponibles pour les connecteurs sont les suivantes :

      Pour obtenir la liste de toutes les régions disponibles, consultez la page Emplacements.

    2. Cliquez sur Next (Suivant).
  4. Dans la section Détails de connexion, procédez comme suit :
    1. Connecteur : sélectionnez Azure AD (Entra ID) dans la liste déroulante des connecteurs disponibles.
    2. Version du connecteur : sélectionnez la version du connecteur dans la liste déroulante des versions disponibles.
    3. Dans le champ Nom de connexion, saisissez un nom pour l'instance de connexion.

      Les noms de connexion doivent répondre aux critères suivants :

      • Les noms de connexion peuvent contenir des lettres, des chiffres ou des traits d'union.
      • Les lettres doivent être en minuscules.
      • Les noms de connexion doivent commencer par une lettre et se terminer par une lettre ou un chiffre.
      • Les noms de connexion ne doivent pas dépasser 49 caractères.
    4. Saisissez éventuellement une Description pour l'instance de connexion.
    5. Compte de service : sélectionnez un compte de service disposant des rôles requis.
    6. Vous pouvez également configurer les paramètres du nœud de connexion :

      • Nombre minimal de nœuds : saisissez le nombre minimal de nœuds de connexion.
      • Nombre maximal de nœuds : saisissez le nombre maximal de nœuds de connexion.

      Un nœud est une unité (ou instance répliquée) de connexion qui traite des transactions. Pour traiter plus de transactions pour une connexion, plus de nœuds sont nécessaires. À l'inverse, moins de nœuds sont nécessaires pour traiter moins de transactions. Pour comprendre comment les nœuds affectent la tarification de votre connecteur, consultez la section Tarifs des nœuds de connexion. Si vous ne saisissez aucune valeur, le nombre minimal de nœuds est défini par défaut sur 2 (pour une meilleure disponibilité) et le nombre maximal sur 50.

    7. Locataire Azure : locataire Microsoft Online utilisé pour accéder aux données. Si aucune valeur n'est spécifiée, votre locataire par défaut est utilisé.
    8. Vous pouvez également cliquer sur + Ajouter un libellé pour ajouter un libellé à la connexion sous la forme d'une paire clé/valeur.
    9. Cliquez sur Suivant.
  5. Dans la section Authentification, saisissez les informations d'authentification.
    1. Sélectionnez un type d'authentification, puis saisissez les informations appropriées.

      Les types d'authentification suivants sont compatibles avec la connexion Azure AD (Entra ID) :

      • Azure AD (type d'attribution de code d'autorisation)
      • Identifiants client OAuth 2.0
      • Identifiants client OAuth 2.0 avec support JWT

      2. Pour comprendre comment configurer ces types d'authentification, consultez la section Configurer l'authentification.

    2. Cliquez sur Next (Suivant).
  6. Vérifiez vos informations de connexion et d'authentification.
  7. Cliquez sur Créer.

Configurer l'authentification

Saisissez les détails en fonction de l'authentification que vous souhaitez utiliser.

  • Azure AD (type d'octroi de code d'autorisation)
    • ID client : ID client utilisé pour demander des jetons d'accès.
    • Champs d'application : liste des champs d'application souhaités, séparés par une virgule.
    • Code secret du client : code secret du client utilisé pour demander des jetons d'accès.
    • Version du secret : version du secret client.
    • URL d'autorisation: URL d'autorisation générée lors de la création du client.
  • Identifiants client OAuth 2.0
    • ID client : ID client fourni par Azure AD (ID Entra) pour l'application que vous avez créée.
    • Code secret du client : secret Secret Manager contenant le code secret client pour l'application connectée que vous avez créée.
    • Version du secret : version du secret client.
  • Identifiants client OAuth 2.0 avec jeton porteur JWT
    • Clé privée : secret Secret Manager contenant le contenu du fichier de clé privée au format PEM. La clé privée doit correspondre à la clé publique/au certificat.
    • Mot de passe de la clé privée : secret Secret Manager contenant le mot de passe (paraphrase) du fichier de clé privée.
    • Version du secret: version du secret de la clé privée.
    • ID client : ID client utilisé pour demander des jetons d'accès.

Exemples de configuration de connexion

Avant de créer une connexion Azure AD (Entra ID), créez une application sur le portail Azure/Microsoft Entra ID. Pour en savoir plus, consultez Démarrage rapide : Enregistrer une application avec la plate-forme Microsoft Identity et Enregistrer une application cliente dans Microsoft Entra ID.

Cette section présente des exemples de valeurs pour les différents champs que vous configurez lorsque vous créez la connexion Azure AD (Entra ID).

Type de connexion Azure AD (Type d'attribution de code d'autorisation)

Nom du champ Détails
Emplacement europe-west1
Connecteur Azure AD (ID Entra)
Version du connecteur 1
Nom de connexion azure-ad-connection
Activer Cloud Logging Oui
Compte de service XXXX@serviceaccount
Locataire Azure 9b25e811-f983-4982-82e4-263c1ca48112
Nombre minimal de nœuds 2
Nombre maximal de nœuds 50
Authentification Oui
Azure AD Oui
Identifiant du client XXXX
Champ d'application https://graph.microsoft.com/user.read
Code secret du client XXXX
Version du secret 1
URL d'autorisation https://login.microsoftonline.com/9b25e811-f983-4982-82e4-263c1ca48112/oauth2/v2.0/authorize
Avant de spécifier une valeur pour le champ "Portée", vérifiez les points suivants:
  • Vous devez fournir les autorisations User.Read.All et User.Write.All au niveau de la connexion et au niveau de l'application Azure.
  • Vous pouvez ajouter les autres portées au niveau de l'enregistrement de l'application Azure AD et au niveau de la connexion, selon vos besoins.
  • Assurez-vous que les autorisations sont ajoutées au niveau de l'application, à la fois pour les autorisations déléguées et pour les autorisations de l'application. Les champs d'application suivants sont couramment utilisés :
    • https://graph.microsoft.com/group.readwrite.all
    • https://graph.microsoft.com/groupmember.readwrite.all
    • https://graph.microsoft.com/user.read.all
    • https://graph.microsoft.com/user.read
    • https://graph.microsoft.com/directory.readwrite.all
    • https://graph.microsoft.com/RoleManagement.ReadWrite.Directory
    • https://graph.microsoft.com/directory.accessasuser.all
    • https://graph.microsoft.com/domain.readwrite.all
    • https://graph.microsoft.com/device.read.all
    • https://graph.microsoft.com/RoleManagement.Read.Directory
    • https://graph.microsoft.com/organization.Read.all
    • https://graph.microsoft.com/Application.ReadWrite.all
    • https://graph.microsoft.com/AuditLog.Read.All
    • https://graph.microsoft.com/DeviceLocalCredential.Read.All.

Type de connexion OAuth 2.0 avec identifiants client

Nom du champ Détails
Emplacement us-central1
Connecteur Azure AD (ID Entra)
Version du connecteur 1
Nom de connexion azure-ad-client-credentials
Activer Cloud Logging Oui
Compte de service XXXX@serviceaccount
Locataire Azure 9b25e811-f983-4982-82e4-263c1ca48112
Nombre minimal de nœuds 2
Nombre maximal de nœuds 50
Authentification Oui
OAuth 2.0 – Identifiants du client avec code secret du client Oui
Identifiant du client XXXX
Code secret du client XXXX
Version du secret 1

Identifiants client OAuth 2.0 avec type de connexion de support JWT

Nom du champ Détails
Emplacement europe-west1
Connecteur Azure AD (ID Entra)
Version du connecteur 1
Nom de connexion azure-jwt
Activer Cloud Logging Oui
Compte de service XXXX@serviceaccount
Locataire Azure 9b25e811-f983-4982-82e4-263c1ca48112
Nombre minimal de nœuds 2
Nombre maximal de nœuds 50
Authentification Oui
OAuth 2.0 - Identifiants client avec support JWT Oui
Clé privée XXXX
Version du secret 1
Identifiant du client XXXX
Lorsque vous utilisez les identifiants client OAuth 2.0 avec le type de connexion de support JWT, effectuez les tâches suivantes :
  • Créez un certificat autosigné, puis téléchargez le certificat de clé privée et la clé publique. Pour en savoir plus, consultez Créer un certificat auto-signé.
  • Importez le certificat de clé publique dans l'application Azure AD sous Certificats et Les secrets
  • Dans un champ de clé privée, transmettez la valeur du certificat de clé privée et la valeur du certificat de clé publique dans une seule clé secrète. Vous n'avez pas besoin de créer de secrets distincts pour les clés privée et publique.

Pour en savoir plus sur l'établissement de la connectivité à l'aide de Postman, consultez Connectivité JWT à l'aide de l'API.

Nouvelle autorisation pour le code d'autorisation

Si vous utilisez le type d'authentification Authorization code et que vous avez modifié la configuration de votre application Azure AD, vous devez autoriser à nouveau votre connexion Azure AD (Entra ID). Pour autoriser à nouveau une connexion, procédez comme suit:

  1. Cliquez sur la connexion requise sur la page Connexions.

    La page "Détails de la connexion" s'ouvre.

  2. Cliquez sur Modifier pour modifier les détails de la connexion.
  3. Vérifiez les détails du code d'autorisation OAuth 2.0 dans la section Authentification.

    Si nécessaire, apportez les modifications nécessaires.

  4. Cliquez sur Enregistrer. La page d'informations sur la connexion s'affiche.
  5. Cliquez sur Modifier l'autorisation dans la section Authentification. Le volet Autoriser s'affiche.
  6. Cliquez sur Autoriser.

    Si l'autorisation aboutit, l'état de la connexion est défini sur Active sur la page Connexions.

Étapes supplémentaires après la création de la connexion

Si vous avez sélectionné OAuth 2.0 - Authorization code pour l'authentification, vous devez effectuer les étapes supplémentaires suivantes après avoir créé la connexion :

  1. Sur la page Connexions : localisez la connexion qui vient d'être créée.

    Notez que l'état du nouveau connecteur sera Autorisation requise.

  2. Cliquez sur Autorisation requise.

    Le volet Modifier l'autorisation s'affiche.

  3. Copiez la valeur de l'URI de redirection dans votre application externe.
  4. Vérifiez les détails de l'autorisation.
  5. Cliquez sur Autoriser.

    Si l'autorisation aboutit, l'état de la connexion est défini sur Active sur la page Connexions.

Entités, opérations et actions

Tous les connecteurs Integration Connectors fournissent une couche d'abstraction pour les objets de l'application connectée. Vous ne pouvez accéder aux objets d'une application que via cette abstraction. L'abstraction vous est présentée en tant qu'entités, opérations et actions.

  • Entité : une entité peut être considérée comme un objet ou un ensemble de propriétés dans l'application ou le service connecté. La définition d'une entité diffère d'un connecteur à l'autre. Par exemple, dans un connecteur de base de données, les tables sont les entités, dans un connecteur de serveur de fichiers, les dossiers sont les entités et, dans un connecteur de système de messagerie, les files d'attente sont les entités.

    Toutefois, il est possible qu'un connecteur ne soit pas compatible ou ne possède aucune entité. Dans ce cas, la liste Entities est vide.

  • Opération : une opération est l'activité que vous pouvez effectuer sur une entité. Vous pouvez effectuer l'une des opérations suivantes sur une entité :

    La sélection d'une entité dans la liste disponible génère une liste d'opérations disponibles pour l'entité. Pour obtenir une description détaillée des opérations, consultez les opérations d'entité de la tâche de connecteur. Toutefois, si un connecteur n'est pas compatible avec l'une des opérations d'entité, ces opérations non compatibles ne sont pas listées dans la liste Operations.

  • Action : une action est une fonction de première classe mise à la disposition de l'intégration via l'interface du connecteur. Une action vous permet de modifier une ou plusieurs entités, et varie d'un connecteur à l'autre. Normalement, une action comporte des paramètres d'entrée et un paramètre de sortie. Toutefois, il est possible qu'un connecteur ne prenne en charge aucune action, auquel cas la liste Actions est vide.

Limites du système

Le connecteur Azure AD (Entra ID) peut traiter cinq transactions par seconde et par nœud, et limite les transactions au-delà de cette limite. Par défaut, Integration Connectors alloue deux nœuds (pour une meilleure disponibilité) à une connexion.

Pour en savoir plus sur les limites applicables à Integration Connectors, consultez Limites.

Actions

Cette section répertorie certaines actions possibles avec le connecteur. Pour savoir comment configurer les actions, consultez Exemples d'actions.

Action AddGroupMember

Cette action ajoute un membre à un groupe.

Paramètres d'entrée de l'action AddGroupMember

Nom du paramètre Type de données Requis Description
MemberId Chaîne Oui Identifiant unique du membre.
ID du groupe Chaîne Oui Identifiant unique du groupe.

Pour savoir comment configurer cette action, consultez la section Exemples d'actions.

Action DeleteGroupMember (Supprimer un membre du groupe)

Cette action supprime un membre d'un groupe.

Paramètres d'entrée de l'action SupprimerGroupMember

Nom du paramètre Type de données Requis Description
MemberId Chaîne Oui Identifiant unique du membre.
ID du groupe Chaîne Oui Identifiant unique du groupe.

Pour obtenir un exemple de configuration de cette action, consultez la section Exemples.

Action AddGroupMember(Guest Account) (Ajouter un membre de groupe (compte invité))

Cette action ajoute un membre à un groupe.

Paramètres d'entrée de l'action AddGroupMember

Nom du paramètre Type de données Requis Description
MemberId Chaîne Oui Identifiant unique du membre.
ID du groupe Chaîne Oui Identifiant unique du groupe.

Pour obtenir un exemple sur la façon de configurer cette action, consultez les exemples.

Action RemoveGroupMember (compte invité)

Cette action supprime un membre d'un groupe

Paramètres d'entrée de l'action RemoveGroupMember

Nom du paramètre Type de données Requis Description
MemberId Chaîne Oui Identifiant unique du membre.
ID du groupe Chaîne Oui Identifiant unique du groupe.

Pour savoir comment configurer cette action, consultez la section Exemples.

Action AddUserApplicationRoleAssignment

Cette action ajoute un utilisateur à une attribution de rôle d'application.

Paramètres d'entrée de l'action AddUserApplicationRoleAssignment

Nom du paramètre Type de données Requis Description
ResourceId Chaîne Oui Identifiant unique de la ressource.
AppRoleId Chaîne Oui Identifiant unique du rôle de l'application.
UserId Chaîne Oui Identifiant unique de l'utilisateur.

Pour obtenir un exemple sur la façon de configurer cette action, consultez les exemples.

Supprimer l'action "UserApplicationRoleAssignment"

Cette action supprime un utilisateur d'une attribution de rôle d'application.

Paramètres d'entrée de l'action "RemoveUserApplicationRoleAssignment"

Nom du paramètre Type de données Requis Description
AppRoleAssignmentId Chaîne Oui Identifiant unique de l'attribution du rôle de l'application.
UserId Chaîne Oui Identifiant unique de l'utilisateur.

Pour obtenir un exemple sur la façon de configurer cette action, consultez les exemples.

Action AddGroupApplicationRoleAssignment

Cette action ajoute un groupe à une attribution de rôle d'application.

Paramètres d'entrée de l'action AddGroupApplicationRoleAssignment

Nom du paramètre Type de données Requis Description
ResourceId Chaîne Oui Identifiant unique de la ressource.
AppRoleId Chaîne Oui Identifiant unique du rôle dans l'application.
ID du groupe Chaîne Oui Identifiant unique du groupe

Pour obtenir un exemple sur la façon de configurer cette action, consultez les exemples.

Action SupprimerGroupApplicationRoleAssignment

Cette action supprime un groupe d'une attribution de rôle d'application.

Paramètres d'entrée de l'action RemoveGroupApplicationRoleAssignment

Nom du paramètre Type de données Requis Description
AppRoleAssignmentId Chaîne Oui Identifiant unique de l'attribution de rôle d'application.
ID du groupe Chaîne Oui Identifiant unique du groupe.

Pour savoir comment configurer cette action, consultez la section Exemples.

Action ActivateDirectoryRole

Cette action active un rôle d'annuaire.

Paramètres d'entrée de l'action ActivateDirectoryRole

Nom du paramètre Type de données Requis Description
RoleTemplateId Chaîne Oui L'ID du directoryRoleTemplate sur lequel est basé le rôle.

Pour obtenir un exemple sur la façon de configurer cette action, consultez les exemples.

Action VerifyDomain

Cette action valide un domaine.

Paramètres d'entrée de l'action VerifyDomain

Nom du paramètre Type de données Requis Description
ID Chaîne Oui ID du domaine à valider.

Pour savoir comment configurer cette action, consultez la section Exemples.

Action ChangePassword

Cette action modifie le mot de passe d'un utilisateur.

Paramètres d'entrée de l'action ChangePassword

Nom du paramètre Type de données Requis Description
NewPassword Chaîne Oui Nouveau mot de passe de l'utilisateur.
CurrentPassword Chaîne Oui Mot de passe actuel de l'utilisateur.

Pour obtenir un exemple sur la façon de configurer cette action, consultez les exemples.

Action "ResetPassword" (Réinitialiser le mot de passe)

Cette action réinitialise le mot de passe d'un utilisateur.

Paramètres d'entrée de l'action ResetPassword

Nom du paramètre Type de données Requis Description
Mot de passe Chaîne Oui Mot de passe envoyé par l'utilisateur pour le réinitialiser. Si vous ne renseignez pas ce champ, un mot de passe généré par le système est créé.
UserId Chaîne Oui Identifiant unique de l'utilisateur.

Pour savoir comment configurer cette action, consultez la section Exemples.

Action AssignLicense

Cette action attribue une licence à un utilisateur.

Paramètres d'entrée de l'action AssignLicense

Nom du paramètre Type de données Requis Description
UserPrincipalName Chaîne Oui Nom principal de l'utilisateur pour lequel la licence doit être attribuée.N'indiquez pas le nom d'utilisateur avec lequel vous vous êtes connecté.
UserId Chaîne Oui ID de l'utilisateur auquel la licence doit être attribuée. N'indiquez pas le nom d'utilisateur avec lequel vous vous êtes connecté.
AddLicenseSkuId Chaîne Oui Identifiant unique du SKU.
DisabledPlans Chaîne Non Ensemble des identifiants uniques séparés par une virgule pour les forfaits désactivés.
RemoveLicenses Chaîne Non Ensemble d'ID GUID séparés par une virgule qui identifient les licences à supprimer.

Pour obtenir un exemple de configuration de cette action, consultez la section Exemples.

Action DeleteLicense

Cette action supprime la licence attribuée à un utilisateur.

Paramètres d'entrée de l'action RemoveLicense

Nom du paramètre Type de données Requis Description
UserPrincipalName Chaîne Oui Nom principal de l'utilisateur pour lequel la licence doit être attribuée. Ne fournissez pas le nom d'utilisateur avec lequel vous vous êtes connecté.
UserId Chaîne Oui ID de l'utilisateur auquel la licence doit être attribuée. N'indiquez pas le nom d'utilisateur avec lequel vous vous êtes connecté.
AddLicenseSkuId Chaîne Non Identifiant unique du SKU.
DisabledPlans Chaîne Non Ensemble des identifiants uniques séparés par une virgule pour les forfaits désactivés.
RemoveLicenses Chaîne Oui Ensemble de GUID séparés par une virgule qui identifient les licences à supprimer.

Pour savoir comment configurer cette action, consultez la section Exemples.

Action FetchAdditionalUserFields

Cette action permet de récupérer les champs d'attributs obligatoires.

Paramètres d'entrée de l'action FetchAdditionalUserFields

Nom du paramètre Type de données Requis Description
UserId Chaîne Oui Identifiant unique de l'utilisateur.

Pour obtenir un exemple sur la façon de configurer cette action, consultez les exemples.

Action AddGroupOwner

Cette action ajoute un propriétaire à un groupe.

Paramètres d'entrée de l'action AddGroupOwner

Nom du paramètre Type de données Requis Description
ID du groupe Chaîne Oui Identifiant unique du groupe.
OwnerId Chaîne Oui Identifiant unique du propriétaire.

Pour savoir comment configurer cette action, consultez la section Exemples.

Action RemoveGroupOwner

Cette action supprime un propriétaire de groupe.

Paramètres d'entrée de l'action "RemoveGroupOwner"

Nom du paramètre Type de données Requis Description
ID du groupe Chaîne Oui Identifiant unique du groupe.
OwnerId Chaîne Oui Identifiant unique du propriétaire.

Pour obtenir un exemple sur la façon de configurer cette action, consultez les exemples.

Action InviteExternalUser

Cette action invite un utilisateur externe à rejoindre l'organisation.

Paramètres d'entrée de l'action InviteExternalUser

Nom du paramètre Type de données Requis Description
UserEmailAddress Chaîne Oui Adresse e-mail de l'utilisateur que vous invitez.
RedirectURL Chaîne Oui URL vers laquelle l'utilisateur est redirigé après avoir utilisé l'offre.

Pour savoir comment configurer cette action, consultez la section Exemples.

Action AddPhoneAuthenticationMethod

Cette action permet aux utilisateurs d'effectuer des tâches spécifiques

Paramètres d'entrée de l'action AddPhoneAuthenticationMethod

Nom du paramètre Type de données Requis Description
UserID Chaîne Oui ID de l'utilisateur pour lequel ajouter une méthode d'authentification par téléphone.
PhoneNumber Chaîne Oui Numéro de téléphone de la méthode d'authentification.
PhoneType Chaîne Oui Type de téléphone de la méthode d'authentification. Les valeurs possibles sont : mobile, alternateMobile et office.

Pour savoir comment configurer cette action, consultez la section Exemples.

Action DeletePhoneAuthenticationMethod

Cette action supprime la méthode d'authentification par téléphone pour un utilisateur.

Paramètres d'entrée de l'action RemovePhoneAuthenticationMethod

Nom du paramètre Type de données Requis Description
UserID Chaîne Oui ID de l'utilisateur pour lequel supprimer une méthode d'authentification par téléphone. N'indiquez pas le nom d'utilisateur avec lequel vous vous êtes connecté.
ID Chaîne Oui ID de la méthode de téléphone correspondant au type de téléphone.

Pour obtenir un exemple sur la façon de configurer cette action, consultez les exemples.

Action UpdatePhoneAuthenticationMethod

Cette action met à jour la méthode d'authentification par téléphone pour un utilisateur.

Paramètres d'entrée de l'action UpdatePhoneAuthenticationMethod

Nom du paramètre Type de données Requis Description
UserID Chaîne Oui ID de l'utilisateur pour mettre à jour une méthode d'authentification par téléphone.
ID Chaîne Oui ID de la méthode de téléphone correspondant au phoneType.
PhoneNumber Chaîne Oui Numéro de téléphone de la méthode d'authentification.

Pour obtenir un exemple sur la façon de configurer cette action, consultez les exemples.

Action AddPrivilegedRole

Cette action ajoute un rôle privilégié à un utilisateur.

Paramètres d'entrée de l'action AddPrivilegedRole

Nom du paramètre Type de données Requis Description
PrincipalId Chaîne Oui Identifiant du compte principal auquel le rôle a été accordé.
RoleDefinitionId Chaîne Oui Identifiant de l'objet unifiedRoleDefinition attribué au principal.
Justification Chaîne Oui Message fourni par les utilisateurs et les administrateurs.
ScheduleInfo Chaîne Oui Période d'éligibilité au rôle.

Pour savoir comment configurer cette action, consultez la section Exemples.

Supprimer l'actionPrivilegedRole

Cette action supprime le rôle privilégié d'un utilisateur.<

Paramètres d'entrée de l'action "RemovePrivilegedRole"

Nom du paramètre Type de données Requis Description
PrincipalId Chaîne Oui Identifiant du compte principal auquel le rôle a été accordé.
RoleDefinitionId Chaîne Oui Identifiant de l'objet unifiéRoleDefinition en cours de suppression du compte principal.
Justification Chaîne Oui Message fourni par les utilisateurs et les administrateurs.

Action RetrieveUserPhoto

Cette action permet de récupérer la photo d'un utilisateur.

Paramètres d'entrée de l'action RetrieveUserPhoto

Nom du paramètre Type de données Requis Description
UserId Chaîne Oui ID du fichier que vous souhaitez télécharger.
FileLocation Chaîne Non Emplacement de stockage du fichier. Spécifiez le chemin d'accès complet et le nom du fichier.
Encodage Chaîne Non Type d'encodage d'entrée FileData.
FileStream Chaîne Non Instance d'un flux de sortie dans lequel les données de fichier sont écrites. Utilisé uniquement si FileLocation n'est pas fourni.

Pour obtenir un exemple sur la façon de configurer cette action, consultez les exemples.

Action UpdateUserPhoto

Cette action met à jour la photo d'un utilisateur.

Paramètres d'entrée de l'action UpdateUserPhoto

Nom du paramètre Type de données Requis Description
LocalFile Chaîne Non Emplacement du fichier local contenant la photo à importer. Spécifiez le chemin d'accès complet et le nom du fichier.
ContentStream Chaîne Non Contenu en tant qu'InputStream à importer lorsque le chemin d'accès local ou le chemin d'accès au dossier n'est pas spécifié
UserId Chaîne Oui Identifiant de l'utilisateur.
Contenu Chaîne Oui Contenu photo à importer.

Pour savoir comment configurer cette action, consultez la section Exemples.

Action RemoveUserPhoto

Cette action supprime une photo d'utilisateur.

Paramètres d'entrée de l'action RemoveUserPhoto

Nom du paramètre Type de données Requis Description
UserId Chaîne Oui ID de l'utilisateur.

Pour obtenir un exemple de configuration de cette action, consultez la section Exemples.

Action AssignManager

Cette action attribue un gestionnaire à un utilisateur spécifique.

Paramètres d'entrée de l'action AssignManager

Nom du paramètre Type de données Requis Description
ObjectId Chaîne Oui Identifiant unique de l'objet.
Nom de l'objet Chaîne Oui Objet directoryObject, utilisateur ou contact organisationnel à ajouter.
UserId Chaîne Oui Identifiant unique de l'utilisateur.

Pour savoir comment configurer cette action, consultez la section Exemples.

Action RemoveManager

Cette action supprime le responsable attribué à un utilisateur.

Paramètres d'entrée de l'action "RemoveManager"

Nom du paramètre Type de données Requis Description
UserId Chaîne Oui Identifiant unique de l'utilisateur.

Pour savoir comment configurer cette action, consultez la section Exemples.

Action RetrieveManagerChain

Cette action récupère le responsable d'un utilisateur.

Paramètres d'entrée de l'action RetrieveManagerChain

Nom du paramètre Type de données Requis Description
Niveaux Chaîne Oui Nombre de niveaux de responsables à récupérer. Indiquez "max" pour afficher tous les administrateurs.
UserId Chaîne Oui ID de l'utilisateur.

Pour obtenir un exemple sur la façon de configurer cette action, consultez les exemples.

Action AddProfileCardProperty

Cette action ajoute une nouvelle propriété ProfileCardProperty pour une organisation.

Paramètres d'entrée de l'action AddProfileCardProperty

Nom du paramètre Type de données Requis Description
DirectoryPropertyName Chaîne Oui Identifie une ressource profileCardProperty.
Annotations Chaîne Oui Permet à un administrateur de définir un libellé d'affichage personnalisé pour la propriété d'annuaire.

Pour obtenir un exemple de configuration de cette action, consultez la section Exemples.

Action SupprimerProfileCardProperty

Cette action supprime une ProfileCardProperty pour une organisation.

Paramètres d'entrée de l'action "RemoveProfileCardProperty"

Nom du paramètre Type de données Requis Description
DirectoryPropertyName Chaîne Oui Identifie une ressource profileCardProperty.

Pour obtenir un exemple sur la façon de configurer cette action, consultez les exemples.

Exemples d'actions

Cette section explique comment effectuer certaines actions dans ce connecteur.

Exemple : AddGroupMember

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action AddGroupMember, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value : 
    {
  "MemberId": "5408040c-fb7d-4c36-8b67-3b66e9edaad3",
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100"
  }

    4. Cette action renvoie un message de confirmation de AddGroupMember. Si l'action réussit, le Le paramètre de réponse connectorOutputPayload de la tâche AddGroupMember a une valeur semblable à celle-ci:

    [{
  "Success": "True"
  }]

Exemple : DeleteGroupMember

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action RemoveGroupMember, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à celle-ci dans la section Champ Default Value: 
    {
  "MemberId": "5408040c-fb7d-4c36-8b67-3b66e9edaad3",
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100"
  }

    4. Si l'action aboutit, la Réponse connectorOutputPayload de la tâche RemoveGroupMember a une valeur semblable à celle-ci:

    [{
  "Success": "True"
  }]

Exemple : AddGroupMember(compte invité)

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action AddGroupMember, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value : 
    {
  "MemberId": "735fac93-32df-45c9-b6a3-beee95270a6a",
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100"
  }

    4. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche AddGroupMember a une valeur semblable à celle-ci :

    [{
  "Success": "True"
  }]

Exemple : DeleteGroupMember(Compte invité)

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action RemoveGroupMember, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à celle-ci dans la section Champ Default Value: 
    {
  "MemberId": "735fac93-32df-45c9-b6a3-beee95270a6a",
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100"
  }

    4. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche RemoveGroupMember a une valeur semblable à celle-ci :

    [{
  "Success": "True"
  }]

Exemple : AddUserApplicationRoleAssignment

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action AddUserApplicationRoleAssignment, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à celle-ci dans la section Champ Default Value: 
    {
  "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913",
  "ResourceId": "3a914726-ab97-49a0-ab7d-4f742fbc271e",
  "AppRoleId": "820afb79-d975-4da7-8f29-0e2c0cff1217"
  }

    4. Si l'action aboutit, la Réponse connectorOutputPayload de la tâche AddUserApplicationRoleAssignment a une valeur semblable à celle-ci:

    [{
  "Success": "True"
  }]

Exemple : RemoveUserApplicationRoleAssignment

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action RemoveUserApplicationRoleAssignment, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value : 
    {
  "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913",
  "AppRoleAssignmentId": "bspYNS4s00GoVL-SSaPJE0xC2--0GxxIu8uS4aeindU"
  }

    4. Si l'action aboutit, la Réponse connectorOutputPayload de la tâche RemoveUserApplicationRoleAssignment a une valeur semblable à celle-ci:

    [{
  "Success": "True"
  }]

Exemple : AddGroupApplicationRoleAssignment

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action AddGroupApplicationRoleAssignment, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value : 
    {
  "ResourceId": "3a914726-ab97-49a0-ab7d-4f742fbc271e",
  "AppRoleId": "820afb79-d975-4da7-8f29-0e2c0cff1217",
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100"
  }

    4. Si l'action aboutit, la Réponse connectorOutputPayload de la tâche AddGroupApplicationRoleAssignment a une valeur semblable à celle-ci:

    [{
  "Success": "True"
  }]

Exemple :RemoveGroupApplicationRoleAssignment

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action RemoveGroupApplicationRoleAssignment, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value : 
    {
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100",
  "AppRoleAssignmentId": "p3luD3g1tEid3t7Pu3uxAMT7DwI3p29HlrxMuZ143eU"
  }

    4. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche RemoveGroupApplicationRoleAssignment a une valeur semblable à celle-ci :

    [{
  "Success": "True"
  }]

Exemple : ActivateDirectoryRole

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action ActivateDirectoryRole, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à celle-ci dans la section Champ Default Value: 
     {
  "RoleTemplateId": "f023fd81-a637-4b56-95fd-791ac0226033"
  }

    4. Si l'action aboutit, la Réponse connectorOutputPayload de la tâche ActivateDirectoryRole a une valeur semblable à celle-ci:

    [{
  "id": "c865d9cb-57da-416c-97a3-753e733da678",
  "roleTemplateId": "f023fd81-a637-4b56-95fd-791ac0226033",
  "displayName": "Service Support Administrator",
  "description": "Can read service health information and manage support tickets."
  }]

Exemple : VerifyDomain

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action VerifyDomain, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à celle-ci dans la section Champ Default Value: 
    {
  "Id": "eternalsolarsolutions.com"
  }

    4. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche VerifyDomain a une valeur semblable à celle-ci :

    [{
  "Success": "True"
  }]

Exemple – ChangePassword

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action ChangePassword, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value : 
    {
  "NewPassword": "XXX@9876",
  "CurrentPassword": "XXX@123"
  }

    4. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche ChangePassword a une valeur semblable à celle-ci :

    [{
  "Success": "True"
  }]

Exemple – ResetPassword

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action ResetPassword, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à celle-ci dans la section Champ Default Value: 
    {
  "Password": "XXX@9876",
  "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913"
  }

    4. Si l'action aboutit, la Réponse connectorOutputPayload de la tâche ResetPassword a une valeur semblable à celle-ci:

    [{
  "Success": "True"
  }]

Exemple : AssignLicense

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action AssignLicense, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value : 
    {
  "UserID": "3558ca6e-2c2e-41d3-a854-bf9249a3c913",
  "UserPrincipalName": "Gcp_test@z8474.onmicrosoft.com",
  "AddLicenseSkuId": "6ec92958-3cc1-49db-95bd-bc6b3798df71"
  }

    4. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche AssignLicense a une valeur semblable à celle-ci :

    [{
  "Success": "True"
  }]

Exemple : RemoveLicense

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action AssignLicense, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value : 
    {
  "UserID": "3558ca6e-2c2e-41d3-a854-bf9249a3c913",
  "UserPrincipalName": "Gcp_test@z8474.onmicrosoft.com",
  "RemoveLicenses": "6ec92958-3cc1-49db-95bd-bc6b3798df71"
  }

    4. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche RemoveLicense a une valeur semblable à celle-ci :

    [{
  "Success": "True"
  }]

Exemple : FetchAdditionalUserFields

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action FetchAdditionalUserFields, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value : 
    {
  "UserId": "9630c9d7-cf15-4406-8d21-598e41a058cc"
  }

    4. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche FetchAdditionalUserFields a une valeur semblable à celle-ci :

    [{
    "id": "9630c9d7-cf15-4406-8d21-598e41a058cc",
    "deleteddatetime": null,
    "accountenabled": "true",
    "agegroup": null,
    "businessphones": "",
    "city": null,
    "companyname": null,
    "consentprovidedforminor": null,
    "country": null,
    "createddatetime": "2024-04-12T10:24:42Z",
    "creationtype": null,
    "department": null,
    "displayname": "Azure_AD_Test",
    "employeehiredate": null,
    "employeeid": null,
    "employeeleavedatetime": null,
    "employeetype": null,
    "externaluserstate": null,
    "externaluserstatechangedatetime": null,
    "faxnumber": null,
    "givenname": null,
    "imaddresses": "",
    "isresourceaccount": null,
    "jobtitle": null,
    "lastpasswordchangedatetime": "2024-05-14T05:07:15Z",
    "legalagegroupclassification": null,
    "mail": null,
    "mailnickname": "Azure_AD_Test",
    "mobilephone": null,
    "officelocation": null,
    "onpremisesdistinguishedname": null,
    "onpremisesdomainname": null,
    "onpremisesimmutableid": null,
    "onpremiseslastsyncdatetime": null,
    "onpremisessamaccountname": null,
    "onpremisessecurityidentifier": null,
    "onpremisessyncenabled": null,
    "onpremisesuserprincipalname": null,
    "othermails": "",
    "passwordpolicies": null,
    "postalcode": null,
    "preferreddatalocation": null,
    "preferredlanguage": null,
    "proxyaddresses": "",
    "securityidentifier": "S-1-12-1-2519779799-1141296917-2388205965-3428360257",
    "showinaddresslist": null,
    "signinsessionsvalidfromdatetime": "2024-05-14T05:07:15Z",
    "state": null,
    "streetaddress": null,
    "surname": null,
    "usagelocation": "IN",
    "userprincipalname": "Azure_AD_Test@z8474.onmicrosoft.com",
    "usertype": "Member",
    "aboutme": null,
    "birthday": "0001-01-01T08:00:00Z",
    "hiredate": "0001-01-01T08:00:00Z",
    "interests": "",
    "mysite": null,
    "pastprojects": "",
    "preferredname": "",
    "responsibilities": "",
    "schools": "",
    "skills": "",
    "assignedlicenses": "",
    "assignedplans": "[\r\n  {\r\n    \"assignedDateTime\": \"2024-05-16T10:17:45Z\",\r\n    \"capabilityStatus\": \"Deleted\",\r\n    \"service\": \"DynamicsNAV\",\r\n    \"servicePlanId\": \"3f2afeed-6fb5-4bf9-998f-f2912133aead\"\r\n  }\r\n]",
  "authorizationinfo_certificateuserids": "",
  "identities": "[\r\n  {\r\n    \"signInType\": \"userPrincipalName\",\r\n    \"issuer\": \"z8474.onmicrosoft.com\",\r\n    \"issuerAssignedId\": \"Azure_AD_Test@z8474.onmicrosoft.com\"\r\n  }\r\n]",
  "licenseassignmentstates": "",
  "onpremisesextensionattributes_extensionattribute1": null,
  "onpremisesextensionattributes_extensionattribute2": null,
  "onpremisesextensionattributes_extensionattribute3": null,
  "onpremisesextensionattributes_extensionattribute4": null,
  "onpremisesextensionattributes_extensionattribute5": null,
  "onpremisesextensionattributes_extensionattribute6": null,
  "onpremisesextensionattributes_extensionattribute7": null,
  "onpremisesextensionattributes_extensionattribute8": null,
  "onpremisesextensionattributes_extensionattribute9": null,
  "onpremisesextensionattributes_extensionattribute10": null,
  "onpremisesextensionattributes_extensionattribute11": null,
  "onpremisesextensionattributes_extensionattribute12": null,
  "onpremisesextensionattributes_extensionattribute13": null,
  "onpremisesextensionattributes_extensionattribute14": null,
  "onpremisesextensionattributes_extensionattribute15": null,
  "onpremisesprovisioningerrors": "",
  "provisionedplans": "",
  "serviceprovisioningerrors": "",
  "customsecurityattributes": "{\r\n  \"ConnectorTesting\": {\r\n    \"@odata.type\": \"#microsoft.graph.customSecurityAttributeValue\",\r\n    \"FavouriteSport\": \"cricket\",\r\n    \"FavouriteMovie\": \"3 idiots\"\r\n  }\r\n}",
  "signinactivity_lastsignindatetime": "2024-05-14T07:04:51Z",
  "signinactivity_lastsigninrequestid": "ed35b322-d0d9-4fcb-8e71-f9ee7e065e00",
  "signinactivity_lastnoninteractivesignindatetime": "2024-05-15T09:00:02Z",
  "signinactivity_lastnoninteractivesigninrequestid": "0d4ce88b-710a-440f-a612-f590954d6800",
  "signinactivity_lastsuccessfulsignindatetime": "2024-05-15T06:45:42Z",
  "signinactivity_lastsuccessfulsigninrequestid": "64643e9d-3468-4e4d-b7c3-8bd316956600"
  }

Exemple : AddGroupOwner

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action AddGroupOwner, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à celle-ci dans la section Champ Default Value: 
    {
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100",
  "OwnerId": "9630c9d7-cf15-4406-8d21-598e41a058cc"
  }

    4. Si l'action aboutit, la Réponse connectorOutputPayload de la tâche AddGroupOwner a une valeur semblable à celle-ci:

    [{
  "Success": "True"
  }]

Exemple : DeleteGroupOwner

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action RemoveGroupOwner, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à celle-ci dans la section Champ Default Value: 
    {
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100",
  "OwnerId": "9630c9d7-cf15-4406-8d21-598e41a058cc"
  }

    4. Si l'action aboutit, la Réponse connectorOutputPayload de la tâche RemoveGroupOwner a une valeur semblable à celle-ci:

    [{
  "Success": "True"
  }]

Exemple – InviteExternalUser

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action InviteExternalUser, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à celle-ci dans la section Champ Default Value: 
    {
  "UserEmailAddress": "taleprajyot97@gmail.com",
  "RedirectURL": "https://www.example.com"
  }

    4. Cette action renvoie un message de confirmation de InviteExternalUser. Si l'action aboutit, le Réponse connectorOutputPayload de la tâche InviteExternalUser a une valeur semblable à celle-ci:

    [{
  "Success": "True",
  "Id": "70905aef-361f-4cb1-8d04-41f9e377ebd3",
  "ReedemURL": "https://login.microsoftonline.com/redeem?rd=https%3a%2f%2finvitations.microsoft.com%2fredeem%2f%3ftenant%3d9b25e811-f983-4982-82e4-263c1ca48112%26user%3d70905aef-361f-4cb1-8d04-41f9e377ebd3%26ticket%3dx5aOZc%25252bE9XslKcOdb101qLnoe2V%25252b8%25252beeFlNhYA5WvTg%25253d%26ver%3d2.0",
  "InvitedUserId": "d5eeb199-a544-4985-b726-e3073751050c"
  }]

Exemple : AddPhoneAuthenticationMethod

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action AddPhoneAuthenticationMethod, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à celle-ci dans la section Champ Default Value: 
    {
  "PhoneType": "mobile",
  "UserID": "93e42f0d-74d7-445b-b15a-dd6ceb013d81",
  "PhoneNumber": "+91 9898989890"
  }

    4. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche AddPhoneAuthenticationMethod a une valeur semblable à celle-ci :

    [{
  "Success": "True"
  }]

Exemple : RemovePhoneAuthenticationMethod

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action RemovePhoneAuthenticationMethod, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à celle-ci dans la section Champ Default Value: 
    {
  "PhoneType": "mobile",
  "UserID": "93e42f0d-74d7-445b-b15a-dd6ceb013d81",
  "PhoneNumber": "+91 9898989890"
  }

    4. Si l'action aboutit, la réponse connectorOutputPayload de la tâche RemovePhoneAuthenticationMethod a une valeur semblable à celle-ci:

    [{
  "Success": "True"
  }]

Exemple : UpdatePhoneAuthenticationMethod

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action UpdatePhoneAuthenticationMethod, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value : 
    {
  "securityComplianceNotificationPhones": "9899999999",
  "securityComplianceNotificationMails": "abc@gmail.com"
  }

    4. Si l'action aboutit, la Réponse connectorOutputPayload de la tâche UpdatePhoneAuthenticationMethod a une valeur semblable à celle-ci:

    [{
  "Success": "True"
  }]

Exemple – AddPrivilegedRole

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action AddPrivilegedRole, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value : 
    {
  "PrincipalId": "8cbe82b6-0dd5-4f10-bf67-82bf88ac6cb8",
  "RoleDefinitionId": "729827e3-9c14-49f7-bb1b-9608f156bbb8",
  "Justification": "Add Privileged Role",
  "ScheduleInfo": "{\n\"StartDateTime\" : \"2022-09-09T21:31:27.91Z\",\n\"Expiration\"    : {\n\"Type\"        : \"Eligible\"}\n}"
  }

    4. Si l'action aboutit, la Réponse connectorOutputPayload de la tâche AddPrivilegedRole a une valeur semblable à celle-ci:ç 

    [{
  "Success": "True"
  }]

Exemple – DeletePrivilegedRole

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action RemovePrivilegedRole, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à celle-ci dans la section Champ Default Value: 
    {
  "PrincipalId": "8cbe82b6-0dd5-4f10-bf67-82bf88ac6cb8",
  "RoleDefinitionId": "729827e3-9c14-49f7-bb1b-9608f156bbb8",
  "Justification": "Removing Privileage Role"
  }

    4. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche RemovePrivilegedRole a une valeur semblable à celle-ci :

    [{
  "Success": "True"
  }]

Exemple : RetrieveUserPhoto

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action RetrieveUserPhoto, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à celle-ci dans la section Champ Default Value: 
    {
  "UserId": "8e22c728-c523-436b-8f46-3b21cc1b5f80"
  }

    4. Si l'action aboutit, la Réponse connectorOutputPayload de la tâche RetrieveUserPhoto a une valeur semblable à celle-ci:

    [{
    "Status": "Success",
    "FileData": "77+9UE5HDQoaCgAAAA1JSERSAAADUgAAAjYIBgAAAFo077+977+9AAAAAXNSR0IA77+977+9HO+/vQAAAARnQU1BAADvv73vv70L77+9YQUAAAAJcEhZcwAADu+/vQAADu+/vQHvv71v77+9ZAAA77+977+9SURBVHhe77+977+9ZXwcV9K+LWlmZCbvv71O77+977+977+9ZO+/vcmG77+9Ge+/vThmZmZm77+9OO+/vcmG77+977+9MTMzM++/vS0z77+977+977+9eu+/ve+/vXTvv71o77+9KAvvv73vv73vv71w77+9DjRO77+977+9Vl3vv70677+9KWsrR2zvv71zEe+/ve+/vUTvv73vv717KGrvv709EO+/ve+/vWjvv71RG01777+977+9Me+/ve+/vWjvv73vv719OmJLyqfZuu+/vRHvv71ZK++/vQ7Uj9iJ77+977+9du+/vUXEslrvv73vv73vv70uzbzvv70pFu+/vUrvv709Yl4P77+9eu+/vSDvv73vv71n77+977+977+9Gu+/ve+/vV3vv71sP2Vm77+977+9be+/vWbvv707RmxV77+9VFvvv70u77+9Fu+/ve+/vdqi77+9aTbvv71N77+977+9Re+/ve+/vWPvv70tYe+/vRXvv73vv70677+9bu+/vTRbS++/ve+/ve+/vWxkP1vvv71FbWt377+977+9LdW277+977+977+977+977+9ae+/ve+/vXvvv73vv73vv70Z77+9Xe+/vSLvv73vv70X77+977+9E++/vT1ob1/vv71+ae+/ve+/vWx3by1P77+9XT3vv71sL++/ve+/ve+/vWbvv73vv73vv71m77+9F+e0s2vvv712dErvv73vv73vv73vv73vv73vv71p77+977+9Le+/vW/vv73vv71oZ0vvv73vv70577+9R3tb77+92b7vv70R77+977+9KmIHKQ/vv73vv73agdapdu+/vU3vv73vv73vv73vv73vv71zXe+/ve+/ve+/ve+/ve+/vRTvv70777+977+977+96pqK77+9LO+/vXN077+9PO+/ve+/ve+/vVp2f++/vdOgNO+/ve+/veyBlO+/ve+/vQdQ77+9cO+/vTc477+9bBDvv71S77+977+977+977+9Zu+/ve+/vW8I77+977+977+9ZQ8paFnvv70LWnxwYe+/ve+/vVEWNBvvv71O77+977+9eQMKW++/vV8x77+977+9FO+/vd6k77+977+9LmHvv70eRS3erQBiG++/vXXvv71DzLI577+9LO+/vT3vv73vv71077+9Ze+/ve+/ve+/vTcebe+/vWbvv73vv71E77+9UEPvv71r77+9NMus77+9Zu+/ve+/vUVsXe+/ve+/ve+/ve+/ve+/vWZr77+9c29qRG0177+9VdWi77+977+9eu+/ve+/ve+/vUlfTe+/ve+/vW/vv73NujVTbX3vv73vv73vv73vv70V77+9He+/ve+/vXUj77+977+9AdeeMe+/ve+/ve+/ve+/ve+/ve+/vQHvv73vv70Y77+9aFcj77+9Y2Pvv700Zjtpb2vvv73vv73vv73vv73ZmHvXnHvvv70Y77+904Lvv73vv70y77+977+9EO+/ve+/vRjvv73vv71077+9dDvbs++/ve+/vXsX4bqU77+9Wu+/vVsH77+977+977+977+9P1vvv73vv70y77+9fO+/ve+/vV8pZd6rJe+/vXvvv70cy6Yef++/ve+/vWXvv71U1LJf77+9Wg3vv73vv71j1otF77+9NO+/ve+/vQTvv73vv70A77+9SO+/vWZHD++/vQ3vv71ta++/ve+/ve+/veO+rmDvv73vv73vv71c77+9cD1+77+9Hu+/ve+/vSpG77+977+9Y++/ve+/vWfvv73vv73vv70zMXvvv73vv73vv73
  ...[too long to view on UI. Please use the API to view the full content.]

Exemple : UpdateUserPhoto

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action UpdateUserPhoto, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value : 
    {
  "UserId": "9630c9d7-cf15-4406-8d21-598e41a058cc",
  "Content": "iVBORw0KGgoAAAANSUhEUgAAA1IAAAI2CAIAAADVVi6oAAAgAElEQVR4AZy9d3Rc1dX3r3POHVmWrG6ckIQHN0gCCYEkT/IkJA89lARc1Xsf1ZlR78W2iis4BFuybMAFMMW4qctFknu31XvvzTbu0tx9fmufOzMWJe+b97fWXmede2ekBYs/8sm3bJm1uLAry9jJt2jFq9Khl6XDL0vFr0ilr0pHXlMdf52ee5tdXU5b3diAN50IYHdCyYMINh1FIJpCnJmcRCGFQSqBdDNIJzhp5H4Su5FIx5PYYDzrjaVdcaxRS+qjyWWNdFlHL2jZBR27ECNdiqNX41l9HG1MYI0JtCWBtSTSjiTWnSz1pNCuZNKXKvWl0e4U0p/GhtLZcDodz2QjmWw0i42soiOZdDiDDaXToVQ6ms76k2lvEuuKZ71xbCBJ6o+nA7F0IIb260ifhg5p6EAkHdGycS0bjaJjGjYWxSY17IZOmtCQ61p6P0a6HU1vRtPbsfRePH2QQO8lkXtJdDqN4aRTfRbRryaQQ+Ucqs+mshj9GiqvocpLyKU8h0CueMwmPJtCDoE8CtlMn2cxnWsh51pCnrWca8FzzSHPAtZYyqusIdMG0s15hq2cOkdOniUnW8hxVI5V6WPpdDSd1kn3IsndKPZNOL2hZteD6HgAHfSnff6s1ZM1u9NmD9biKTW500Z3qdGDNnmxFi+pyYO2+7BWL9Lmy9q8WbuP1OHHegJZVwDr8qc9gawvkPYF0cEgOhTMhkPYcKhqIIj2BpP+IDoQQkfD2WgEG4mgY5EqPCPodS27FUfvJ5lPpVnJGVaQbS9n28o5c+V1j+rXzYWN8+RN9vCuLWyep99kL2901G+Yo19rAevw33p6vdX9XPM72Wwiiw2l0v5U1p9Ge1Kk1gRaH8dOR7Ayf/alh2qnk7RjhWrbUmnLO6p332DrX6fZr0iZL7KUF1jCn1TaP86K/P2siN9Zhj43R/1b68DfWPv+ysbrlw5uT9g6L7JducjeeZGjy6J5zo/buyxwdF9g77nIwfcJ+9Bfzo34pX3MMw4Jv7LP/K3tpj/b5L9gu/0Fq89fn130zpzyFXNOONuecZ1z0WtOnd+ctiDrjkCbwTDH4Qjrm9qf3on9yd34H02n/Jc+9TFIf1xOX6hPexwyF0Da49NJj00nPXYndt7tuB9N6hyGImx71datfrOueNHTrtKR5axkmVS2fHaN67wLvovq1c+26f7cl/zqZPbye5u99NuC4JMI2B8LFelwIodffg/qtkBzIbTthI5dvHMP7/4cp+dL3vcVH9jPBw/CUDEfKYPRMj5Wzscq+dgRPirOh5dK8VH5d04YKYVR8YOj5TBSir9kpIwPlcJwKQyXwHAJFwNDxfg4VGx6lAcP8YGHA/0H8bH/EO8Tl76DeOk7CP378Z+wfx/v3wf9+6Dva7kXT+jbB31fQe9X0P0V79mH0/0V71LmS979BXR9bjp59xe86wve+Tl07OWdnxtnL+/cCx2fKcM7PoP2T6H9Uy5OaPuEt38C7Z/wtj3Qsou37sZp2cNb9sgte3gzDjTv4U27efNO3vwxb/4Ip0lM807etBMaP4KGHdCwgzd+iO8bP+SNH0KT4aXhfcN2qC/k9dvlum1Qvw3qxGPdNj5joN74WFsw8z3eDW8KeJ34qLYA3xhHrsuH+nxel89r83ndVsPP1hZA7VbAx628Lh8atvLGfF6/Va4v4LVbceryeaPxfWM+NObzhgLegC+VAeXeUIAX/KgA3xu/gL+wYSv+lGmMH+GbpgLT4HdmPP7f780FvHnrw2nZyvHNNpyWfN4i7k3boLmAt4pp2cZbC7npbNnGWwrxo5Z8aM0X39kGbQWG6djK2/OhrYC35z+cjnxow/e8Ix/E8M4C6MjnnQUPp2sb79qGj8rZOeOufPS9E7rF
  ...[too long to view on UI. Please use the API to view the full content.]

    4. Si l'action aboutit, la Réponse connectorOutputPayload de la tâche UpdateUserPhoto a une valeur semblable à celle-ci:

     [{
  "Status": "Success"
  }]

Exemple - DeleteUserPhoto

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action RemoveUserPhoto, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value : 
     {
  "UserId": "9630c9d7-cf15-4406-8d21-598e41a058cc"
  }

    4. Si l'action aboutit, la Réponse connectorOutputPayload de la tâche RemoveUserPhoto a une valeur semblable à celle-ci:

     [{
  "Status": "Success"
  }]

Exemple : AssignManager

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action AssignManager, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value : 
    {
  "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913",
  "ObjectId": "8cbe82b6-0dd5-4f10-bf67-82bf88ac6cb8",
  "ObjectName": "users"
  }

    4. Si l'action aboutit, la Réponse connectorOutputPayload de la tâche AssignManager a une valeur semblable à celle-ci:

     [{
  "Status": "True"
  }]

Exemple : DeleteManager

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action RemoveManager, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value : 
    {
  "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913"
  }

    4. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche RemoveManager a une valeur semblable à celle-ci :

     [{
  "Status": "True"
  }]

Exemple : RetrieveManagerChain

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action RetrieveManagerChain, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à celle-ci dans la section Champ Default Value: 
    {
  "UserId": "8cbe82b6-0dd5-4f10-bf67-82bf88ac6cb8",
  "Levels": "max"
  }

    4. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche RetrieveManagerChain a une valeur semblable à celle-ci :

    [{
  "id": "8cbe82b6-0dd5-4f10-bf67-82bf88ac6cb8",
  "displayName": "test1",
  "manager": "{\r\n  \"@odata.type\": \"#microsoft.graph.user\",\r\n  \"id\": \"9630c9d7-cf15-4406-8d21-598e41a058cc\",\r\n  \"deletedDateTime\": null,\r\n  \"accountEnabled\": true,\r\n  \"ageGroup\": null,\r\n  \"businessPhones\": [],\r\n  \"city\": null,\r\n  \"companyName\": null,\r\n  \"consentProvidedForMinor\": null,\r\n  \"country\": null,\r\n  \"createdDateTime\": \"2024-04-12T10:24:42Z\",\r\n  \"creationType\": null,\r\n  \"department\": null,\r\n  \"displayName\": \"Azure_AD_Test\",\r\n  \"employeeId\": null,\r\n  \"employeeHireDate\": null,\r\n  \"employeeLeaveDateTime\": null,\r\n  \"employeeType\": null,\r\n  \"externalUserState\": null,\r\n  \"externalUserStateChangeDateTime\": null,\r\n  \"faxNumber\": null,\r\n  \"givenName\": null,\r\n  \"isLicenseReconciliationNeeded\": false,\r\n  \"jobTitle\": null,\r\n  \"legalAgeGroupClassification\": null,\r\n  \"mail\": null,\r\n  \"mailNickname\": \"Azure_AD_Test\",\r\n  \"mobilePhone\": null,\r\n  \"onPremisesDistinguishedName\": null,\r\n  \"onPremisesDomainName\": null,\r\n  \"onPremisesImmutableId\": null,\r\n  \"onPremisesLastSyncDateTime\": null,\r\n  \"onPremisesSecurityIdentifier\": null,\r\n  \"onPremisesSamAccountName\": null,\r\n  \"onPremisesSyncEnabled\": null,\r\n  \"onPremisesUserPrincipalName\": null,\r\n  \"otherMails\": [],\r\n  \"passwordPolicies\": null,\r\n  \"officeLocation\": null,\r\n  \"postalCode\": null,\r\n  \"preferredDataLocation\": null,\r\n  \"preferredLanguage\": null,\r\n  \"proxyAddresses\": [],\r\n  \"refreshTokensValidFromDateTime\": \"2024-05-14T05:07:15Z\",\r\n  \"imAddresses\": [],\r\n  \"isResourceAccount\": null,\r\n  \"showInAddressList\": null,\r\n  \"securityIdentifier\": \"S-1-12-1-2519779799-1141296917-2388205965-3428360257\",\r\n  \"signInSessionsValidFromDateTime\": \"2024-05-14T05:07:15Z\",\r\n  \"state\": null,\r\n  \"streetAddress\": null,\r\n  \"surname\": null,\r\n  \"usageLocat
  ...[too long to view on UI. Please use the API to view the full content.]

Exemple : AddProfileCardProperty

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action AddProfileCardProperty, puis cliquez sur OK.
  3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à celle-ci dans la section Champ Default Value: 
     {
"Annotations": "[{"displayName": "Attributes"}]",
"DirectoryPropertyName": "CustomAttribute15"
}

    4. Si l'action aboutit, la Réponse connectorOutputPayload de la tâche AddProfileCardProperty a une valeur semblable à celle-ci:

     [{
"Status": "True"
}]

Exemple : RemoveProfileCardProperty

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action RemoveProfileCardProperty, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value : 
    {
"DirectoryPropertyName": "CustomAttribute12"
}
    4. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche RemoveProfileCardProperty a une valeur semblable à celle-ci :

     [{
"Status": "True"
}]

Exemples d'opérations sur les entités

Cette section explique comment effectuer certaines opérations d'entité dans ce connecteur.

Exemple : Lister les groupes

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "Groupes" dans la liste Entity.
  3. Sélectionnez l'opération LIST, puis cliquez sur OK.
  4. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), vous pouvez définir la filterClause conformément aux exigences du client.

Vous devez utiliser des guillemets simples (') pour encadrer la valeur de la clause de filtre. Vous pouvez utiliser la clause de filtre pour filtrer les enregistrements en fonction des colonnes.

Vous pouvez également effectuer des opérations LIST sur les entités suivantes:

  • Utilisateur
  • GroupMembers
  • Domaines
  • RoleAssignments
  • Applications
  • Appareils
  • Contacts
  • DirectoryRoleTemplates
  • DirectoryRoles
  • AdministrativeUnits
  • SubscribedSKUs
  • PhoneAuthenticationMethod
  • Organisation
  • DeviceLocalCredentials
  • ProfileCardProperties

Exemple : Obtenir un seul enregistrement du groupe

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "Groupes" dans la liste Entity.
  3. Sélectionnez l'opération GET, puis cliquez sur OK.
  4. Définissez l'ID de l'entité sur "bb4756c7-38c0-426b-97aa-03b6443e7f16", qui est la clé à transmettre. Pour définir l'ID d'entité, dans Dans la section Data Mapper de Data Mapping (Mappage de données), cliquez sur Open Data Mapping Editor (Ouvrir l'éditeur de mappage de données). Ensuite, saisissez "bb4756c7-38c0-426b-97aa-03b6443e7f16" dans le champ Input Value (Valeur d'entrée) et sélectionnez EntityId comme variable locale.

Vous pouvez également effectuer des opérations GET sur les entités suivantes :

  • Utilisateur
  • GroupMembers
  • Domaines
  • RoleAssignments
  • Applications
  • Appareils
  • Contacts
  • DirectoryRoleTemplates
  • DirectoryRoles
  • AdministrativeUnits
  • PhoneAuthenticationMethod
  • Organisation
  • UserManagers
  • DeviceLocalCredentials

Exemple : Supprimer un enregistrement du groupe

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "Groupes" dans la liste Entity.
  3. Sélectionnez l'opération DELETE, puis cliquez sur OK.
  4. Définissez l'ID de l'entité sur "62008bbe-effa-4341-9d29-eac7f67b84fe", qui est la clé à transmettre. Pour définir l'ID d'entité, dans Dans la section Data Mapper de Data Mapping (Mappage de données), cliquez sur Open Data Mapping Editor (Ouvrir l'éditeur de mappage de données). Ensuite, saisissez "62008bbe-effa-4341-9d29-eac7f67b84fe" dans le champ Input Value (Valeur d'entrée) et sélectionnez EntityId comme variable locale.

    Si deux clés primaires ou composites sont présentes, le fait de transmettre un ID d'entité peut générer une erreur. Dans ce cas, vous pouvez utiliser la clause de filtre, par exemple id='62008bbe-effa-4341-9d29-eac7f67b84fe'.

Vous pouvez également effectuer des opérations DELETE sur les entités suivantes:

  • Utilisateur
  • Domaines
  • Applications
  • Appareils

    • Exemple : Créer une entité de groupe (Microsoft 365)

    1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
    2. Sélectionnez "Groupes" dans la liste Entity.
    3. Sélectionnez l'opération Create, puis cliquez sur OK.
    4. Dans la section Data Mapper (Mappeur de données) de la tâche Data Mapping (Mappage de données), cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez EntityId/ConnectorInputPayload comme variable locale. 
      {
"securityEnabled": true,
"displayName": "GoogleGCP",
"description": "This Group is creating for gcp testing.",
"mailEnabled": false,
"mailNickname": "GoogleGCP",
"groupTypes": "Unified"
}

      Cet exemple crée les enregistrements Groupes. Si l'intégration réussit, Réponse connectorOutputPayload de la tâche Groups a une valeur semblable à celle-ci:

      {
"id": "30fc13b3-79b3-4ac5-a3ba-684d4e887ecc"
}

    Exemple : Mettre à jour un utilisateur

    1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
    2. Sélectionnez "Utilisateurs" dans la liste Entity.
    3. Sélectionnez l'opération Update, puis cliquez sur OK.
    4. Dans la section Data Mapper de la tâche Data Mapping (Mappage de données), cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à celle-ci dans la section Input Value et sélectionnez EntityId/ConnectorInputPayload/FilterClause en tant que variable locale. 
      {
"jobTitle": "Software Engineer"
}
    5. Définissez l'ID d'entité dans Data Mapper sur l'entité des utilisateurs. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez EntityId/ConnectorInputPayload/FilterClause comme variable locale.

      Au lieu de spécifier entityId, vous pouvez également définir le filterClause sur 7ad59ec3-1c37-4932-be51-7513fe98c3c3.

      Cet exemple renvoie une réponse semblable à la suivante dans le rapport la variable de sortie connectorOutputPayload de la tâche:

      {
"id": "7ad59ec3-1c37-4932-be51-7513fe98c3c3"
}

    Utiliser la connexion Azure AD (Entra ID) dans une intégration

    Une fois la connexion créée, elle devient disponible à la fois dans Apigee Integration et Application Integration. Vous pouvez utiliser la connexion lors d'une intégration via la tâche "Connecteurs".

    • Pour comprendre comment créer et utiliser la tâche "Connecteurs" dans Apigee Integration, consultez la section Tâche Connecteurs.
    • Pour découvrir comment créer et utiliser la tâche Connecteurs dans Application Integration, consultez la section Tâche Connecteurs.

    Obtenir de l'aide auprès de la communauté Google Cloud

    Vous pouvez publier vos questions et discuter de ce connecteur sur les forums Cloud de la communauté Google Cloud.

    Étape suivante