Authentification Microsoft Outlook 365

Prérequis

Dans Integration Service, lorsque vous créez une connexion à l'un de nos connecteurs basés sur Microsoft Graph, vous pouvez choisir parmi les options d'authentification suivantes :

• Code d'autorisation OAuth 2.0  : se connecte à l'application publique UiPath.
• OAuth 2.0 Informations d'identification du client : utilise un compte de service.
• Apportez votre propre application OAuth 2.0 : se connecte à une application privée que vous créez.

• Code d'autorisation OAuth 2.0: vos informations d'identification de compte Microsoft et, éventuellement, votre boîte aux lettres partagée.

Remarque :

Pour plus de détails concernant les différents types d'authentification, consultez Comment se connecter aux activités Microsoft 365 (How to se connect to Microsoft 365 activities).

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

Pour plus de détails, consultez Points de terminaison racine du service Microsoft Graph et Graph Explorer.

Consentement de l’administrateur

Remarque : cette section s'applique uniquement au code d'autorisation OAuth 2.0 et apportez vos propres options d'authentification d'application OAuth 2.0 .

De nombreuses organisations requièrent le consentement d’un administrateur avant de créer une connexion à une application externe. Le workflow de consentement de l'administrateur nécessite qu'un administrateur approuve l'enregistrement de l'application pour des utilisateurs ou des groupes spécifiques avant qu'une connexion ne soit établie. Pour plus de détails, consultez la section Présentation du workflow de consentement de l'administrateur et Consentement des utilisateurs et des administrateurs dans Microsoft Entra ID dans la documentation Microsoft.

Remarque :

Integration Service emprunte 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 que celles dont il dispose dans l'application donnée. Si vous partagez la connexion, toutes les modifications apportées à Microsoft SharePoint ou OneDrive avec cette connexion seront effectuées au nom de cet utilisateur.

Étendues

Le connecteur demande les autorisations ou les étendues suivantes :

• Code d'autorisation OAuth 2.0: Mail.Read, Mail.Read.Shared, Mail.ReadWrite, Mail.ReadWrite.Shared, Mail.Send, Calendars.ReadWrite.Shared, Mail.Send.Shared, MailboxSettings.ReadWrite, Calendars.Read, Calendars.Read.Shared, Calendars.ReadWrite, profile, openid, email, offline_access, User.Read.
• Informations d'identification du client OAuth 2.0:
  • Étendues minimales requises pour créer une connexion : Mail.Read, User.Read.
• Apportez votre propre application OAuth 2.0:
  • Étendues minimales requises pour créer une connexion : openid, offline_access, Mail.Read.
  • Liste minimale des étendues requises pour les déclencheurs Outlook :
    • openid, offline_access, Mail.Read, Mail.Read.Shared – pour les déclencheurs de boîte aux lettres partagés.
    • Calendars.Read : pour les événements sur les calendriers.
    • Calendars.Read.Shared : pour les événements sur les calendriers partagés.

Remarque : si vous vous authentifiez via Apporter votre propre application OAuth 2.0 (Bring your Own OAuth 2.0 app), vous bénéficiez par défaut des étendues configurées lors de la création de l'application. Si vous souhaitez utiliser les autorisations d'application par défaut, déclarez une étendue common . Cela signifie que vous utilisez uniquement les autorisations configurées pour cette application dans Azure. Pour déclarer des étendues supplémentaires lors de la création de la connexion, utilisez le champ Étendues . Ensuite, vous êtes invité à accorder le consentement supplémentaire lors de la connexion.

Ajouter la connexion Microsoft Outlook 365

Pour créer une connexion à votre instance Microsoft Outlook 365 , procédez comme suit :

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.

   Choisissez l'un des types d'authentification suivants : Code d'autorisation OAuth 2.0, Informations d’identification du client OAuth ou Apporter votre propre application OAuth 2.0.

   • Pour le code d'autorisation OAuth 2.0 (OAuth 2.0 Authorization code), sélectionnez Connecter (Connect) et authentifiez-vous avec votre adresse e-mail et votre mot de passe Microsoft.
     Remarque :

     • Toutes les activités Outlook héritent de la boîte aux lettres partagée que vous saisissez dans le champ Boîte aux lettres partagée une fois connecté.
     • Saisissez votre boîte aux lettres partagée dans le champ Boîte aux lettres partagée (Shared mailbox) , dont toutes les activités Outlook héritent une fois que vous vous connectez.
     • Si vous sélectionnez OAuth 2.0 Informations d'identification du client (Client credentials), vous devez fournir un compte. Cela représente le compte utilisé pour emprunter l'identité d'un utilisateur.
   • Pour Apporter votre propre application OAuth 2.0 (Bring your Own OAuth 2.0 app), vous devez fournir un ID de client (Client ID) et une Clé secrète de client (Client secret), l' ID de locataire (Tenant ID) et les étendues requises pour interagir avec différentes activités. Consultez la documentation de l'activité pour savoir quelles étendues elles nécessitent.
     Remarque : Si vous utilisez une application multilocataire, conservez la valeur par défaut pour l' ID de locataire (common). Si vous utilisez une seule application de locataire, récupérez l' ID de locataire à partir d'Azure. Pour plus de détails, consultez 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

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 une application Web .
3. 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.
4. Vous devez configurer des autorisations déléguées. Pour plus d’informations, consultez la section Autorisations dans la documentation officielle de Microsoft.
5. Générez une clé secrète de client pour votre application.

Attention : L'avantage d'utiliser votre application privée OAuth 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 , reportez-vous à la section Utiliser des étendues et consultez la documentation des activités .

Le connecteur utilise l'API Microsoft Graph. Reportez-vous à 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.