Voraussetzungen
link
Je nach ausgewähltem Authentifizierungstyp benötigen Sie eine der folgenden Optionen:
- Ihre E-Mail-Adresse und Ihr Kennwort für das Microsoft-Konto.
- Die Client-ID und der geheime Clientschlüssel Ihrer Anwendung, Scopes und Mandanten-ID.
Darüber hinaus müssen Sie Apps von Drittanbietern Berechtigungen erteilen, um auf Ihre Informationen zugreifen zu können. Wenden Sie sich bei Fehlern an Ihren Microsoft Outlook365-Administrator.
Hinweis:
Der Integration Service gibt die Identität des Benutzers an, der die Verbindung erstellt. Die Anmeldeinformationen des Benutzers bieten Zugriff auf alle Ressourcen, die er in der jeweiligen Anwendung hat. Wenn Sie die Verbindung freigeben, erfolgt jede Änderung an Microsoft Outlook mit dieser Verbindung im Namen dieses Benutzers.
Umgebung
Wenn Sie zum ersten Mal auf den Authentifizierungsbildschirm zugreifen, können Sie eine Umgebung auswählen. Die verfügbaren Optionen sind:
- Office365 (Standard)
- US-Regierung L4 – Domäne des öffentlichen Sektors
- US-Regierung L5 – Domäne des öffentlichen Sektors
- China
Gewähren Sie Apps von Drittanbietern Berechtigungen
link
Bevor Sie die Verbindung herstellen, stellen Sie sicher, dass Berechtigungen für integrierte Apps erteilt werden, wie in der offiziellen Dokumentation von Microsoft erläutert: Konfigurieren der Benutzerzustimmungseinstellungen.
Scopes
link
Die folgenden Scopes werden vom Connector angefordert: 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.
Dies ist die vollständige Liste der erforderlichen Scopes.
Hinweis: Bitte wenden Sie sich an Ihr IT-Team, um diese Berechtigungen für Ihren Benutzer und Ihre Anwendung zuzulassen.
Fügen Sie die Microsoft Outlook 365-Verbindung hinzu
link
Um eine Verbindung mit Ihrer Microsoft Outlook 365-Instanz herzustellen, müssen Sie die folgenden Schritte ausführen:
- Wählen Sie Integration Service from Automation Cloud aus.
-
Wählen Sie in der Liste Connectors die Option Microsoft Outlook365 aus. Sie können auch die Suchleiste verwenden, um den Connector zu finden.
- Wählen Sie die Schaltfläche Verbindung mit Microsoft Outlook 365 herstellen aus.
- Sie werden nun zur Verbindungsseite weitergeleitet. Sie können zwischen zwei Authentifizierungstypen wählen: OAuth 2.0-Autorisierungscode oder Mitbringen Ihrer eigenen OAuth 2.0-App.
- Wenn Sie den OAuth 2.0-Autorisierungscode auswählen, klicken Sie auf Verbinden und authentifizieren Sie sich dann mit Ihrer Microsoft-E-Mail-Adresse und Ihrem Kennwort.
- Wenn Sie Ihre eigene OAuth 2.0-App mitbringen auswählen, müssen Sie die Client-ID und den geheimen Clientschlüssel, die Mandanten-ID und die Scopes angeben, die Sie möglicherweise für die Interaktion mit verschiedenen Aktivitäten benötigen. Lesen Sie die Dokumentation der Aktivitäten, um zu sehen, welche Scopes sie erfordern.
Hinweis: Wenn Sie eine Anwendung mit mehreren Mandanten verwenden, behalten Sie den Standardwert für die Mandanten-ID (
common) bei. Wenn Sie eine Einzelmandantenanwendung verwenden, rufen Sie die Mandanten-ID von Azure ab. Weitere Informationen finden Sie unter So finden Sie Ihre Microsoft Entra-Mandanten-ID.
- Ihre Verbindung wurde hinzugefügt.
Falls während des Anmeldevorgangs Fehler auftreten, wird empfohlen, sich an Ihren Microsoft Outlook 365-Administrator zu wenden.
Weitere Informationen finden Sie in der Dokumentation zum Office 365 Outlook-Connector.
Bringen Sie Ihre eigene OAuth 2.0-App mit
link
Beim Erstellen einer Verbindung mit einem unserer Microsoft Graph-basierten Connectors können Sie im Integration Service zwischen zwei Authentifizierungsoptionen wählen:
- OAuth 2.0-Autorisierungscode – der eine Verbindung zur öffentlichen UiPath-Anwendung herstellt.
- Bringen Sie Ihre eigene OAuth 2.0-App mit, die sich mit einer privaten Anwendung verbindet, die Sie erstellen.
Um zu erfahren, wie Sie eine Anwendung erstellen, wechseln Sie zur offiziellen Dokumentation von Microsoft und führen Sie die beschriebenen Schritte aus: Registrieren einer Anwendung bei der Microsoft Identity-Plattform.
Hinweis: Dies ist eine erweiterte Funktion und erfordert Administratorrechte in der Zielanwendung. Arbeiten Sie mit Ihrem IT-Administrator zusammen, um Ihre Anwendung erfolgreich einzurichten.
Anforderungen
Beim Erstellen Ihrer eigenen Anwendung zur Verwendung mit Integration Service müssen Sie die folgenden Anforderungen berücksichtigen:
- Sie müssen die Anwendung als Mehrmandanten- oder Einzelmandantenanwendung konfigurieren.
- Sie müssen einen Webumleitungs- URI konfigurieren. Der Umleitungs-URI (oder die Rückruf-URL) für Ihre OAuth 2.0-Anwendung wird beim Erstellen einer Verbindung auf dem Authentifizierungsbildschirm bereitgestellt: https://cloud.uipath.com/provisioning_/callback.
- Sie müssen delegierte Berechtigungen einrichten. Weitere Informationen finden Sie unter Berechtigungen in der offiziellen Microsoft-Dokumentation.
Hinweis: Der Vorteil der Verwendung Ihrer privaten OAuth-Anwendung besteht darin, dass Sie die Berechtigungen in Abhängigkeit von Ihren tatsächlichen Anforderungen anpassen können. Um zu erfahren, welche Scopes für jede Aktivität im Microsoft365-Paket erforderlich sind, wechseln Sie zur Aktivitätsdokumentation .
Der Connector verwendet die Microsoft Graph-API. Weitere Informationen zu allen Berechtigungen finden Sie auf der Referenzseite zu den Microsoft Graph -Berechtigungen.
Nachdem Sie Ihre Anwendung erstellt haben, verwenden Sie deren Client-ID und den geheimen Clientschlüssel, um eine Verbindung mit den Microsoft-Connectors zu erstellen.
Aktualisierungstokens für OAuth-Anwendungen
link
Aktualisierungstokens für OAuth-Anwendungen können von Microsoft jederzeit ungültig gemacht oder widerrufen werden. Dies kann verschiedene Gründe haben, z.B. Timeouts und Sperren. Weitere Informationen finden Sie in der offiziellen Dokumentation von Microsoft.
Warnung: Tokenannullierung führt zu fehlgeschlagenen Verbindungen, und Automatisierungen können nicht ausgeführt werden, ohne Verbindungen zu reparieren.
Stellen Sie sicher, dass Sie die Best Practices von Microsoft bei der Erstellung Ihrer OAuth-Anwendungen befolgen. Ausführliche Informationen zum Erstellen einer Microsoft OAuth-App finden Sie in der Microsoft- Dokumentation.
Dieses Problem betrifft nicht nur den OneDrive- und SharePoint-Connector, sondern alle Microsoft Graph-basierten Connectors, wie Outlook oder Teams.
