Microsoft Teams-Authentifizierung

In diesem Dokument wird beschrieben, wie Microsoft Teams mit UiPath Integration Service mit OAuth 2.0 authentifiziert werden. Der Microsoft Teams-Connector unterstützt die benutzerbasierte OAuth-Authentifizierung mit optionaler Unterstützung für benutzerdefinierte OAuth-Anwendungen und Bot-fähige Szenarien.

Überblick

In der folgenden Tabelle sind die unterstützten Authentifizierungsoptionen und deren Voraussetzungen zusammengefasst.

Authentifizierungsszenario	Beschreibung	Voraussetzungen
Von UiPath verwaltetes OAuth (Autorisierungscode)	Verwendet eine von UiPath verwaltete Anwendung	Microsoft Teams-Konto, Fähigkeit, Zustimmung zu erteilen
Bring Your Own OAuth App (BYOA)	Verwendet eine von Kunden verwaltete Azure AD-Anwendung	Azure AD App, Client-ID, Geheimer Clientschlüssel, Mandanten-ID, Administratorzustimmung

OAuth 2.0-Authentifizierung

Bot einschließen

The Include Bot option determines whether the connection includes Microsoft Teams bot-based access in addition to user-delegated OAuth permissions. Selecting this option enables sending messages as Uipath notification with your connection.

Einstellung	Verhalten
Nein (Standard)	Nur benutzerdelegierter OAuth
Ja	Aktiviert die Bot-Funktion von Microsoft Teams

Hinweis:

• Die Bot-Authentifizierung erfordert einen registrierten Microsoft Teams-Bot in Azure.
• Bot-Unterstützung ist für die meisten Microsoft Teams-Aktivitäten nicht erforderlich.
• Verwenden Sie diese Option nur, wenn Ihre Automatisierung explizit Bot-Funktionen erfordert.

Bring Your Own OAuth App (BYOA).

Wenn Sie Bring Your Own OAuth App auswählen, konfigurieren Sie Ihre Azure AD-Anwendung wie folgt.

Azure-Anwendungseinstellungen

Einstellung	Wert
OAuth-Flow	Authorization Code
Umleitungs-/Rückruf-URL	https://{baseURL}/provisioning_/callback(z. B.https://cloud.uipath.com/provisioning_/callback für die Automation Cloud).
Unterstützte Kontotypen	Einzelmandant oder mehrere Mandanten
API	Microsoft Graph

Mandanten-ID

App-Typ	Mandanten-ID
Multi-tenant	common
Einzelner Mandant	Azure-Mandanten-ID

Hinweis:

UiPath unterstützt sowohl Anwendungen mit einem einzelnen Mandanten als auch Anwendungen mit mehreren Mandanten.

Scopes und Berechtigungen

Scopes steuern, welche Aktionen UiPath in Microsoft Teams ausführen kann. Scopes können während der Verbindungserstellung konfiguriert werden.

Obligatorische Scopes

Die folgenden Scopes sind obligatorisch und dürfen nicht entfernt werden. Sie sind für eine erfolgreiche Verbindung erforderlich.

Umfang	Zweck
openid	Benutzerauthentifizierung und Generierung von ID-Tokens
offline_access	Aktiviert die Ausgabe von Aktualisierungstokens
User.Read	Liest das Profil des angemeldeten Benutzers

Hinweis:

Das Entfernen eines obligatorischen Scope führt zu Fehlern bei der Verbindung oder bei der Laufzeitauthentifizierung.

Alle Scopes

Die folgenden Scopes aktivieren gängige Microsoft Teams-Automatisierungsszenarien.

Umfang	Use case	Aktivität oder Ereignis
openid	Mit dieser Berechtigung kann eine App einen eindeutigen Bezeichner für den Benutzer in Form des Unterantrags erhalten. Die Berechtigung ermöglicht der App auch Zugriff auf den Endpunkt UserInfo . Der Scope openid kann am Tokenendpunkt der Microsoft Identity-Plattform verwendet werden, um ID-Tokens zu erwerben. Die App kann diese Token für die Authentifizierung verwenden	Keine Angabe
offline_access	Erforderlich, um ein Aktualisierungstoken im Endpunkt der Authentifizierungsanforderung zu erhalten. Wenn Sie einen Autorisierungscode im Flow des OAuth 2.0-Autorisierungscodes ohne Offline\_Access-Scope einlösen, erhalten Sie kein Aktualisierungstoken vom /token-Endpunkt.	Keine Angabe
profile	Abrufen des aktuellen Benutzerprofils, wie Name, Benutzername, E-Mail-Adresse usw., damit es als Standardbenutzer/authentifizierter Benutzer bei der Verbindungserstellung und in bestimmten Aktivitäten verwendet werden kann	Keine Angabe
email	Ermöglicht der App, die primären E-Mail-Adressen aller Ihrer Benutzer zu lesen, um Nachrichten zu senden oder sie zu einem Kanal einzuladen	Einzelne Chatnachricht senden, Mitglied zu Kanal einladen, Benutzer zu Team einladen
User.Read	Ermöglicht Benutzern die Anmeldung bei der App und ermöglicht der App, das Profil angemeldeter Benutzer zu lesen. Dadurch kann die App auch grundlegende Unternehmensinformationen von angemeldeten Benutzern lesen	Datensatz abrufen → Ich
Team.Create	Erstellen Sie ein Team zum Einladen und Einbeziehen der jeweiligen Benutzer	Datensatz einfügen → Teams
Team.ReadBasic.All	Abrufen der Liste der Teams, die in den Aktivitäten ausgewählt werden sollen, z. B. durch Senden einer Kanalnachricht usw.	Kanal erstellen, Alle Kanäle auflisten, Chatnachricht senden, Einzelne Chatnachricht senden, Mitglied zu einem Kanal einladen, Auf eine Kanalnachricht antworten, Kanalnachricht senden, Team nach Name abrufen
TeamMember.ReadWrite.All	Mitglied zu einem Team im Namen des angemeldeten Benutzers hinzufügen Liste der Mitglieder eines Teams abrufen	Alle Teammitglieder auflisten, Benutzer zum Team einladen, Team nach Name abrufen, Datensatz einfügen → Teams-Mitglieder, Alle Datensätze auflisten → Teams-Mitglieder
Channel.Create	Erstellen Sie einen Kanal (Standard/privat), um die jeweiligen Benutzer des Teams einzuladen und einzubinden	Create Channel
Channel.ReadBasic.All	Rufen Sie die Liste der Kanäle eines Teams ab, die in den Aktivitäten ausgewählt werden sollen, z. B. Senden einer Kanalnachricht usw.	Kanal nach Name abrufen, Mitglied zu einem Kanal einladen, Alle Kanäle auflisten, Kanal nach Name auflisten, Auf Kanalnachricht antworten, Kanalnachricht senden
ChannelMember.ReadWrite.All	Mitglied zu einem Kanal im Namen des angemeldeten Benutzers hinzufügen Rufen Sie die Liste der Mitglieder ab, die an einem Kanal beteiligt sind	Mitglied zu einem Kanal einladen, Alle Datensätze auflisten → Teams-Kanalmitglieder
ChannelMessage.Send	Senden Sie eine Nachricht in einem Kanal. Antworten Sie auch bei Bedarf auf eine Nachricht in einem Thread.	Auf Kanalnachricht antworten, Kanalnachricht senden
ChannelMessage.Read.All	Ermöglicht der App, alle Kanalnachrichten in Microsoft Teams zu lesen, ohne dass ein angemeldeter Benutzer vorhanden ist. Wird auch verwendet, um Ereignisse auszulösen, wenn eine Nachricht im Kanal gepostet wird oder ein Schlüsselwort im Kanal erwähnt wird	Auf Kanalnachricht antworten, Alle Kanalnachrichten auflisten, Alle Datensätze auflisten → Teams-Kanalnachrichten, Wenn eine Nachricht im Kanal gepostet wird (Zukunft), Wenn ein Schlüsselwort oder Benutzername im Kanal erwähnt wird (Zukunft)
Chat.ReadWrite	Ermöglicht der App das Lesen und Senden Ihrer 1:1-Ermöglicht der App das Lesen und Senden von Gruppenchat-Nachrichten Wird auch zum Auslösen von Ereignissen verwendet, wenn eine Chatnachricht veröffentlicht wird	Gruppenchat-Nachricht senden, Einzelne Chatnachricht senden, Alle Chatnachrichten auflisten, Alle Datensätze auflisten → Chats, Wenn eine Chatnachricht gepostet wird (Zukunft)
ChatMember.ReadWrite	Mitglied zu einem Chat im Namen des angemeldeten Benutzers hinzufügen Rufen Sie die Liste der Mitglieder ab, die an einem Chat beteiligt sind	Datensatz einfügen → Chats-Mitglieder, Alle Datensätze auflisten → Chats-Mitglieder
Calendars.ReadWrite	Erstellen Sie einen Outlook-Kalendereintrag für die Online-Besprechung von Teams.	Create Online Teams Meeting
OnlineMeetings.ReadWrite	Erstellen Sie eine Onlinebesprechung in Microsoft Teams und rufen Sie die Besprechungs-ID, den Passcode und die URL im Namen des aktuellen Benutzers ab.	Create Online Teams Meeting
Files.Read.All	Rufen Sie die Dateiinformationen ab, die in SharePoint hochgeladen wurden, um sie in einem Teams-Kanal oder -Chat freizugeben	Kanalnachricht senden, Gruppenchat-Nachricht senden, Einzelne Chatnachricht senden, Auf Kanalnachricht antworten

Scopes können hinzugefügt oder entfernt werden, um dem Prinzip der geringsten Berechtigungen zu folgen.

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.

Dieses Problem betrifft alle Microsoft Graph-basierten Connectors.

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.

Fügen Sie die Microsoft Teams-Verbindung hinzu

Um eine Verbindung mit Ihrer Microsoft Teams-Instanz herzustellen, müssen Sie die folgenden Schritte ausführen:

1. Select Orchestrator from the product launcher.
2. Select a folder, and then navigate to the Connections tab.
3. Select Add connection.
4. To open the connection creation page, select the connector from the list. You can use the search bar to find the connector.
5. Sie können zwischen zwei Authentifizierungstypen wählen: OAuth 2.0-Autorisierungscode oder Mitbringen Ihrer eigenen OAuth 2.0-App.
6. Geben Sie die erforderlichen Anmeldeinformationen ein.
7. Select Connect.

Weitere Informationen zur Authentifizierung in Microsoft Teams finden Sie auf der Seite Microsoft -Authentifizierung und Autorisierung .