Microsoft Office 365 Scope

UiPath.MicrosoftOffice365.Activities.Office365ApplicationScope

Beschreibung

Verwendet die Microsoft Identity-Plattform, um eine authentifizierte Verbindung zwischen UiPath und Ihrer Microsoft 365-Anwendung herzustellen. Diese authentifizierte Verbindung ermöglicht einem Roboter, die Microsoft Graph-API aufzurufen, um Ressourcen in Ihrem Namen zu lesen und zu schreiben.

Wichtig:

Ab Version 2.5.5 können Sie die neueren Microsoft 365-Aktivitäten innerhalb der Scope-Aktivität verwenden. Informationen zur Verwendung der Integration Service-Aktivitäten mit Microsoft 365 Scope finden Sie unter Verwendung von Microsoft 365-Aktivitäten ohne Integration Service-Verbindungen.

Projektkompatibilität

Windows – Legacy | Windows

Konfiguration

Tipp:

Auf dieser Seite werden die Authentifizierungsparameter erläutert, die in der Microsoft 365-Aktivität „Scope“ verfügbar sind. Weitere Informationen zu den einzelnen Authentifizierungsoptionen finden Sie im Handbuch zum Herstellen einer Verbindung mit Microsoft 365-Aktivitäten .

Um mit der Konfiguration dieser Aktivität zu beginnen, müssen Sie zuerst eine Verbindungsmethode auswählen. Je nach ausgewählter Methode werden dann unterschiedliche Felder im Eigenschaftenbereich angezeigt.

• Verbindungsmethode – Wählen Sie die Verbindungsmethode aus, die Sie verwenden möchten. Die im Dropdownmenü verfügbaren Optionen sind:
  • Eigenschaftenbereich – Konfigurieren Sie die Verbindungsdetails im Eigenschaftenbereich.
  • Asset – Verwenden Sie Orchestrator-Text- oder Anmeldeinformationsassets oder beides. Wir empfehlen Ihnen, diese Option zu verwenden.

Asset-Verbindungsmethode

Hinweis:

Wenn Sie diese Option auswählen, werden die meisten Authentifizierungsfelder ausgeblendet, die normalerweise im Eigenschaftenbereich angezeigt werden, da die Authentifizierungsinformationen innerhalb des Assets gespeichert werden.

• Verbindungs-Assets – Durchsuchen Sie Orchestrator-Ordner, um ein Asset auszuwählen. Dieses Feld unterstützt IResource -Variablen. Wählen Sie die Schaltfläche Assets verwalten aus, um den Orchestrator zu öffnen. Die Liste der verfügbaren Assets hängt vom Orchestrator ab, mit dem Studio und Ihr Roboter verbunden sind. Sie können das Asset zur Entwurfszeit verwenden. Darüber hinaus kann das Asset nur vom Typ Text sein.

  • Verwenden Sie das Plus-Schaltflächenmenü, um Assets neu laden auszuwählen, wenn Sie Ihre Assets im Orchestrator aktualisiert haben. Beachten Sie Folgendes: Wenn Sie ein neues Asset im Orchestrator hinzufügen, während Sie Studio Desktop verwenden, ist dieses nicht sofort in der Scope-Aktivität verfügbar.

• Überprüfen Sie das Asset-Format unter Verwendung von Microsoft 365-Aktivitäten ohne Integration Service-Verbindungen.

Abhängig vom im Asset konfigurierten Authentifizierungstyp müssen Sie auch die folgenden Felder konfigurieren, die im Eigenschaftenbereich verfügbar sind:

Authentication

• E-Mail-Adresse des Benutzers, dessen Identität angenommen wird – Die E-Mail-Adresse des Benutzers, dessen Identität angenommen wird. Wird für die Authentifizierungsmethoden Anwendungs-ID und Geheimschlüssel sowie Anwendungs-ID und Zertifikat verwendet.

Benutzername und Kennwort (Unattended)

• Benutzername – Der Benutzername Ihres Microsoft 365-Kontos. Wird für die Authentifizierungsmethode Benutzername und Kennwort verwendet.
• Kennwort – Das Kennwort Ihres Microsoft 365-Kontos.

Allgemein

• TimeoutMS – Gibt die Wartezeit (in Millisekunden) für den Abschluss der interaktiven Authentifizierung (Zustimmungsdialogfeld) an, bevor ein Fehler ausgegeben wird. Dieses Feld unterstützt nur Integer und Int32 -Variablen. Der Standardwert beträgt 30.000 ms (30 Sekunden).

Laufzeit

• Assets der Runtime-Verbindung – Durchsuchen, um ein Asset auszuwählen. In diesem Feld können Sie ein anderes Asset für die Laufzeit auswählen. Verwenden Sie das Plus-Schaltflächenmenü, um Relativer Pfad auszuwählen und geben Sie den vollständigen Pfad des Orchestrator-Assets mit Verbindungsdetails ein. Wir empfehlen Ihnen, ein Anmeldeinformations-Asset in diesem Feld zu verwenden, aber Sie können auch ein Text-Asset verwenden. Der JSON-Wert muss im Kennwortfeld für Anmeldeinformationsassets festgelegt werden. Dieser Wert ist optional; wenn er leer gelassen wird, werden die Entwurfszeitwerte zur Laufzeit verwendet.

Verbindungsmethode für den Eigenschaftenbereich

Hinweis:

Wenn Sie diese Option auswählen, müssen Sie die im Eigenschaftenbereich verfügbaren Authentifizierungsfelder konfigurieren.

Konfigurieren Sie zunächst die folgenden Felder:

• Verbindungen – Wählen Sie ein Konto aus der Liste aus. Sie können Verbindungen hinzufügen, löschen und auswählen, welche verwendet werden sollen.
• AuthentifizierungsScopes
  • Sehen Sie sich den Abschnitt Verwenden des Authentifizierungs-Scopes-Assistenten weiter unten an.

Verwenden des Assistenten für Authentifizierungs-Scopes

Hinweis:

Dieser Assistent ersetzt den Parameter Services , der in früheren Versionen dieses Pakets verfügbar war. Der Assistent für Authentifizierungs-Scopes ist verfügbar, wenn Sie die interaktive Tokenauthentifizierung verwenden.

Die Aktivität Scope enthält einen universellen Berechtigungsselektor, der ein klares Bild aller verwendeten Authentifizierungs-Scopes bietet, die die Aktivitäten benötigen, um ordnungsgemäß zu funktionieren.

Alle untergeordneten Aktivitäten in der Aktivität Microsoft 365 Scope werden automatisch als erforderliche Scopes erkannt.

Wenn im Scopes-Assistenten keine Scopes manuell ausgewählt werden, wird die Funktion „Automatische Erkennung“ standardmäßig zur Laufzeit angewendet; die Konfiguration des Assistenten ist nicht mehr erforderlich. Alle minimal erforderlichen Scopes werden zur Laufzeit ausgewählt.

Sie können einen Scope auch manuell hinzufügen, nachdem Sie eine untergeordnete Aktivität zu Microsoft 365 Scope hinzugefügt haben.

Als Nächstes müssen Sie den Authentifizierungstyp im Eigenschaftenbereich auswählen und die für Ihre bevorzugte Authentifizierungsmethode erforderlichen Felder konfigurieren. Im folgenden Abschnitt finden Sie die unter jedem Menü verfügbaren Felder.

Authentication

• Authentifizierungstyp – Der für Ihre registrierte Anwendung erforderliche Authentifizierungstyp. Wählen Sie eine der fünf Optionen aus: Interaktives Token, Integrierte Windows-Authentifizierung (IWA), Benutzername und Kennwort, Anwendungs-ID und Geheimschlüssel oder Anwendungs-ID und Zertifikat. Der Standardwert ist „Interaktives Token“.

• Umgebung – Die Umgebung. Entweder Azure Global oder nationale Clouds, bei denen es sich um eindeutige und von Azure Global getrennte Umgebungen handelt. Wählen Sie eine der fünf Optionen aus: Standard, Global, China, Deutschland oder USGovernment. Der Standardwert ist Global.

• Anwendungs-ID – Die eindeutige Anwendungs- (Client)-ID, die von Azure Active Directory zugewiesen wurde, als Sie Ihre App während des Setups registriert haben . Die Anwendungs-ID (Client) stellt eine Instanz einer Microsoft 365-Anwendung dar.

• Mandant – Die eindeutige Verzeichnis-ID (Mandant), die von Azure Active Directory zugewiesen wurde, als Sie Ihre App während des Setups registriert haben. Erforderlich für Anwendungen mit mehreren Mandanten und integrierte Windows-Authentifizierung. Die Verzeichnis-ID (Mandant) finden Sie auf der Übersichtsseite Ihrer registrierten Anwendung (unter der Anwendungs- (Client)-ID).

• Speicherort für Verbindungsdaten – Eine Dropdownliste, die angibt, wo die Tokenantwort gespeichert wird. Die verfügbaren Eigenschaftswerte sind Lokaler Datenträger, Orchestrator oder Niemals speichern.

  • Lokaler Datenträger – Die Verbindungstoken werden in einem lokalen Ordner auf der Maschine gespeichert. Dieselbe Verbindung kann in mehreren Prozessen auf derselben Maschine verwendet werden.
  • Orchestrator – Die Verbindungstoken werden im Orchestrator als Assets in einem angegebenen Ordner gespeichert. Dieselbe Verbindung kann in mehreren Prozessen auf mehreren Maschinen verwendet werden, solange sie Zugriff auf den angegebenen Orchestrator-Ordner hat.
  • Niemals speichern – Die Verbindungstoken werden nie gespeichert.
  Hinweis:

  Die O365-Speicherlösung unterscheidet sich aufgrund von technischen Einschränkungen von der GSuite. O365 speichert alle Konten in einer einzelnen Datei im Orchestrator, während GSuite eine Datei pro Konto speichert.

• Orchestrator-Ordnerpfad – Der Orchestrator-Ordner, in dem die Operationen ausgeführt werden. Leer lassen, wenn moderne Ordner nicht aktiviert sind. Weitere Informationen finden Sie Über Ordner im Orchestrator-Handbuch.

• E-Mail-Adresse des Benutzers, dessen Identität angenommen wird – Die E-Mail-Adresse des Benutzers, dessen Identität angenommen wird. Wird in Unattended-Szenarien für die Authentifizierungsmethoden Anwendungs-ID und Geheimschlüssel sowie Anwendungs-ID und Zertifikat verwendet.

Interaktives Token

Hinweis:

Dies ist dieselbe Authentifizierungsmethode, die Integration Service entweder über die öffentliche UiPath-App oder die Methode Mitbringen Ihrer eigenen App unterstützt.

Weitere Informationen finden Sie unter Interaktives Token.

• OAuthClient – Gibt die zu verwendende Anwendung (Client) an. Dieses Feld unterstützt nur OAuthApplication-Variablen. Wählen Sie eine der folgenden Optionen aus:
  • UiPath – Standard. Wenn Sie die von UiPath erstellte Anwendung (UiPath Public App-Registrierung) verwenden möchten. Wenn diese Option ausgewählt ist, werden die im Abschnitt Authentifizierung bereitgestellten Felder Anwendungs-ID und Mandant ignoriert.
  • Benutzerdefiniert – Wenn Sie Ihre eigene Anwendung mit bestimmten Berechtigungen erstellen möchten. In diesem Fall müssen Sie einen Wert für das Feld Anwendungs-ID festlegen. Überprüfen Sie die benutzerdefinierte OAuth-Anwendungsregistrierung – Bring your own App (BYOA).
• Browser verwenden – Legen Sie diese Option auf *True fest, um den Browser des Windows-Authentifizierungs-Managers (WAM) für die interaktive Authentifizierung zu verwenden. Diese Option bietet eine stärker integrierte Authentifizierung unter Windows.
• OAuth2User – Die E-Mail-Adresse des Benutzers, der sich über das interaktive Token anmeldet.

Anwendungs-ID und Zertifikat (Unattended)

Weitere Informationen finden Sie unter Anwendungs-ID und Zertifikat.

• ZertifikatAlsBase64 – Die base64-Darstellung des Zertifikats.
• Zertifikatkennwort – Ein optionales Kennwort als Secure String, das für die Verwendung des Zertifikats erforderlich sein kann.

Application ID and Secret (Unattended)

Weitere Informationen finden Sie unter Anwendungs-ID und Geheimschlüssel.

• Application Secret - The secret string that the application uses to provide its identity.
• Secure Application Secret - The Application (client) secret, as a SecureString.

Benutzername und Kennwort (Unattended)

Weitere Informationen finden Sie unter Benutzername und Kennwort.

Wichtig:

Microsoft hat die Standardauthentifizierung für Exchange online eingestellt. Dies wirkt sich auf einige unserer Aktivitäten aus, z. B. Microsoft Office365 Scope. Wir empfehlen die Verwendung des OAuth-Protokolls in den Aktivitäten, die es unterstützen.

• Kennwort – Das Kennwort Ihres Microsoft 365-Kontos.
• SicheresKennwort – Das Kennwort Ihres Microsoft 365-Kontos als SecureString.
• Benutzername – Der Benutzername Ihres Microsoft 365-Kontos.

Allgemein

• TimeoutMS – Gibt die Wartezeit (in Millisekunden) an, die bis zum Abschluss der interaktiven Authentifizierung (Zustimmungsdialogfeld) gewartet werden soll, bevor ein Fehler ausgegeben wird. Dieses Feld unterstützt nur Integer und Int32-Variablen. Der Standardwert ist 30.000 ms (30 Sekunden) (nicht angezeigt).
• ContinueOnError - If set, continue executing the remaining activities even if the current activity has failed.

Fehlersuche und ‑behebung

Wenn Sie Probleme mit der Authentifizierung haben, finden Sie weitere Informationen unter Fehlerbehebung – Authentifizierung.