Azure AD (ID Entra)

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 :
    • Vérifiez que la connectivité réseau est configurée. Pour en savoir plus sur les modèles de réseau, consultez la section Connectivité réseau.
    • Attribuez le rôle IAM roles/connectors.admin à l'utilisateur qui configure le 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.

  • 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.

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 peuvent 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'octroi 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

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 du 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
ID 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 "Champ d'application", vérifiez les points suivants :
  • Vous devez fournir les autorisations User.Read.All et User.Write.All au niveau de la connexion et 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 client avec code secret Oui
ID client XXXX
Code secret du client XXXX
Version du secret 1

Identifiants client OAuth 2.0 avec le 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
ID 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 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.

Effectuer une nouvelle autorisation au 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 réautoriser une connexion, procédez comme suit:

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

    La page des détails de la connexion s'ouvre.

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

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

  4. Cliquez sur Enregistrer. Vous êtes redirigé vers la page d'informations sur la connexion.
  5. Cliquez sur Modifier l'autorisation dans la section Authentification. Le volet Authorize (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, recherchez la connexion que vous venez de créer.

    Notez que l'état du nouveau connecteur est 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 informations d'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, les connecteurs d'intégration allouent deux nœuds (pour une meilleure disponibilité) à une connexion.

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

Actions

Cette section liste certaines des actions compatibles 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 RemoveGroupMember

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 obtenir un exemple de configuration de cette action, consultez la section Exemples.

Action AddGroupMember(Guest Account)

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 de configuration de cette action, consultez la section 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 obtenir un exemple de configuration de 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 de configuration de cette action, consultez la section Exemples.

Action RemoveUserApplicationRoleAssignment

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 de rôle d'application.
UserId Chaîne Oui Identifiant unique de l'utilisateur.

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

Action AddGroupApplicationRoleAssignment

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

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 de l'application.
ID du groupe Chaîne Oui Identifiant unique du groupe

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

Action RemoveGroupApplicationRoleAssignment

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 obtenir un exemple de configuration de 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 ID du directoryRoleTemplate sur lequel le rôle est basé.

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

Action VerifyDomain

Cette action permet de valider 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 obtenir un exemple de configuration de 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 de configuration de cette action, consultez la section Exemples.

Action ResetPassword

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 obtenir un exemple de configuration de 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 auquel 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 Oui Identifiant unique du SKU.
DisabledPlans Chaîne Non Ensemble des identifiants uniques des forfaits désactivés, séparés par une virgule.
RemoveLicenses Chaîne Non Ensemble de 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 "RemoveLicense"

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 auquel 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 Non Identifiant unique du SKU.
DisabledPlans Chaîne Non Ensemble des identifiants uniques des forfaits désactivés, séparés par une virgule.
RemoveLicenses Chaîne Oui Ensemble de 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 FetchAdditionalUserFields

Cette action récupère les champs d'attribut 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 de configuration de cette action, consultez la section 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 obtenir un exemple de configuration de 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 de configuration de cette action, consultez la section 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 obtenir un exemple de configuration de 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 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 obtenir un exemple de configuration de cette action, consultez la section Exemples.

Action RemovePhoneAuthenticationMethod

Cette action supprime la méthode d'authentification par téléphone d'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 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 de configuration de cette action, consultez la section Exemples.

Action UpdatePhoneAuthenticationMethod

Cette action met à jour la méthode d'authentification par téléphone d'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 type de téléphone.
PhoneNumber Chaîne Oui Numéro de téléphone de la méthode d'authentification.

Pour obtenir un exemple de configuration de cette action, consultez la section 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 principal auquel l'éligibilité au rôle a été accordée.
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 obtenir un exemple de configuration de cette action, consultez la section Exemples.

Action RemovePrivilegedRole

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 principal auquel l'éligibilité au rôle a été accordée.
RoleDefinitionId Chaîne Oui Identifiant de l'objet unifiedRoleDefinition supprimé du principal.
Justification Chaîne Oui Message fourni par les utilisateurs et les administrateurs.

Action RetrieveUserPhoto

Cette action récupère une photo d'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 de l'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 de configuration de cette action, consultez la section 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 ID de l'utilisateur.
Contenu Chaîne Oui Contenu photo à importer.

Pour obtenir un exemple de configuration de 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 administrateur à 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 de l'organisation à ajouter.
UserId Chaîne Oui Identifiant unique de l'utilisateur.

Pour obtenir un exemple de configuration de 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 obtenir un exemple de configuration de 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. Spécifiez "max" pour renvoyer tous les administrateurs.
UserId Chaîne Oui ID de l'utilisateur.

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

Action AddProfileCardProperty

Cette action ajoute une 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é de répertoire.

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

Le tableau suivant répertorie les autorisations requises pour effectuer les opérations de liste et d'extraction sur les propriétés profilecardproperties:

Autorisation Type
People.Read.All Application
PeopleSettings.Read.All Délégué
PeopleSettings.Read.All Application

Le tableau suivant répertorie les autorisations requises pour effectuer l'action "Créer" sur profilecardproperties:

Autorisation Type
PeopleSettings.ReadWrite.All Application
PeopleSettings.ReadWrite.All Délégué

Action RemoveProfileCardProperty

Cette action supprime une propriété 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 de configuration de cette action, consultez la section 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 le message de confirmation de l'opération AddGroupMember. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche AddGroupMember a une valeur semblable à la suivante:

    [{
  "Success": "True"
  }]

Exemple : RemoveGroupMember

  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 à la suivante dans le champ Default Value: 
    {
  "MemberId": "5408040c-fb7d-4c36-8b67-3b66e9edaad3",
  "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 : 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 : RemoveGroupMember(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 à 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 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 à la suivante dans le 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 réussit, le paramètre de 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 réussit, le paramètre de 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 réussit, le paramètre de 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 à la suivante dans le champ Default Value: 
     {
  "RoleTemplateId": "f023fd81-a637-4b56-95fd-791ac0226033"
  }

    4. Si l'action réussit, le paramètre de 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 à la suivante dans le 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 à la suivante dans le champ Default Value: 
    {
  "Password": "XXX@9876",
  "UserId": "3558ca6e-2c2e-41d3-a854-bf9249a3c913"
  }

    4. Si l'action réussit, le paramètre de 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 à la suivante dans le champ Default Value: 
    {
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100",
  "OwnerId": "9630c9d7-cf15-4406-8d21-598e41a058cc"
  }

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

    [{
  "Success": "True"
  }]

Exemple : RemoveGroupOwner

  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 à la suivante dans le champ Default Value: 
    {
  "GroupId": "0f6e79a7-3578-48b4-9dde-decfbb7bb100",
  "OwnerId": "9630c9d7-cf15-4406-8d21-598e41a058cc"
  }

    4. Si l'action réussit, le paramètre de 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 à la suivante dans le champ Default Value: 
    {
  "UserEmailAddress": "taleprajyot97@gmail.com",
  "RedirectURL": "https://www.example.com"
  }

    4. Cette action renvoie le message de confirmation de l'invite externe. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche InviteExternalUser a une valeur semblable à la suivante:

    [{
  "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 à la suivante dans le 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 à la suivante dans le 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 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 réussit, le paramètre de 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 réussit, le paramètre de réponse connectorOutputPayload de la tâche AddPrivilegedRole a une valeur semblable à celle-ci : 

    [{
  "Success": "True"
  }]

Exemple : RemovePrivilegedRole

  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 à la suivante dans le 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 à la suivante dans le champ Default Value: 
    {
  "UserId": "8e22c728-c523-436b-8f46-3b21cc1b5f80"
  }

    4. Si l'action réussit, le paramètre de 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 réussit, le paramètre de réponse connectorOutputPayload de la tâche UpdateUserPhoto a une valeur semblable à celle-ci:

     [{
  "Status": "Success"
  }]

Exemple : RemoveUserPhoto

  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 réussit, le paramètre de 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 réussit, le paramètre de réponse connectorOutputPayload de la tâche AssignManager a une valeur semblable à celle-ci:

     [{
  "Status": "True"
  }]

Exemple : RemoveManager

  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 à la suivante dans le 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 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: 
     {
"Annotations": "[{"displayName": "Attributes"}]",
"DirectoryPropertyName": "CustomAttribute15"
}

    4. Si l'action réussit, le paramètre de 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 d'entité

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 la section Data Mapper (Mappeur de données) de Data Mapping (Mappage de données), cliquez sur Open Data Mapping Editor (Ouvrir l'éditeur de mappage de données), puis saisissez "bb4756c7-38c0-426b-97aa-03b6443e7f16" dans le champ Input Value (Valeur d'entrée) et choisissez 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 la section Data Mapper (Mappeur de données) de Data Mapping (Mappage de données), cliquez sur Open Data Mapping Editor (Ouvrir l'éditeur de mappage de données), puis saisissez "62008bbe-effa-4341-9d29-eac7f67b84fe" dans le champ Input Value (Valeur d'entrée) et choisissez EntityId comme variable locale.

    Si deux clés composites ou primaires 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 de groupes. Si l'intégration aboutit, le paramètre de 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 (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/FilterClause comme 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.

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

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

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

    Utiliser la connexion Azure AD (ID Entra) 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 dans une intégration via la tâche Connecteurs.

    • Pour savoir comment créer et utiliser la tâche Connecteurs dans Apigee Integration, consultez la section Tâche Connecteurs.
    • Pour savoir 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