Authentification Microsoft Outlook 365

Prérequis

In Integration Service, when you create a connection to one of our Microsoft Graph-based connectors, you can choose between the following authentication options:

• Code d'autorisation OAuth 2.0  : se connecte à l'application publique UiPath.
• OAuth 2.0 Client credentials – uses a service account.
• 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 :

For more details regarding the different authentication types, check How to 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

For details, check Microsoft Graph and Graph Explorer service root endpoints.

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 .

Many organizations require the consent of an administrator before you create a connection to an external application. The admin consent workflow requires an admin to approve the app registration to specific users or groups before a connection is established. For more details, chek Overview of admin consent workflow and User and admin consent in Microsoft Entra ID in the Microsoft documentation.

Remarque :

Integration Service impersonates the user that creates the connection. The credentials of the user offer access to all of the same resources that they have in the given application. If you share the connection, every change made to Microsoft SharePoint or OneDrive with that connection is made on behalf of that user.

Étendues

The connector requests the following permissions or scopes:

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

Note: If you authenticate through Bring your own OAuth 2.0 app, you benefit by default from the scopes configured at app creation. If you want to use the default app permissions, declare a common scope. This means you use only the permissions configured for that application in Azure. To declare additional scopes at connection creation, use the Scopes field. Next, you are prompted to grant the additional consent during sign-in.

Ajouter la connexion Microsoft Outlook 365

To create a connection to your Microsoft Outlook 365 instance, perform the following steps:

1. Sélectionnez Integration Service à partir d' Automation Cloud^TM.

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.

   Choose between the following authentication types: OAuth 2.0 Authorization code, OAuth Client credentials, or Bring your own OAuth 2.0 app.

   • For OAuth 2.0 Authorization code, select Connect, and authenticate with your Microsoft email address and password.
     Remarque :

     • All Outlook activities inherit the shared mailbox you enter in the Shared mailbox field once you connect.
     • Enter your shared mailbox in the Shared mailbox field, which all Outlook activities inherit once you connect.
     • 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.
   • For Bring your own OAuth 2.0 app, you must provide a Client ID and Client secret, the Tenant ID, and the scopes required to interact with different activities. Check out the activities' documentation to learn what scopes they require.
     Note: If you use a multitenant application, keep the default value for the Tenant ID (common). If you use a single tenant application, retrieve the Tenant ID from Azure. For more details, check How to find your Microsoft Entra tenant ID.
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://cloud.uipath.com/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.