Authentification pour Microsoft Dynamics 365 CRM

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.

Types d'authentification pris en charge

Lors de la création d'une connexion Dynamics 365 CRM, vous pouvez choisir entre deux types d'authentification :

• Code d'autorisation OAuth 2.0 (par défaut et recommandé)
• Apporter votre propre application OAuth 2.0 (inscription d'application personnalisée)

Code d’autorisation OAuth 2.0

Il s’agit de la méthode d’authentification la plus simple. Cette option utilise l'application Azure AD gérée par UiPath pour gérer la connexion des utilisateurs et l'acquisition de jetons.

1. Sur l'écran de création de connexion, sélectionnez Code d'autorisation OAuth 2.0.

2. Saisissez l ' URL du locataire (https://<yourorg>.crm.dynamics.com)

   Remarque :

   La valeur de l' URL du locataire doit correspondre exactement à votre domaine de base Dynamics 365 CRM.

3. Cliquez sur Se connecter (Connect).

4. Vous êtes redirigé vers les écrans de connexion et de consentement de Microsoft pour vous authentifier.

   Cette méthode ne nécessite aucune configuration supplémentaire dans Azure AD et convient à la plupart des utilisateurs.

Apportez votre propre application OAuth 2.0

Utilisez cette option si votre organisation nécessite un contrôle centralisé des inscriptions d’applications Azure AD, des étendues ou des politiques de conformité.

Lorsque vous sélectionnez Apporter votre propre OAuth 2.0 sur l’écran de connexion, vous devez fournir les informations suivantes :

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

Important :

L'URI de rappel/redirection https://{baseURL}/provisioning_/callback doit être ajouté exactement tel qu'affiché sur l'écran de connexion aux paramètres d'enregistrement de votre https://cloud.uipath.com/provisioning_/callback Azure AD sous 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.

Quand utiliser une application personnalisée

Utilisez cette option si :

• Votre organisation nécessite des inscriptions d'application Azure AD gérées par l'administrateur.
• Vous souhaitez contrôler avec précision les autorisations et les étendues des applications.
• Vous devez suivre des politiques de sécurité internes pour les applications OAuth.

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.

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.

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. Select Orchestrator from the product launcher.
2. Select a folder, and then navigate to the Connections tab.
3. Sélectionnez Ajouter une connexion (Add connecion).
4. To open the connection creation page, select the connector from the list. You can use the search bar to find the connector.
5. Vous pouvez choisir entre deux types d'authentification : Code d'autorisation OAuth 2.0 ou Fournissez votre propre application OAuth 2.0.
6. Saisissez les informations d’identification requises et sélectionnez 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://{baseURL}/provisioning_/callback (par exemple https://cloud.uipath.com/provisioning_/callback) enregistrée dans les URI de redirection.
• 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.