Authentification Microsoft Outlook 365

Connectez UiPath à Microsoft Outlook 365 à l'aide du certificat client, des informations d'identification client OAuth 2.0 ou d'autres méthodes prises en charge dans Automation Suite.

Vue d'ensemble (Overview)

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 :

• Authentification du certificat client : se connecte à l'aide d'un certificat client au lieu d'une clé secrète client.
• Informations d’identification du client OAuth 2.0 : utilise un compte de service et, éventuellement, se connecte à votre boîte aux lettres partagée.
• Apporter votre propre application OAuth 2.0 : se connecte à une application privée que vous créez et, éventuellement, à votre boîte aux lettres partagée.

Lors de l'enregistrement de votre application dans Microsoft Azure, utilisez le type d'autorisation correspondant à votre méthode d'authentification:

Type d’authentification	Type d’autorisation Microsoft
Authentification du certificat client	Application
Informations d'identification du client OAuth 2.0	Application
Apportez votre propre application OAuth 2.0	Délégué

Si vous rencontrez des erreurs lors du processus de connexion, il est recommandé de contacter votre administrateur Microsoft Outlook 365. Pour plus d’informations, consultez la documentation du connecteur Office 365 Outlook.

Consentement de l’administrateur

Remarque :

Cette section s’applique uniquement aux options d’authentification de l’application Apporter votre propre OAuth 2.0 .

De nombreuses organisations nécessitent 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'inscription de l'application à des utilisateurs ou à des groupes spécifiques avant qu'une connexion ne soit établie. Pour plus de détails, consultez les sections Présentation du workflow de consentement de l’administrateur et Consentement de l’utilisateur et de l’administrateur 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.

Authentification du certificat client

Étendues

Le connecteur nécessite les étendues minimales suivantes pour créer une connexion : Mail.Read, User.Read.All, ou User.Read.

Le connecteur nécessite les étendues suivantes pour que toutes les activités fonctionnent : User.Read, User.Read.All, 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, et offline_access.

Pour ajouter des autorisations plus précises, reportez-vous à la documentation des activités.

Ajouter la connexion Microsoft Outlook 365

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

1. Dans Automation Cloud, sélectionnez Integration Service dans le menu du rail.
2. Dans la liste Connecteurs , sélectionnez Microsoft Outlook 365 ou utilisez la barre de recherche pour trouver le connecteur.
3. Sélectionnez Se connecter à Microsoft Outlook 365, ce qui vous redirige vers la page de connexion.
4. Sélectionnez le type d’authentification Authentification du certificat client .
5. Configurer les éléments suivants :
   • ID Client : l'ID de la section Vue d'ensemble de l'enregistrement de votre application Microsoft Azure.
   • Mot de passe du certificat : le mot de passe que vous avez défini lors de la création du certificat.
   • Certificat client OAuth base64 : le certificat client est généré dans un format de fichier .pfx , que vous devez convertir au format encodé en Base64 et le fournir dans ce champ.
   • ID de locataire : l'ID de locataire Microsoft Azure pour une application provenant de la section Vue d'ensemble de l'enregistrement de votre application Microsoft Azure.
   • Environnement : de manière facultative, sélectionnez un environnement dans la liste déroulante :
     • Office 365 (par défaut)
     • US Government L4 - Domaine du secteur public
     • US Government L5 - Domaine du secteur public
     • ChineSélectionnez Office 365 (par défaut) pour toutes les régions et passez uniquement à Government ou China pour les déploiements cloud. Pour plus de détails sur les environnements, consultez les points de terminaison Microsoft Graph et Graph Explorer.
   • Compte - Saisissez le nom principal d’utilisateur (UPN) du compte ou de la boîte aux lettres partagée que le système doit utiliser dans la connexion. Ceci est nécessaire pour que la connexion soit établie.
6. Select Connect.
7. Authentifiez-vous à l'aide de votre adresse e-mail et de votre mot de passe Microsoft.

Informations d'identification du client OAuth 2.0

Étendues

Les étendues minimales requises pour créer une connexion sont les suivantes : Mail.Read et User.Read.All

Le connecteur nécessite les étendues suivantes pour que toutes les activités fonctionnent : User.Read, User.Read.All, 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, et offline_access.

Pour ajouter des autorisations plus précises, reportez-vous à la documentation des activités.

Ajouter la connexion Microsoft Outlook 365

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

1. Dans Automation Cloud, sélectionnez Integration Service dans le menu du rail.
2. Dans la liste Connecteurs , sélectionnez Microsoft Outlook 365 ou utilisez la barre de recherche pour trouver le connecteur.
3. Sélectionnez Se connecter à Microsoft Outlook 365, ce qui vous redirige vers la page de connexion.
4. Entrez les identifiants requis.
   Remarque :

   • Vous devez fournir les éléments suivants : l'ID du client, la clé secrète du client, l'ID du locataire et les étendues dont vous pourriez avoir besoin pour interagir avec différentes activités. Pour de plus amples informations, consultez la section Étendues précédente.
   • Si vous utilisez une application multilocataire, conservez la valeur par défaut common pour le champ ID de locataire .
   • Si vous utilisez une application à locataire unique, récupérez l’ID de locataire à partir d’Azure. Pour plus de détails, consultez la section Comment trouver votre identifiant de locataire Microsoft Entra.
5. Select Connect.
6. Authentifiez-vous à l'aide de votre adresse e-mail et de votre mot de passe Microsoft.

Apportez votre propre application OAuth 2.0

Vue d'ensemble (Overview)

Pour apprendre à 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é Microsoft.

Remarque :

Il s'agit d'une fonctionnalité avancée qui nécessite 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 en tant qu’application multi-locataire ou à locataire unique .
2. Vous devez configurer une application Web .
3. Vous devez configurer un URI de redirection Web . L' URI de redirection ou l'URL de rappel de votre application OAuth 2.0 est fourni sur l'écran d'authentification lors de la création de la connexion : https://{yourDomain}/provisioning_/callback.
4. Vous devez configurer des autorisations déléguées. Pour de plus amples informations, consultez la section Autorisations dans la documentation officielle de Microsoft.
5. Générez une clé secrète de client pour votre application.
   Important :

   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 connaître les étendues requises pour chaque activité dans le package Microsoft 365, reportez-vous à 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 l’ ID client et la clé secrète du client pour créer une connexion avec les connecteurs Microsoft.

Étendues

• Le connecteur nécessite les étendues minimales suivantes pour créer une connexion : openid, offline_access, Mail.Read.
• Les déclencheurs Outlook nécessitent les étendues minimales suivantes :
  • Pour les déclencheurs de boîte aux lettres partagés : openid, offline_access, Mail.Read, Mail.Read.Shared.
  • Pour les événements sur les calendriers : Calendars.Read.
  • Pour les événements sur les calendriers partagés : Calendars.Read.Shared.

Le connecteur nécessite les étendues suivantes pour que toutes les activités fonctionnent : User.Read, User.Read.All, 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, et offline_access.

Pour ajouter des autorisations plus précises, reportez-vous à la documentation des activités.

Ajouter la connexion Microsoft Outlook 365

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

1. Dans Automation Cloud, sélectionnez Integration Service dans le menu du rail.
2. Dans la liste Connecteurs , sélectionnez Microsoft Outlook 365 ou utilisez la barre de recherche pour trouver le connecteur.
3. Sélectionnez Se connecter à Microsoft Outlook 365, ce qui vous redirige vers la page de connexion.
4. Sélectionnez le type d’authentification Apporter votre propre OAuth 2.0 .
5. Configurer les éléments suivants :
   • IDClient : l'ID client de la section Vue d'ensemble de l'enregistrement de votre application Microsoft Azure.
   • Secret du client : le secret du client de la section Certificats et clés secrètes de votre application Microsoft Azure.
   • ID de locataire : l'ID de locataire Microsoft Azure pour une application de la section Vue d'ensemble.
     Remarque :

     • Si vous utilisez une application multilocataire, conservez la valeur par défaut common.
     • Si vous utilisez une application à locataire unique, récupérez l’ID de locataire à partir d’Azure. Pour plus de détails, consultez la section Comment trouver votre identifiant de locataire Microsoft Entra.
   • Environnement : de manière facultative, sélectionnez un environnement dans la liste déroulante :
     • Office 365 (par défaut)
     • US Government L4 - Domaine du secteur public
     • US Government L5 - Domaine du secteur public
     • ChineSélectionnez Office 365 (par défaut) pour toutes les régions et passez uniquement à Government ou China pour les déploiements cloud. Pour plus de détails sur les environnements, consultez les points de terminaison Microsoft Graph et Graph Explorer.
   • Compte - Représente le compte utilisé pour emprunter l'identité d'un utilisateur. Spécifiez le nom principal d’utilisateur (UPN) du compte ou de la boîte aux lettres partagée à utiliser dans la connexion. Ceci est nécessaire pour que la connexion soit établie.
6. Select Connect.
7. Authentifiez-vous à l'aide de votre adresse e-mail et de votre mot de passe 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 des délais d’attente ou des révocations. Pour plus d’informations, 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 réparées.

Assurez-vous de suivre les meilleures pratiques de Microsoft lors de la création de vos applications OAuth. Pour plus de détails 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.