Microsoft OneDrive- und SharePoint-Authentifizierung

Verbinden Sie UiPath mit Microsoft OneDrive und SharePoint mithilfe von Client-Zertifikat, OAuth 2.0 Client-Anmeldeinformationen oder anderen unterstützten Methoden in Automation Suite.

Voraussetzungen

Sie benötigen die folgenden Anmeldeinformationen:

• Nutzen Sie Ihre eigene OAuth 2.0-App: Anwendungs-Client-ID und geheimer Clientschlüssel, Scopes und Mandanten-ID

Umgebung

Wenn Sie zum ersten Mal auf den Authentifizierungsbildschirm zugreifen, können Sie eine Umgebung auswählen. Die verfügbaren Optionen sind:

• Office 365 (Standard)
• US-Regierung L4 – Domäne des öffentlichen Sektors
• US-Regierung L5 – Domäne des öffentlichen Sektors
• China

Weitere Informationen finden Sie unter Stammendpunkte des Microsoft Graph- und Graph Explorer-Diensts.

Zustimmung des Administrators

Viele Organisationen benötigen die Zustimmung eines Administrators, bevor eine Verbindung mit einer externen Anwendung erstellt wird. Der Workflow zur Administratorzustimmung erfordert, dass ein Administrator die App-Registrierung für bestimmte Benutzer oder Gruppen genehmigt, bevor eine Verbindung hergestellt wird. Weitere Informationen finden Sie unter Übersicht über den Workflow für die Administratorzustimmung und Benutzer- und Administratorzustimmung in Microsoft Entra ID in der Microsoft-Dokumentation.

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, wird jede Änderung an Microsoft SharePoint oder OneDrive mit dieser Verbindung im Namen dieses Benutzers vorgenommen.

Scopes

Der Connector fordert die folgenden Berechtigungen/Scopes an:

• Nutzen Sie Ihre eigene OAuth 2.0-App:
  • Minimale Scopes für das Erstellen einer Verbindung: openid, offline_access, User.Read.All, Files.Read.
  • Mindestliste der Scopes, die für OneDrive-Trigger erforderlich sind:
    • openid, offline_access, User.Read.All, Sites.Read.All – für Ereignisse auf SharePoint-Websites;
    • Group.Read.All – für Ereignisse in Gruppen und Kalendern;
    • Files.Read.All – für alle verbleibenden Ereignistypen.

Hinweis:

Wenn Sie sich mit Bring your own OAuth 2.0-App authentifizieren, profitieren Sie standardmäßig von den Scopes, die bei der App-Erstellung konfiguriert wurden. Wenn Sie die Standard-App-Berechtigungen verwenden möchten, können Sie einen common -Scope deklarieren. Das bedeutet, dass Sie nur die Berechtigungen verwenden, die für diese Anwendung in Azure konfiguriert wurden. Sie können auch zusätzliche Scopes bei der Verbindungserstellung mit dem Feld Scopes deklarieren. Sie werden dann bei der Anmeldung aufgefordert, die zusätzliche Zustimmung zu erteilen.

Fügen Sie die Microsoft OneDrive- und SharePoint-Verbindung hinzu

Um eine Verbindung mit Ihrer Microsoft OneDrive- und SharePoint-Instanz zu erstellen, müssen Sie die folgenden Schritte ausführen:

1. Wählen Sie Integration Service in der Automation Suite aus.

2. Wählen Sie in der Liste Connector die Option Microsoft OneDrive & SharePoint aus. Sie können auch die Suchleiste verwenden, um den Connector einzugrenzen.

3. Wählen Sie die Schaltfläche Verbindung mit Microsoft OneDrive & SharePoint herstellen aus.

4. Sie werden nun zur Verbindungsseite umgeleitet.

   Geben Sie die erforderlichen Anmeldeinformationen ein. Sie müssen eine Client-ID und einen geheimen Clientschlüssel, eine Mandanten-ID und die Scopes angeben, die Sie möglicherweise für die Interaktion mit verschiedenen Aktivitäten benötigen. Sehen Sie sich die Dokumentation der Aktivitäten an, um zu sehen, welche Scopes sie benötigen.

   Wenn Sie eine Anwendung mit mehreren Mandanten verwenden, behalten Sie den Standardwert für die Mandanten-ID (common) 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.

5. Ihre Verbindung wurde hinzugefügt.

Bringen Sie Ihre eigene OAuth 2.0-App mit

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 Rückruf-URL) für Ihre oAuth 2.0-Anwendung wird beim Erstellen einer Verbindung auf dem Authentifizierungsbildschirm angezeigt: https://{yourDomain}/provisioning\_/callback.
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. Informationen, welche Scopes für jede Aktivität im Microsoft 365-Paket erforderlich sind, finden Sie unter 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 deren Client-ID und den geheimen Clientschlüssel, um eine Verbindung mit den Microsoft-Connectors zu erstellen.

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 zum Ablauf von Token.

Wichtig:

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 bei der Erstellung Ihrer OAuth-Anwendungen die Best Practices von Microsoft befolgen. Weitere Informationen zum Erstellen einer OAuth 2.0-Anwendung finden Sie in der Dokumentation von Microsoft .

Hinweis:

Dieses Problem betrifft alle Microsoft Graph-basierten Connectors.