Microsoft OneDrive- und SharePoint-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 Certificate Authentication – connects using a client certificate instead of a client secret.
• OAuth 2.0: Autorisierungscode – stellt eine Verbindung mit der öffentlichen UiPath-Anwendung her.
• OAuth 2.0 Client credentials - connects using a service account.
• 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 im Handbuch zum Herstellen einer Verbindung mit Microsoft 365-Aktivitäten .

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 erfordern die Zustimmung eines Administrators, bevor Sie eine Verbindung mit einer externen Anwendung erstellen. 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 dieselben Ressourcen, die er in der jeweiligen Anwendung hat. Wenn Sie die Verbindung freigeben, erfolgt jede Änderung an Microsoft SharePoint oder OneDrive mit dieser Verbindung im Namen dieses Benutzers.

Client-Zertifikats-Authentifizierung

Scopes

The connector requires the following minimum scopes to create a connection: Files.Read.

The connector requires the following full set of scopes for all activities to function: offline_access, Files.Read, Files.Read.All, Files.ReadWrite, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, profile, openid, email, User.Read.All, User.Read.

To add more granular permissions, refer to the activities documentation.

Hinzufügen der Microsoft OneDrive- und SharePoint-Verbindung

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

1. In Automation Cloud, select Integration Service from the rail menu.
2. From the Connectors list, select Microsoft OneDrive and SharePoint, or use the search bar to find the connector.
3. Select Connect to Microsoft OneDrive and SharePoint, which redirects you to the connection page.
4. Select the Client Certificate Authentication authentication type.
5. Konfigurieren Sie die folgenden Felder:

   • Client ID - You can find the ID in the Overview section of your Microsoft Azure application registration.

   • Password for the certificate - The password you set during the certificate creation.

   • OAuth base64 client certificate - The client certificate is generated in a .pfx file format, which you must convert to Base64-encoded format and provide it in this field.

   • Tenant ID - You can find the Microsoft Azure tenant ID for an app in the Overview section of your Microsoft Azure application registration.

   • Environment - Optionally, select an environment from the dropdown list:

     • Office 365 (Standard)
     • US Government L4 - Public Sector domain
     • US Government L5 - Public Sector domain
     • China Select Office 365 (default) for all regions, and only switch to Government or China for cloud deployments.
     Hinweis:

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

   • Account - Enter the user principal name (UPN) of the account or shared mailbox that the system should use in the connection. This is required for the connection to be established.

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

OAuth 2.0: Autorisierungscode

Scopes

The connector requires the following minimum scopes to create a connection: openid, offline_access, email, and Files.Read.

The connector requires the following full set of scopes for all activities to function: offline_access, Files.Read, Files.Read.All, Files.ReadWrite, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, profile, openid, email, User.Read.All, User.Read.

To add more granular permissions, refer to the activities documentation.

Hinzufügen der Microsoft OneDrive- und SharePoint-Verbindung

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

1. In Automation Cloud, select Integration Service from the rail menu.
2. From the Connectors list, select Microsoft OneDrive and SharePoint. You can also use the search bar to narrow down the connector.
3. Select the Connect to Microsoft OneDrive and SharePoint button, which redirects you to the connection page.
4. Wählen Sie den Authentifizierungstyp OAuth 2.0: Autorisierungscode aus.
5. Konfigurieren Sie Folgendes:
   • Scope - Optionally, add or remove permissions for your connector.
   • Environment - Optionally, select an environment from the dropdown list:
     • Office 365 (Standard)
     • US Government L4 - Public Sector domain
     • US Government L5 - Public Sector domain
     • China Select Office 365 (default) for all regions, and only switch to Government or China for cloud deployments.
     Hinweis:

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

6. Select Connect.
7. 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

The connector requires the following minimum scopes to create a connection: Files.Read.

The connector requires the following full set of scopes for all activities to function: offline_access, Files.Read, Files.Read.All, Files.ReadWrite, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, profile, openid, email, User.Read.All, User.Read.

To add more granular permissions, refer to the activities documentation.

Hinzufügen der Microsoft OneDrive- und SharePoint-Verbindung

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

1. In Automation Cloud, select Integration Service from the rail menu.
2. From the Connectors list, select Microsoft OneDrive and SharePoint. You can also use the search bar to narrow down the connector.
3. Select the Connect to Microsoft OneDrive and SharePoint button, which redirects you to the connection page.
4. Wählen Sie den Authentifizierungstyp OAuth 2.0 Client-Anmeldeinformationen aus.
5. Konfigurieren Sie Folgendes:

   • Client ID - You can find the ID in the Overview section of your Microsoft Azure application registration.

   • Client Secret - The client secret from the Certificates & secrets section of your Microsoft Azure application.

   • Tenant ID - The Microsoft Azure tenant ID for an app from the Overview section.

   • Environment - Optionally, select an environment from the dropdown list:

     • Office 365 (Standard)
     • US Government L4 - Public Sector domain
     • US Government L5 - Public Sector domain
     • China Select Office 365 (default) for all regions, and only switch to Government or China for cloud deployments.
     Hinweis:

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

   • Account - Provide the account used to impersonate a user.

6. Select Connect.

Bringen Sie Ihre eigene OAuth 2.0-App mit

Überblick

Informationen zum Erstellen einer Anwendung finden Sie in der offiziellen Microsoft-Dokumentation: 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

Wenn Sie Ihre eigene Anwendung zur Verwendung mit Integration Service erstellen, stellen Sie sicher, dass Sie die folgenden Anforderungen erfüllen:

1. Konfigurieren Sie die Anwendung als Anwendung mit mehreren Mandanten oder als Einzelmandanten .
2. Konfigurieren Sie eine Webanwendung .
3. Konfigurieren Sie einen Webumleitungs -URI. Der Umleitungs-URI (oder 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.
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 deren Client-ID und den geheimen Clientschlüssel, um eine Verbindung mit den Microsoft-Connectors zu erstellen.

Scopes

• The connector requires the following minimum scopes to create a connection: openid, offline_access, email, and Files.Read.
• OneDrive triggers require the following minimum scopes:
  • For events on SharePoint sites: openid, offline_access, and User.Read.All or User.Read and Sites.Read.All.
  • For events on groups and calendars: Group.Read.All
  • For all the remaining event types: Files.Read.All

The connector requires the following full set of scopes for all activities to function: offline_access, Files.Read, Files.Read.All, Files.ReadWrite, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, profile, openid, email, User.Read.All, User.Read.

To add more granular permissions, refer to the activities documentation.

Hinzufügen der Microsoft OneDrive- und SharePoint-Verbindung

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

1. In Automation Cloud, select Integration Service from the rail menu.
2. From the Connectors list, select Microsoft OneDrive and SharePoint. You can also use the search bar to narrow down the connector.
3. Select the Connect to Microsoft OneDrive and SharePoint button, which redirects you to the connection page.
4. Wählen Sie den Authentifizierungstyp Mit Ihrer eigenen OAuth 2.0-App aus.
5. Konfigurieren Sie Folgendes:
   • Client ID - You can find the ID in the Overview section of your Microsoft Azure application registration.
   • Client Secret - The client secret from the Certificates & secrets section of your Microsoft Azure application.
   • Scope - Optionally, add or remove permissions for your connector.
   • Tenant ID - The Microsoft Azure tenant ID for an app from the Overview section.
     Hinweis:

     • If you use a multi-tenant application, keep the default value 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.
   • Environment - Optionally, select an environment from the dropdown list:
     • Office 365 (Standard)
     • US Government L4 - Public Sector domain
     • US Government L5 - Public Sector domain
     • China Select Office 365 (default) for all regions, and only switch to Government or China for cloud deployments.
     Hinweis:

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

6. Select Connect.

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.