Microsoft Teams-Scope

Die Microsoft Teams-Aktivitäten verwenden die Microsoft Identity-Plattform , um eine authentifizierte Verbindung zwischen UiPath und Ihrer Microsoft Teams-Anwendung über die Microsoft Scope -Aktivität herzustellen. Diese Verbindung ermöglicht einem Roboter, die Microsoft Graph-API aufzurufen, 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 persönlichen, geschäftlichen und/oder schulischen Microsoft Office 365-Konto. Bei der Registrierung Ihrer Anwendung weisen Sie die Microsoft Graph API-Berechtigungen zu, die festlegen, auf welche Ressourcen ein Roboter in Ihrem Namen zugreifen kann.

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

Hinweis:

Weitere Informationen zum Registrieren Ihrer Anwendung und zum Zuweisen von Berechtigungen finden Sie in der Einrichtungsanleitung . Diese Anleitung enthält 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 Authentifizierung, Eingabe und Unattended ein.

   

Unattended- vs. Attended-Automatisierung

Die Aktivität Microsoft Teams Scope verfügt über drei verschiedene Authentifizierungsflows (AuthenticationTypes), die Sie auswählen können, wenn Sie die Aktivität zu Ihrem Projekt hinzufügen. 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 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 Attended-Automatisierung nur mit dem InteractiveToken -Authentifizierungstyp ausführen.

Interaktives Token

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

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

Wenn Sie diese Option auswählen, müssen die Eigenschaften Username,Password und Mandant leer bleiben.

Dieser Authentifizierungstyp folgt dem OAuth 2.0-Autorisierungscode.

Integrierte Windows-Authentifizierung

The IntegratedWindowsAuthentication authentication type can be used for both attended and unattended automation. This option can apply to Windows hosted applications running on computers joined to a Windows domain or Azure Active Directory.

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, müssen die Eigenschaften Username,Password und Mandant leer bleiben.

UsernameAndPassword

The UsernameAndPassword authentication type can be used for both attended (when mutli-factor authentication is not required) and unattended automation.

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

If you select this option, the Username and Password properties are required and the Tenant property is optional for single-tenant applications (required for multi-tenant applications).

Hinweis:

The ApplicationID property is required when selecting the UsernameAndPassword AuthenticationType. You can register your Microsoft Office 365 Application using your personal, work, and/or school account.

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-ID (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 IntegratedWindowsAuthentication UsernameAndPassword
Hinweise	Weitere Informationen zu diesen Optionen und welcher ausgewählt werden sollen, finden Sie oben im Abschnitt Unattended- und Attended-Automatisierung .

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 eine Unattended-Automatisierung ausführen. Stellen Sie beim Angeben von Werten für diese Eigenschaften sicher, dass die Eigenschaft Authentifizierungstyp auf BenutzernameUndKennwort 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	No (required if AuthenticationType is UsernameAndPassword)
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 Authentifizierungstyp BenutzernameUndKennwort ist) und Kennwort ist null.
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	No (required if AuthenticationType is UsernameAndPassword)
Standardwert	Leer
Zulässige Werte	Geben Sie eine String oder String -Variable ein.
Hinweise	Keine Angabe