Authentification Microsoft Outlook 365

Prérequis

Selon le type d'authentification que vous sélectionnez, vous avez besoin de l'un des éléments suivants :

• L'adresse e-mail et le mot de passe de votre compte Microsoft.
• L'ID de client et la clé secrète du client de votre application, les étendues et l'ID de locataire.

De plus, vous devez accorder des autorisations à des applications tierces pour accéder à vos informations. Pour toute erreur, contactez votre administrateur Microsoft Outlook 365.

Remarque :

Integration Service empruntera l'identité de l'utilisateur qui crée la connexion. Les informations d'identification de l'utilisateur offrent l'accès à toutes les mêmes ressources qu'il a dans l'application donnée. Si vous partagez la connexion, chaque modification apportée à Microsoft Outlook avec cette connexion est effectuée au nom de cet utilisateur.

Environnement (Environment)

Lorsque vous accédez pour la première fois à l'écran Authentification (Authentication), vous pouvez sélectionner un environnement (Environment). Les options disponibles sont :

• Office 365 (par défaut)
• L4 du gouvernement américain - Domaine du secteur public
• US Government L5 - Domaine du secteur public
• Chine

Accorder des autorisations à des applications tierces

Avant d'établir la connexion, assurez-vous que les autorisations sont accordées pour les applications intégrées, comme expliqué dans la documentation officielle de Microsoft : Configurer les paramètres de consentement des utilisateurs (Configure user consent settings).

Étendues

Les étendues suivantes sont demandées par le connecteur : Mail.Read, Mail.Read.Shared, Mail.ReadWrite, Mail.ReadWrite.Shared, Mail.Send, Mail.Send.Shared, MailboxSettings.ReadWrite, Calendars.Read, Calendars.Read.Shared, Calendars.ReadWrite, Calendars.ReadWrite.Shared, profile, openid, email, offline_access, User.Read.

Cela représente la liste complète des étendues requises.

Remarque : veuillez travailler avec votre équipe informatique afin d'accorder ces privilèges pour votre utilisateur et votre application.

Ajouter la connexion Microsoft Outlook 365

Pour créer une connexion à votre instance Microsoft Outlook 365, vous devez effectuer les étapes suivantes :

1. Sélectionnez Integration Service dans Automation Cloud^TM pour le secteur public.

2. Dans la liste Connecteurs , sélectionnez Microsoft Outlook 365. Vous pouvez également utiliser la barre de recherche pour trouver le connecteur.

3. Sélectionnez le bouton Se connecter à Microsoft Outlook 365 .
4. Vous êtes maintenant redirigé vers la page de connexion. Vous pouvez choisir entre deux types d'authentification : Code d'autorisation OAuth 2.0 ou Fournissez votre propre application OAuth 2.0.
   • Si vous sélectionnez le code d'autorisation OAuth 2.0, cliquez sur Connecter ( Connect), puis authentifiez-vous à l'aide de votre adresse e-mail et de votre mot de passe Microsoft.
   • Si vous sélectionnez Apporter votre propre application OAuth 2.0, vous devez fournir un ID de client et une clé secrète de client, l' ID de locataire et les étendues dont vous devrez peut-être interagir avec différentes activités. Consultez la documentation relative aux activités pour connaître les étendues requises.
     Remarque : Si vous utilisez une application multilocataire, conservez la valeur par défaut de l ' ID de locataire (common). Si vous utilisez une seule application de locataire, récupérez l' ID du locataire à partir d'Azure. Reportez-vous à la section Comment trouver votre ID de locataire Microsoft Entra.
5. Votre connexion a été ajoutée.

Si vous rencontrez des erreurs lors du processus de connexion, il est recommandé de contacter votre administrateur Microsoft Outlook 365.

Pour plus d'informations, reportez-vous à la documentation du connecteur Office 365 Outlook.

Apportez votre propre application OAuth 2.0

Dans Integration Service, lors de la création d'une connexion à l'un de nos connecteurs basés sur Microsoft Graph, vous pouvez choisir entre deux options d'authentification :

• Code d'autorisation OAuth 2.0 : qui se connecte à l'application publique UiPath.
• Apportez votre propre application OAuth 2.0 – qui se connecte à une application privée que vous créez.

Pour savoir comment créer une application, accédez à la documentation officielle de Microsoft et suivez les étapes décrites : Enregistrer une application avec la plate-forme d'identités Microsoft.

Remarque : Il s'agit d'une fonctionnalité avancée qui requiert des privilèges d'administrateur dans l'application cible. Travaillez avec votre administrateur informatique pour configurer votre application avec succès.

Prérequis

Lors de la création de votre propre application à utiliser avec Integration Service, vous devez tenir compte des prérequis suivants :

1. Vous devez configurer l'application en tant qu'application multilocataire ou à locataire unique .
2. Vous devez configurer un URI de redirection Web . L' URI de redirection (ou URL de rappel) pour votre application OAuth 2.0 est fourni sur l'écran d'authentification lors de la création d'une connexion : https://Gocloud.uipath.us/provisioning_/callback.
3. Vous devez configurer des autorisations déléguées. Pour plus d'informations, consultez Autorisations ( Permissions ) dans la documentation officielle de Microsoft.
   Remarque : l'avantage d'utiliser votre application OAuth privée réside dans le fait que vous pouvez personnaliser les autorisations en fonction de vos besoins réels. Pour savoir quelles étendues sont requises pour chaque activité dans le package Microsoft 365, consultez la documentation des activités .

   Le connecteur utilise l'API Microsoft Graph. Consultez la page de référence des autorisations Microsoft Graph pour plus de détails sur toutes les autorisations.

Après avoir créé votre application, utilisez son ID de client (Client ID) et sa clé secrète de client (Client Secret) pour créer une connexion avec les connecteurs Microsoft.

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 les délais d'attente et les révocations. Pour plus de détails, consultez la documentation officielle de Microsoft.

Avertissement : l'invalidation du jeton entraîne des connexions échouées et les automatisations ne peuvent pas s'exécuter sans que les connexions soient corrigées.

Veillez à suivre les bonnes pratiques de Microsoft lors de la création de vos applications OAuth. Pour plus d'informations sur la création d'une application Microsoft OAuth, consultez la documentation Microsoft.

Ce problème affecte non seulement le connecteur OneDrive et SharePoint, mais tous les connecteurs basés sur Microsoft Graph, tels qu'Outlook ou Teams.