Authentification pour Microsoft Dynamics 365 CRM

Connectez UiPath à Microsoft Dynamics 365 CRM à l'aide de l'authentification OAuth 2.0 dans Automation Suite.

UiPath Integration Service permet une connectivité sécurisée vers votre instance Microsoft Dynamics 365 CRM à l'aide de l'authentification basée sur OAuth 2.0. Une fois authentifié, vous pouvez créer une connexion qui permet l'accès au niveau de l'API aux données Dynamics 365 CRM pour les workflows d'automatisation.

L'ajout d'une connexion à Microsoft Dynamics 365 CRM permet aux produits UiPath d'interagir avec vos données CRM, notamment la lecture, l'écriture, la modification et la suppression d'enregistrements, en fonction des autorisations de l'utilisateur authentifié dans Dynamics 365 CRM.

Vous pouvez créer une connexion Dynamics 365 CRM à l'aide de la méthode d'authentification d'application Apporter votre propre OAuth 2.0 (enregistrement d'application personnalisée).

Sur l’écran de connexion, vous devez fournir les détails suivants :

• ID de client
• Secret du client
• URL du locataire

Important :

L'URI de rappel/redirection https://{yourDomain}/provisioning_/callback doit être ajouté aux paramètres d'enregistrement de votre application Azure AD sous les URI de redirection avec le type Web .

Cette URL de rappel est préconfigurée par UiPath et ne peut pas être modifiée dans l’interface utilisateur d’Integration Service.

Champs obligatoires expliqués

Champ	Description
ID de client	ID d'application Azure AD (requis uniquement si vous utilisez votre propre application).
Secret du client	La clé secrète que vous avez générée pour votre application Azure AD (requis pour une application personnalisée).
URL du locataire	URL de votre instance Dynamics 365 CRM (pour les deux options).
URL de rappel	Valeur préremplie affichée lors de l'utilisation d'une application personnalisée ; vous devez enregistrer cette URL dans Azure AD.

Récupérer vos identifiants

Pour rechercher votre URL de locataire, contactez votre administrateur Microsoft Dynamics.

Remarque :

• Le consentement de l'administrateur peut être requis dans votre locataire pour les autorisations d'application que vous demandez.
• L'application personnalisée doit être configurée avec les autorisations déléguées pour Dynamics CRM.

Si vous avez accès et utilisez un seul locataire global, suivez ces étapes :

1. Accédez à https://portal.azure.com.

2. Sélectionnez Azure Active Directory.

3. Accédez à Propriétés sous la section Gérer .

4. Votre locataire est l' ID de locataire, par exemple : sample083151e4.api.crm10.dynamics.com.

   Remarque :

   Any mistake in the Tenant URL prevents you from authenticating and creating a connection.

Si vous souhaitez créer votre propre application OAuth 2.0 privée, suivez les étapes décrites dans la documentation Microsoft Dynamics 365 :

• Démarrage rapide : Enregistrer une application avec la plate-forme d'identités Microsoft
• Tutoriel : enregistrer une application avec Microsoft Entra ID

Autorisations et consentement

Pour fonctionner correctement, la connexion Dynamics 365 CRM nécessite les étendues OAuth suivantes :

• user_impersonation
• offline_access
• User.Read

Vous pouvez utiliser la connexion pour activer les activités Microsoft Dynamics 365 CRM dans UiPath Studio afin de créer des automatisations pour la gestion des comptes, des leads, des opportunités, des incidents et d'autres fonctionnalités CRM. Les différents cas d’utilisation basés sur les autorisations qui peuvent être atteints sont les suivants :

Étendue/Autorisation	Use case	Activité/événement
user_impersonation (requis)	L'étendue user_impersonation est nécessaire à la demande dans votre flux d'authentification pour fonctionner avec l'API de gestion Azure. L'emprunt d'identité est utilisé pour exécuter une logique métier (code) au nom d'un autre utilisateur Microsoft Dataverse afin de fournir une fonctionnalité ou un service souhaité en utilisant le rôle approprié et la sécurité basée sur des objets de cet utilisateur impersonné. Cela est nécessaire car les services Web Dataverse peuvent être appelés par divers clients et services au nom d'un utilisateur Dataverse, par exemple, dans un workflow ou une solution ISV personnalisée.	S/O
offline_access (requis)	Le offline_access est nécessaire pour recevoir le jeton d'actualisation dans le point de terminaison de la demande d'authentification. Lorsque vous utilisez un code d'autorisation dans le flux de code d'autorisation OAuth 2.0 sans étendueoffline_access , vous ne recevrez pas le jeton d'actualisation du point de terminaison /token .	S/O
User.Read (requis)	Permet aux utilisateurs de se connecter à l'application et permet à l'application de lire le profil des utilisateurs connectés. Il permet également à l'application de lire les informations de base de l'entreprise sur les utilisateurs connectés.	S/O

Le consentement de l'administrateur peut être requis en fonction des politiques Azure AD de votre entreprise.

Actualiser les jetons pour les applications OAuth

Les jetons de réactualisation pour les applications OAuth peuvent être invalidés ou révoqués à tout moment par Microsoft. Cela peut se produire pour différentes raisons, telles que des délais d’attente ou des révocations. Pour plus d’informations, consultez la documentation officielle de Microsoft .

Remarque :

L'invalidation du jeton entraîne des connexions échouées et les automatisations ne peuvent pas s'exécuter sans que les connexions soient réparées.

Ce problème affecte tous les connecteurs basés sur Microsoft Graph.

Assurez-vous de suivre les meilleures pratiques de Microsoft lors de la création de vos applications OAuth. Pour en savoir plus sur la création d'une application Microsoft OAuth, consultez la documentation Microsoft .

Ajouter la connexion Microsoft Dynamics 365

1. Sélectionnez Integration Service dans la barre de gauche.
2. Dans la liste Connecteurs , sélectionnez Microsoft Dynamics 365 CRM. Vous pouvez également utiliser la barre de recherche pour affiner le connecteur.
3. Sélectionnez Se connecter à Microsoft Dynamics 365 CRM.
4. Vous êtes maintenant redirigé vers la page de connexion.
5. Entrez les identifiants requis.
6. Select Connect.

Pour plus d'informations sur Microsoft Dynamics 365, consultez la documentation Microsoft Dynamics 365.

Résolution des problèmes de configuration courants

• URI de redirection non valide : assurez-vous que votre application Azure AD dispose exactement de l'URL de rappel https://{yourDomain}/provisioning_/callback.
• Autorisations non accordées : le consentement de l'administrateur peut être requis pour les étendues Dynamics CRM.
• URL de locataire incorrecte : vérifiez que vous utilisez l'URL de base CRM exacte de votre organisation.
• Problèmes de jeton d'actualisation/de consentement : ces problèmes peuvent entraîner l'échec des connexions si la configuration Azure AD change après le consentement initial.