Microsoft Teams-Scope

Die Microsoft Teams-Aktivitäten verwenden die Microsoft Identity Platform , um eine authentifizierte Verbindung zwischen UiPath und Ihrer Microsoft Teams-Anwendung über die Aktivität Microsoft Scope herzustellen. Diese Verbindung ermöglicht einem Roboter das Aufrufen der Microsoft Graph-API, um Ressourcen in Ihrem Namen zu lesen und zu schreiben.

Um Ihre authentifizierte Verbindung herzustellen, registrieren Sie zuerst Ihre Microsoft Teams-Anwendung in Ihrem Azure Active Directory (mit Ihrem Privat-, Arbeits- und/oder Schulkonto für Microsoft Office 365). Bei der Registrierung Ihrer Anwendung weisen Sie die Microsoft Graph API-Berechtigungen zu, die angeben, auf welche Ressourcen ein Roboter in Ihrem Namen zugreifen kann.

Nach der Registrierung Ihrer Microsoft Teams-Anwendung weist Azure Active Directory eine eindeutige Anwendungs-(Client-)ID zu, die Sie in der Aktivität Microsoft Teams Scope eingeben. Die AnwendungsID wird verwendet, um die erforderlichen Informationen über Ihre registrierte App zu sammeln, um die Authentifizierung zu initiieren.

Hinweis: Weitere Informationen zum Registrieren Ihrer Anwendung und zum Zuweisen von Berechtigungen finden Sie in der Einrichtungsanleitung . In dieser Anleitung finden Sie Schritt-für-Schritt-Anweisungen zum Konfigurieren Ihrer Microsoft Teams-Anwendung für die Automatisierung.

Wie es funktioniert

Die folgenden Schritte und das folgende Nachrichtensequenzdiagramm sind ein Beispiel dafür, wie die Aktivität von der Entwurfszeit (d. h. den Aktivitätsabhängigkeiten und Eingabe-/Ausgabeeigenschaften) bis zur Laufzeit funktioniert.

1. Schließen Sie die Einrichtungsschritte ab.
2. Fügen Sie die Aktivität Microsoft Teams Scope zu Ihrem Projekt hinzu.

3. Geben Sie Werte für die Eigenschaften Authentication, Input und Unattended (falls zutreffend) ein.

   
   

   

   
   

Unattended- vs. Attended-Automatisierung

Die Aktivität Microsoft Teams Scope verfügt über drei verschiedene Authentifizierungsabläufe (AuthenticationTypes), aus denen Sie beim Hinzufügen der Aktivität zu Ihrem Projekt wählen können. Ihre Auswahl hängt vom Typ des Automatisierungsmodus ab, den Sie ausführen möchten (Unattended oder Attended) und Ihren Anwendungsauthentifizierungsanforderungen (wenden Sie sich an Ihren Administrator, wenn Sie sich nicht sicher sind, welche Authentifizierungsanforderungen für Ihre Anwendung gelten).

AuthenticationType	Attended	Unbeaufsichtigt
Interaktives Token	X
IntegratedWindowsAuthentication	X	X
UsernameAndPassword	X	X

Wichtig: Die Unattended-Automatisierung unterstützt keine mehrstufige Authentifizierung. Wenn Ihre Anwendung eine mehrstufige Authentifizierung erfordert, können Sie die beaufsichtigte Automatisierung nur mit dem InteractiveToken -Authentifizierungstyp ausführen.

Interaktives Token

Der InteractiveToken -Authentifizierungstyp kann für die beaufsichtigte Automatisierung verwendet werden und wenn mehrstufige Authentifizierung (MFA) erforderlich ist. Dies ist die Standardoption, die wir in unseren Beispielen verwenden. Wenn Sie mit dem Aktivitätspaket „herumprobieren“ möchten, dann ist diese Option einfach zu konfigurieren und funktioniert gut für persönliche Konten (mit dem standardmäßigen Umleitungs-URI, der in Schritt 7 des Abschnitts Registrieren Ihrer Anwendung der Einrichtungsanleitung vermerkt ist).

Wenn die Aktivität Microsoft Teams Scope zum ersten Mal mit diesem Authentifizierungstyp ausgeführt wird, werden Sie aufgefordert, den Zugriff auf die Ressourcen (für die Sie bei der Registrierung Ihrer App Berechtigungen erteilt haben) über ein Zustimmungsdialogfeld zu autorisieren.

Wenn Sie diese Option auswählen, sollten die Eigenschaften Benutzername,Kennwort und Mandant leer bleiben.

Dieser Authentifizierungstyp folgt dem OAuth 2.0-Autorisierungscodefluss.

Integrierte Windows-Authentifizierung

Der Authentifizierungstyp IntegratedWindowsAuthentication kann sowohl für die Attended- als auch für die Unattended-Automatisierung verwendet werden. Diese Option kann für gehostete Windows-Anwendungen gelten, die auf Computern ausgeführt werden, die Teil einer Windows-Domäne oder eines Azure Active Directory sind.

Sie sollten diese Option nur auswählen, wenn Ihre registrierte Anwendung für die Unterstützung der integrierten Windows-Authentifizierung konfiguriert ist (zusätzliche Informationen finden Sie auf GitHub ).

Wenn Sie diese Option auswählen, sollten die Eigenschaften Benutzername,Kennwort und Mandant leer bleiben.

UsernameAndPassword

Der Authentifizierungstyp BenutzernameUndKennwort kann sowohl für die Attended-Automatisierung (wenn keine mehrstufige Authentifizierung erforderlich ist) als auch für die Unattended-Automatisierung verwendet werden.

Obwohl es nicht von Microsoft empfohlen wird, können Sie diesen Authentifizierungstyp in öffentlichen Clientanwendungen verwenden. Die Verwendung dieses Authentifizierungstyps erlegt Ihrer Anwendung Einschränkungen auf. Apps, die diesen Flow verwenden, können sich beispielsweise nicht als Benutzer anmelden, der eine mehrstufige Authentifizierung durchführen muss (bedingter Zugriff). Dadurch kann Ihre Anwendung auch nicht vom einmaligen Anmelden profitieren. Die Authentifizierung mit Benutzername/Kennwort verstößt gegen die Prinzipien der modernen Authentifizierung und wird nur aus Legacy-Gründen bereitgestellt (zusätzliche Informationen finden Sie auf GitHub ).

Wenn Sie diese Option auswählen, sind die Eigenschaften Benutzername und Kennwort erforderlich und die Eigenschaft Mandant ist für Anwendungen mit nur einem Mandanten optional (erforderlich für Anwendungen mit mehreren Mandanten).

Hinweis: Die Eigenschaft AnwendungsID ist erforderlich, wenn Sie den Authentifizierungstyp UsernameAndPassword auswählen. Sie können Ihre Microsoft Office 365-Anwendung mit Ihrem Privat-, Arbeits- und/oder Schulkonto registrieren.

Eigenschaften

Die Werte für die folgenden Eigenschaften werden beim Hinzufügen dieser Aktivität zu Ihrem Projekt in UiPath Studio angegeben.

Allgemein

DisplayName

Der Anzeigename der Aktivität.

Attribute	Details
Typ	String
Erforderlich	Ja
Standardwert	Microsoft Teams-Scope
Zulässige Werte	Geben Sie eine String oder String -Variable ein.
Hinweise	Keine Angabe

Authentication

ApplicationID

Die eindeutige Anwendungs-(Client-)ID, die von Azure Active Directory zugewiesen wurde, als Sie Ihre App während des Setups registriert haben.

Attribute	Details
Typ	String
Erforderlich	Ja
Standardwert	Leer
Zulässige Werte	Geben Sie eine String oder String -Variable ein.
Hinweise	Die Anwendungs-ID (Client) stellt eine Instanz einer Microsoft Teams-Anwendung dar. Eine einzelne Organisation kann mehrere Anwendungs-(Client-)IDs für ihr Microsoft Office 365-Konto haben. Jede Anwendungs-(Client-)ID enthält eigene Berechtigungen und Authentifizierungsanforderungen. Sie und Ihr Kollege können beispielsweise sowohl eine Microsoft Teams-Anwendung im Azure Active Directory Ihres Unternehmens registrieren als auch Ihre eigene Anwendungs-(Client-)ID generieren.

AuthenticationType

Der für Ihre registrierte Anwendung erforderliche Authentifizierungstyp.

Attribute	Details
Typ	Dropdownauswahl
Erforderlich	Ja
Standardwert	Interaktives Token
Zulässige Werte	Wählen Sie eine der drei Optionen aus: InteractiveToken IntegratedWindowsAuthenticationUsernameAndPassword _
Hinweise	Weitere Informationen zu diesen Optionen und zur Auswahl finden Sie im Abschnitt „ Unattended- und Attended-Automatisierung “ oben.

Mandant

Die eindeutige Verzeichnis-ID (Mandant), die von Azure Active Directory zugewiesen wurde, als Sie Ihre App während registriert haben.

Attribute	Details
Typ	String
Erforderlich	Nein (erforderlich für Anwendungen mit mehreren Mandanten)
Standardwert	Leer
Zulässige Werte	Geben Sie eine String oder String -Variable ein.
Hinweise	Die Verzeichnis-ID (Mandant) finden Sie auf der Übersichtsseite Ihrer registrierten Anwendung (unter der Anwendungs-ID (Client).

Interaktives Token

OAuthAnwendung

Gibt die zu verwendende Anwendung (Client) an.

Attribute	Details
Typ	enum
Erforderlich	Nein
Standardwert	Benutzerdefiniert
Zulässige Werte	Benutzerdefiniert, UiPath
Hinweise	Wenn „UiPath“ ausgewählt ist, werden AnwendungsID und Mandant ignoriert.

Benutzername und Kennwort (Unattended)

Diese Eigenschaften gelten nur, wenn Sie die Unattended-Automatisierung ausführen. Achten Sie beim Angeben von Werten für diese Eigenschaften darauf, dass die Eigenschaft Authentifizierungstyp auf UsernameAndPassword festgelegt ist. Weitere Informationen finden Sie im Abschnitt „ Benutzername und Kennwort “ oben.

Passwort

Das Kennwort Ihres Microsoft Office 365-Kontos.

Attribute	Details
Typ	String
Erforderlich	Nein (erforderlich, wenn der Authentifizierungstyp UsernameAndPassword ist)
Standardwert	Leer
Zulässige Werte	Geben Sie eine String oder String -Variable ein.
Hinweise	Keine Angabe

SicheresKennwort

Das Kennwort Ihres Microsoft Office 365-Kontos.

Attribute	Details
Typ	SecureString
Erforderlich	Nein (erforderlich, wenn AuthenticationType den Wert UsernameAndPassword hat) und Password NULL ist.
Standardwert	Leer
Zulässige Werte	Geben Sie eine SecureString oder SecureString -Variable ein.
Hinweise	Keine Angabe

Benutzername

Der Benutzername Ihres Microsoft Office 365-Kontos.

Attribute	Details
Typ	String
Erforderlich	Nein (erforderlich, wenn der Authentifizierungstyp UsernameAndPassword ist)
Standardwert	Leer
Zulässige Werte	Geben Sie eine String oder String -Variable ein.
Hinweise	Keine Angabe