Microsoft Outlook 365-Authentifizierung

Überblick

Wenn Sie im Integration Service eine Verbindung zu einem unserer Microsoft Graph-basierten Connectors erstellen, können Sie zwischen den folgenden Authentifizierungsoptionen wählen:

• Client-Zertifikat-Authentifizierung – Stellt die Verbindung mithilfe eines Clientzertifikats anstelle eines geheimen Clientschlüssels her.
• OAuth 2.0: Autorisierungscode – Stellt mit Ihren Microsoft-Kontoanmeldeinformationen eine Verbindung mit der öffentlichen UiPath-Anwendung her.
• OAuth 2.0 Client-Anmeldeinformationen – Verbindung über ein Dienstkonto.
• Bring Your Own OAuth 2.0 App – Stellt eine Verbindung mit einer privaten Anwendung her, die Sie erstellen.

Hinweis:

Weitere Informationen zu den verschiedenen Authentifizierungstypen finden Sie unter So stellen Sie eine Verbindung mit Microsoft 365-Aktivitäten her .

Falls beim Anmeldevorgang 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.

Zustimmung des Administrators

Hinweis:

Dieser Abschnitt gilt nur für den OAuth 2.0-Autorisierungscode und die Optionen Bring your own OAuth 2.0 in der App .

Viele Organisationen benötigen die Zustimmung des Administrators, bevor Benutzer eine Verbindung mit externen Anwendungen herstellen können. Der Workflow zur Administratorzustimmung erfordert, dass ein Administrator die App-Registrierung für bestimmte Benutzer oder Gruppen genehmigt, bevor eine Verbindung hergestellt wird.

Wenn Ihre Organisation die Zustimmung des Administrators erzwingt, kann beim Erstellen der Verbindung ein Fehler auftreten, der besagt, dass die App eine Berechtigung für den Zugriff auf Ressourcen in Ihrer Organisation benötigt und dass nur ein Administrator diesen Zugriff gewähren kann. Dieser Fehler wird nicht durch ein Produktproblem verursacht, er erfordert eine Aktion Ihres Azure-Administrators.

Hintergrundinformationen finden Sie unter Übersicht über den Workflow für die Administratorzustimmung und Benutzer- und Administratorzustimmung in Microsoft Entra ID in der Microsoft-Dokumentation.

Administratorgenehmigung wird angefordert

Wenn der Fehler auftritt, senden Sie eine Genehmigungsanforderung direkt über den Microsoft-Anmeldebildschirm:

1. Geben Sie auf dem Bildschirm Genehmigung erforderlich eine geschäftliche Rechtfertigung in das Feld Grund für die Zugriffsanforderung ein.
2. Wählen Sie Genehmigung anfordern aus.

Ihr Administrator erhält die Anforderung per E-Mail und kann sie im Microsoft Entra Admin Center überprüfen.

Genehmigen der Anforderung (Administrator)

Voraussetzungen

• Sie verfügen über die Rolle Global Administrator, Application Administrator oder Cloud Application Administrator in Microsoft Entra ID.

So genehmigen Sie eine ausstehende Administratorzustimmungsanforderung:

1. Melden Sie sich beim Microsoft Entra Admin Center an .
2. Navigieren Sie zu Entra ID, dann zu Enterprise Apps.
3. Wählen Sie unter Aktivität in der linken Navigationsleiste die Option Administratorzustimmungsanforderungen.
4. Wählen Sie die Registerkarte Meine ausstehende Anforderung und dann die ausstehende Anforderung aus der Liste aus.
5. Überprüfen Sie die Berechtigungen, die von der Anwendung angefordert werden.
6. Wählen Sie Berechtigungen und Zustimmung überprüfen, um die angeforderten Berechtigungen anzuzeigen, und wählen Sie dann Akzeptieren aus, um die Zustimmung zu erteilen.
7. Um abzulehnen, wählen Sie Verweigern aus und geben Sie eine Rechtfertigung an.

Der Benutzer, der die Anforderung eingereicht hat, wird über die Entscheidung informiert.

Ausführliche Informationen zum Genehmigungsprozess finden Sie unter Überprüfen Sie die Administratorzustimmungsanforderungen in der Microsoft-Dokumentation.

Hinweis:

Der Integration Service gibt sich als der Benutzer aus, der die Verbindung erstellt. Die Anmeldeinformationen des Benutzers bieten Zugriff auf alle gleichen Ressourcen, die er in der jeweiligen Anwendung hat. Wenn Sie die Verbindung freigeben, wird jede mit dieser Verbindung vorgenommene Änderung im Namen dieses Benutzers vorgenommen.

Client-Zertifikats-Authentifizierung

Scopes

Der Connector erfordert die folgenden Mindest-Scopes, um eine Verbindung zu erstellen: Mail.Read und User.Read.All.

Der Connector erfordert die folgenden Scopes, damit alle Aktivitäten funktionieren: 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 und offline_access.

Informationen zum Hinzufügen detaillierterer Berechtigungen finden Sie in der Dokumentation zu den Aktivitäten.

Hinzufügen der Microsoft Outlook 365 Verbindung

Um eine Verbindung mit Ihrer Microsoft Outlook 365 Instanz zu erstellen, führen Sie die folgenden Schritte aus:

1. Wählen Sie Orchestrator im Produktstartprogramm aus.

2. Wählen Sie einen Ordner aus und navigieren Sie dann zur Registerkarte Verbindungen .

3. Wählen Sie Verbindung hinzufügen aus.

4. Um die Seite zur Erstellung der Verbindung zu öffnen, wählen Sie den Konnektor in der Liste aus. Sie können die Suchleiste verwenden, um den Connector zu finden.

5. Wählen Sie den Authentifizierungstyp der Clientzertifikat-Authentifizierung aus.

6. Konfigurieren Sie die folgenden Felder:

   • Client-ID – Sie finden die ID im Abschnitt Übersicht in Ihrer Microsoft Azure-Anwendungsregistrierung.

   • Kennwort für das Zertifikat – Das Kennwort, das Sie während der Zertifikatserstellung festgelegt haben.

   • OAuth base64-Clientzertifikat – Das Clientzertifikat wird in einer PFX-Datei generiert Dateiformat, das Sie in ein Base64-codiertes Format konvertieren und in diesem Feld angeben müssen.

   • Mandanten-ID – Sie finden die Microsoft Azure-Mandanten-ID für eine App im Abschnitt Übersicht Ihrer Microsoft Azure-Anwendungsregistrierung.

   • Umgebung – Wählen Sie optional eine Umgebung aus der Dropdownliste aus:

     • Office 365 (Standard)
     • US-Regierung L4 – Domäne des öffentlichen Sektors
     • US-Regierung L5 – Domäne des öffentlichen Sektors
     • China Wählen Sie Office 365 (Standard) für alle Regionen aus und wechseln Sie nur für Cloud-Bereitstellungen zu Governance oder China.
     Hinweis:

     Weitere Informationen zu Umgebungen finden Sie unter Microsoft Graph- und Graph Explorer-Dienststammendpunkte.

   • Konto – Geben Sie den Benutzerprinzipalnamen (UPN) des Kontos oder gemeinsam genutzten Postfachs ein, das das System in der Verbindung verwenden soll. Dies ist für den Aufbau der Verbindung erforderlich.

7. Select Connect.

   Für jedes Feld des geheimen Typs können Sie das Menü neben dem Feld auswählen und Anmeldeinformations-Asset verwenden auswählen, um auf ein Orchestrator-Anmeldeinformations-Asset zu verweisen, das mit einem externen Tresor verknüpft ist, anstatt den Wert direkt einzugeben. Weitere Informationen finden Sie unter Verwenden von Anmeldeinformationsassets für Verbindungen.

8. Authentifizieren Sie sich mit Ihrer Microsoft-E-Mail-Adresse und Ihrem Kennwort.

OAuth 2.0: Autorisierungscode

Scopes

Obligatorische Scopes: openid, offline_access, User.Read, Mail.Read, email.

Der Connector erfordert die folgenden Mindest-Scopes, um eine Verbindung zu erstellen: openid, offline_access, User.Read, Mail.Read und email.

Der Connector erfordert den folgenden vollständigen Satz von Scopes, damit alle Aktivitäten funktionieren: 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 und offline_access.

Informationen zum Hinzufügen detaillierterer Berechtigungen finden Sie in der Dokumentation zu den Aktivitäten.

Hinzufügen der Microsoft Outlook 365 Verbindung

Um eine Verbindung mit Ihrer Microsoft Outlook 365 Instanz zu erstellen, führen Sie die folgenden Schritte aus:

1. Wählen Sie Orchestrator im Produktstartprogramm aus.
2. Wählen Sie einen Ordner aus und navigieren Sie dann zur Registerkarte Verbindungen .
3. Wählen Sie Verbindung hinzufügen aus.
4. Um die Seite zur Erstellung der Verbindung zu öffnen, wählen Sie den Konnektor in der Liste aus. Sie können die Suchleiste verwenden, um den Connector zu finden.
5. Wählen Sie den Authentifizierungstyp OAuth 2.0: Autorisierungscode aus.
6. Konfigurieren Sie Folgendes:
   • Scope – Fügen Sie Berechtigungen für Ihren Connector hinzu oder entfernen Sie sie.
   • Umgebung – Wählen Sie optional eine Umgebung aus der Dropdownliste aus:
     • Office 365 (Standard)
     • US-Regierung L4 – Domäne des öffentlichen Sektors
     • US-Regierung L5 – Domäne des öffentlichen Sektors
     • China Wählen Sie Office 365 (Standard) für alle Regionen aus und wechseln Sie nur für Cloud-Bereitstellungen zu Governance oder China.
     Hinweis:

     Weitere Informationen zu Umgebungen finden Sie unter Microsoft Graph- und Graph Explorer-Dienststammendpunkte.

   • Freigegebenes Postfach – Geben Sie optional Ihr freigegebenes Postfach ein.
   Hinweis:

   Alle Outlook-Aktivitäten erben das freigegebene Postfach, sobald Sie eine Verbindung herstellen.

7. Select Connect.
8. Authentifizieren Sie sich mit Ihrer Microsoft-E-Mail-Adresse und Ihrem Kennwort.

Aktualisierungstokens für OAuth-Anwendungen

Aktualisierungstokens für OAuth-Anwendungen können von Microsoft jederzeit für ungültig erklärt oder widerrufen werden. Dafür kann es verschiedene Gründe geben, z. B. Timeouts und Widerrufe. Weitere Informationen finden Sie in der offiziellen Dokumentation von Microsoft .

Hinweis:

Die Ungültigkeit von Token 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 beim Erstellen 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.

OAuth 2.0: Client-Anmeldeinformationen

Scopes

Der Connector erfordert die folgenden Mindest-Scopes, um eine Verbindung zu erstellen: Mail.Read und User.Read.All.

Der Connector erfordert den folgenden vollständigen Satz von Scopes, damit alle Aktivitäten funktionieren: 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 und offline_access.

Informationen zum Hinzufügen detaillierterer Berechtigungen finden Sie in der Dokumentation zu den Aktivitäten.

Hinzufügen der Microsoft Outlook 365 Verbindung

Um eine Verbindung mit Ihrer Microsoft Outlook 365 Instanz zu erstellen, führen Sie die folgenden Schritte aus:

1. Wählen Sie Orchestrator im Produktstartprogramm aus.

2. Wählen Sie einen Ordner aus und navigieren Sie dann zur Registerkarte Verbindungen .

3. Wählen Sie Verbindung hinzufügen aus.

4. Um die Seite zur Erstellung der Verbindung zu öffnen, wählen Sie den Konnektor in der Liste aus. Sie können die Suchleiste verwenden, um den Connector zu finden.

5. Wählen Sie den Authentifizierungstyp OAuth 2.0 Client-Anmeldeinformationen aus.

6. Konfigurieren Sie Folgendes:

   • Client-ID – Sie finden die ID im Abschnitt Übersicht in Ihrer Microsoft Azure-Anwendungsregistrierung.

   • Geheimer Clientschlüssel – Der geheime Clientschlüssel aus dem Abschnitt Zertifikate und Geheimnisse Ihrer Microsoft Azure-Anwendung.

   • Mandanten-ID – Die Microsoft Azure-Mandanten-ID für eine App aus dem Abschnitt Übersicht.

   • Umgebung – Wählen Sie optional eine Umgebung aus der Dropdownliste aus:

     • Office 365 (Standard)
     • US-Regierung L4 – Domäne des öffentlichen Sektors
     • US-Regierung L5 – Domäne des öffentlichen Sektors
     • China Wählen Sie Office 365 (Standard) für alle Regionen aus und wechseln Sie nur für Cloud-Bereitstellungen zu Governance oder China.
     Hinweis:

     Weitere Informationen zu Umgebungen finden Sie unter Microsoft Graph- und Graph Explorer-Dienststammendpunkte.

   • Konto – Geben Sie das Konto an, das verwendet wird, um die Identität eines Benutzers anzunehmen. Geben Sie den Benutzerprinzipalnamen (UPN) des Kontos oder freigegebenen Postfachs an, das das System in der Verbindung verwenden soll. Dies ist für den Aufbau der Verbindung erforderlich.

7. Select Connect.

   Für jedes Feld des geheimen Typs können Sie das Menü neben dem Feld auswählen und Anmeldeinformations-Asset verwenden auswählen, um auf ein Orchestrator-Anmeldeinformations-Asset zu verweisen, das mit einem externen Tresor verknüpft ist, anstatt den Wert direkt einzugeben. Weitere Informationen finden Sie unter Verwenden von Anmeldeinformationsassets für Verbindungen.

8. Authentifizieren Sie sich mit Ihrer Microsoft-E-Mail-Adresse und Ihrem Kennwort.

Bringen Sie Ihre eigene OAuth 2.0-App mit

Überblick

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 Funktionalität und erfordert Administratorrechte in der Zielanwendung. Wenden Sie sich an Ihren IT-Administrator, um Ihre Anwendung erfolgreich einzurichten.

Anforderungen

Beim Erstellen Ihrer eigenen Anwendung zur Verwendung mit Integration Service müssen Sie die folgenden Anforderungen berücksichtigen:

1. Sie müssen die Anwendung als Anwendung mit mehreren Mandanten oder als Einzelmandanten konfigurieren.
2. Sie müssen eine Webanwendung konfigurieren.
3. Sie müssen einen Webumleitungs -URI konfigurieren. Der Umleitungs-URI (oder die Rückruf-URL) für Ihre oAuth 2.0-Anwendung wird auf dem Authentifizierungsbildschirm beim Erstellen einer Verbindung bereitgestellt: https://{baseURL}/provisioning_/callback (z. B. https://cloud.uipath.com/provisioning_/callback für die Automation Cloud).
4. Sie müssen delegierte Berechtigungen einrichten. Weitere Informationen finden Sie unter Berechtigungen in der offiziellen Microsoft-Dokumentation.
5. Generieren Sie einen geheimen Clientschlüssel für Ihre Anwendung.

Wichtig:

Der Vorteil bei der Verwendung Ihrer privaten OAuth-Anwendung besteht darin, dass Sie Berechtigungen abhängig von Ihren tatsächlichen Anforderungen anpassen können. Um zu erfahren, welche Scopes für jede Aktivität im Microsoft 365-Paket erforderlich sind, lesen Sie Arbeiten mit Scopes und sehen Sie sich die Dokumentation zu den Aktivitäten an. Der Connector verwendet die Microsoft Graph-API. Weitere Informationen zu allen Berechtigungen finden Sie auf der Referenzseite für Microsoft Graph-Berechtigungen .

Nachdem Sie Ihre Anwendung erstellt haben, verwenden Sie die Client-ID und den Geheimen Clientschlüssel, um eine Verbindung mit den Microsoft-Connectors zu erstellen.

Scopes

• Obligatorische Scopes: openid, offline_access, User.Read, Mail.Read, email.
• Der Connector erfordert die folgenden Mindest-Scopes, um eine Verbindung zu erstellen: openid, offline_access, User.Read, Mail.Read und email.
• Outlook-Trigger erfordern die folgenden Mindest-Scopes:
  • Für Trigger für freigegebene Postfächer: openid, offline_access, Mail.Read, Mail.Read.Shared.
  • Für Ereignisse in Kalendern: Calendars.Read.
  • Für Ereignisse in freigegebenen Kalendern: Calendars.Read.Shared.

Der Connector erfordert den folgenden vollständigen Satz von Scopes, damit alle Aktivitäten funktionieren: 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 und offline_access.

Informationen zum Hinzufügen detaillierterer Berechtigungen finden Sie in der Dokumentation zu den Aktivitäten.

Hinzufügen der Microsoft Outlook 365 Verbindung

Um eine Verbindung mit Ihrer Microsoft Outlook 365 Instanz zu erstellen, führen Sie die folgenden Schritte aus:

1. Wählen Sie Orchestrator im Produktstartprogramm aus.
2. Wählen Sie einen Ordner aus und navigieren Sie dann zur Registerkarte Verbindungen .
3. Wählen Sie Verbindung hinzufügen aus.
4. Um die Seite zur Erstellung der Verbindung zu öffnen, wählen Sie den Konnektor in der Liste aus. Sie können die Suchleiste verwenden, um den Connector zu finden.
5. Wählen Sie den Authentifizierungstyp Mit Ihrer eigenen OAuth 2.0-App aus.
6. Konfigurieren Sie Folgendes:
   • Client-ID – Sie finden die ID im Abschnitt Übersicht in Ihrer Microsoft Azure-Anwendungsregistrierung.
   • Geheimer Clientschlüssel – Der geheime Clientschlüssel aus dem Abschnitt Zertifikate und Geheimnisse Ihrer Microsoft Azure-Anwendung.
   • Mandanten-ID – Die Microsoft Azure-Mandanten-ID für eine App aus dem Abschnitt Übersicht.
     Hinweis:

     • Wenn Sie eine Anwendung mit mehreren Mandanten verwenden, behalten Sie den Standardwert allgemein bei.
     • Wenn Sie eine Anwendung mit einem einzelnen Mandanten verwenden, rufen Sie die Mandanten-ID von Azure ab. Weitere Informationen finden Sie unter So finden Sie Ihre Microsoft Entra-Mandanten-ID.
   • Scope – Fügen Sie Berechtigungen für Ihren Connector hinzu oder entfernen Sie sie.
   • Umgebung – Wählen Sie optional eine Umgebung aus der Dropdownliste aus:
     • Office 365 (Standard)
     • US-Regierung L4 – Domäne des öffentlichen Sektors
     • US-Regierung L5 – Domäne des öffentlichen Sektors
     • China Wählen Sie Office 365 (Standard) für alle Regionen aus und wechseln Sie nur für Cloud-Bereitstellungen zu Governance oder China.
     Hinweis:

     Weitere Informationen zu Umgebungen finden Sie unter Microsoft Graph- und Graph Explorer-Dienststammendpunkte.

   • Freigegebenes Postfach – Berechtigungen für Ihren Connector hinzufügen oder entfernen.

Aktualisierungstokens für OAuth-Anwendungen

Aktualisierungstokens für OAuth-Anwendungen können von Microsoft jederzeit für ungültig erklärt oder widerrufen werden. Dafür kann es verschiedene Gründe geben, z. B. Timeouts und Widerrufe. Weitere Informationen finden Sie in der offiziellen Dokumentation von Microsoft .

Hinweis:

Die Ungültigkeit von Token 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 beim Erstellen 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.