Einrichten der Tableau-App für Microsoft Teams
Mit der Tableau-App für Microsoft Teams können Ihre Benutzer mit Tableau-Ansichten (Visualisierungen) und Metriken interagieren, ohne ihren Workflow zu verlassen. Als Tableau-Administrator installieren und konfigurieren Sie die App, um Ihre vorhandene Tableau-Site mit Ihrer Microsoft Teams-Bereitstellung zu verbinden. Sie können die App für Tableau Cloud direkt vom Microsoft Apps Marketplace aus installieren. Um die App für Tableau Server zu installieren, laden Sie die App herunter und starten sie sie per „Sideload“.
Informationen über die Tableau-App für Microsoft Teams finden Sie unter Zugriff auf Tableau-Inhalte in Microsoft Teams. In diesem Artikel geht es um das Einrichten der Tableau-App.
Siehe auch
- Häufig gestellte Fragen zur Tableau-App auf GitHub(Link wird in neuem Fenster geöffnet)
- Versionshinweise auf GitHub(Link wird in neuem Fenster geöffnet)
- Tutorial zu den ersten Schritten auf Youtube(Link wird in neuem Fenster geöffnet)
Voraussetzungen
Zum Einrichten der Tableau-App für Microsoft Teams benötigen Sie die folgenden Apps und Konten.
- Tableau Cloud oder Tableau Server, Versionen 2023.1 oder höher
- Ein Site-Administratorkonto für Tableau Cloud oder ein Serveradministratorkonto für Tableau Server
- Ein Microsoft 365 für Enterprise-Abonnement
- Microsoft Teams
- Ein Microsoft 365-Administratorkonto, wenn die Richtlinien Ihrer Organisation ein Administratorkonto zum Installieren von Apps erfordern
- Benutzerlizenzen für Tableau und Microsoft Teams, die basierend auf einem der Benutzerzuordnungsattribute einander zugeordnet werden
Benutzerzuordnungsattribute
Um SSO mit Tableau zu ermöglichen, ordnen Sie die Benutzerkonten in Microsoft Teams den Benutzerkonten in Tableau zu. Sie können diese Zuordnung mithilfe von Attributen aus dem Microsoft Teams-SDK oder aus dem Microsoft Entra-Profil eines Benutzers einrichten.
Microsoft Teams-SDK-Attribute
| Attribut | Beschreibung |
|---|---|
| Preferred_Username(Link wird in neuem Fenster geöffnet) | Die E-Mail-Adresse des Microsoft Teams-Benutzers. In einigen Fällen kann dieser Wert anders lauten als die in Microsoft Entra definierte E-Mail-Adresse. |
| User Principal Name(Link wird in neuem Fenster geöffnet) | Die primäre Methode, über die sich Benutzer bei Microsoft Entra anmelden. |
Microsoft Entra-Profil-Attribute
| Attribut | Beschreibung |
|---|---|
| Primary Email(Link wird in neuem Fenster geöffnet) | Entspricht dem user.mail-Attribut und stellt die E-Mail-Adresse des Benutzers dar. |
| Mail Nickname(Link wird in neuem Fenster geöffnet) | Entspricht dem user.mailNickname-Attribut und stellt einen Alias für den Benutzer dar. |
| Employee ID(Link wird in neuem Fenster geöffnet) | Entspricht dem user.employeeId-Attribut und stellt eine von der Organisation zugewiesene Mitarbeiterkennung dar. |
| On-Premise Distinguished Name(Link wird in neuem Fenster geöffnet) | Entspricht dem user.onPremiseDistinguishedName-Attribut und stellt den definierten Namen (Distinguished Name, DN) dar, der aus einem lokalen Active Directory synchronisiert wird. |
| On-Premise User Principal Name(Link wird in neuem Fenster geöffnet) | Entspricht dem user.onPremiseUserPrincipalName-Attribut und stellt den Benutzerprincipalnamen (UPN) dar, der aus einem lokalen Active Directory synchronisiert wird. |
| On-premise SAM Account Name(Link wird in neuem Fenster geöffnet) | Entspricht dem user.onPremiseSamAccountName-Attribut und stellt den samAccountName dar, der aus einem lokalen Active Directory synchronisiert wird. |
| Extension Attribute X(Link wird in neuem Fenster geöffnet) | Microsoft Entra erlaubt es Ihnen, dem Entra-Profil eines Benutzers bis zu 15 zusätzliche Attribute hinzufügen. Wenn der Tableau-Benutzername in Microsoft Entra nicht vorhanden ist, verwenden Sie ein Erweiterungsattribut, um den Tableau-Benutzernamen für jeden Entra-Benutzer zu speichern. |
Installieren der Tableau-App für Tableau Cloud
Sie installieren die Tableau Cloud-App direkt aus dem Microsoft Apps Marketplace. Ob Benutzer die App selbst installieren können oder ob ein Administrator dies durchführen muss, hängt von den Richtlinien Ihrer Organisation ab.
- Informationen zum Installieren einer App als Administrator finden Sie unter Vorinstallieren von Apps für Ihre Benutzer(Link wird in neuem Fenster geöffnet) in der Microsoft Teams-Dokumentation.
- Informationen zum Installieren einer App als Benutzer finden Sie unter Hinzufügen einer App zu Microsoft Teams(Link wird in neuem Fenster geöffnet) in der Microsoft Teams-Dokumentation.
Informationen zum Installieren der Tableau-App für Tableau Server finden Sie im Tableau Server-Einrichtungshandbuch.
Konfigurieren der Tableau-App
Nachdem Sie die Tableau-App installiert haben, werden Sie von Microsoft Teams aufgefordert, die App einzurichten. Sie konfigurieren Ihre Site-Informationen, um die App mit Ihrer Tableau-Site zu verbinden.
1. Erstellen einer verbundenen App
Die Tableau-App für Microsoft Teams verwendet eine verbundene App, um Benutzer mit SSO zu authentifizieren. Diese verbundene App erstellen Sie in Tableau Cloud oder Tableau Server.
Erstellen Sie in Tableau Cloud oder Tableau Server eine verbundene App mit direkter Vertrauensstellung. Weitere Informationen finden Sie unter Konfigurieren von verbundenen Apps mit direkter Vertrauensstellung für Tableau Cloud oder Konfigurieren von verbundenen Apps mit direkter Vertrauensstellung für Tableau Server(Link wird in neuem Fenster geöffnet).
- Wenn Sie die Domänenzulassungsliste für die verbundene App auf nur spezifische Domänen einschränken, müssen Sie der Zulassungsliste die folgenden Domänen hinzufügen.
tableau-ms-teams-prod-gycea7csh5hsbfh5.a02.azurefd.netteams.microsoft.com*.teams.microsoft.com
- Wenn Ihre Benutzer von anderen Microsoft-Plattformen aus auf die App zugreifen werden, müssen Sie weitere Domänen aus der Liste der Microsoft 365-URLs(Link wird in neuem Fenster geöffnet) hinzufügen.
- Wenn Sie die Domänenzulassungsliste für die verbundene App auf nur spezifische Domänen einschränken, müssen Sie der Zulassungsliste die folgenden Domänen hinzufügen.
Aktivieren Sie die verbundene App.
Generieren Sie ein Geheimnis für die verbundene App.
Kopieren Sie die Client-ID, die Geheimnis-ID und den Geheimniswert der verbundenen App. Speichern Sie diese Werte. Sie werden diese benötigen, wenn Sie Ihre Tableau-Site in Microsoft Teams konfigurieren.
2. Hinzufügen Ihrer Site-Konfiguration zur Tableau-App
Wenn Sie die Tableau-App öffnen und die App noch nicht konfiguriert haben, wird ein Bildschirm zum Einrichten der App angezeigt.
Geben Sie als Beschriftungeinen Namen für die Site. Dieser Name wird Benutzern der Microsoft Teams-App angezeigt. Wenn Sie keine Beschriftung eingeben, zeigt die App den Site-Namen an. Dieses Feld ist optional.
Geben Sie als Tableau-Site-Name den Site-Namen ohne Leerzeichen ein, wie er in der URL angezeigt wird. Beispiel: Würde die URL
https://us-west-2b.online.tableau.com/#/site/mysitename/homelauten, müssten Siemysitenameeingeben. Wenn Sie die App mit Tableau Server verbinden und die Standard-Site verwenden möchten, lassen Sie dieses Feld leer.Geben Sie als Basis-URL den Teil der Site-URL ein, der mit
tableau.comendet (z. Bhttps://us-west-2b.online.tableau.com).Wählen Sie als Benutzerzuordnungsattribut das Microsoft Entra-Attribut aus, das zum Authentifizieren des Benutzers mit SSO verwendet wird.
Fügen Sie bei ID der verbundenen App, Geheimnis-ID der verbundenen App und Geheimniswert der verbundenen App die Werte ein, die Sie beim Erstellen der verbundenen App kopiert haben.
Wählen Sie Site-Konfiguration hinzufügen aus.
Die Tableau-App testet die Verbindung, bevor die Konfigurationsdetails gespeichert werden. Wenn die App keine Verbindung zu Tableau herstellen kann, wird die Site-Konfiguration nicht hinzugefügt. Dies könnte daran liegen, dass die verbundene App nicht authentifiziert werden kann, die verbundene App nicht aktiviert ist, die Site-Informationen falsch sind oder dass das von Ihnen verwendete Konto kein Tableau-Administratorkonto ist. Es könnte auch bedeuten, dass die App nicht in der Lage ist, Tableau Server zu erreichen, weil sie sich hinter einer Firewall befindet.
Hinzufügen oder Löschen von Site-Konfiguration
Nachdem Sie eine Site-Konfiguration hinzugefügt haben, können Sie weitere Sites hinzufügen oder vorhandene Site-Konfigurationen löschen.
Wählen Sie in der Tableau-App für Microsoft Teams die Registerkarte Konfiguration aus.
Wählen Sie unter „Konfiguration“ die Registerkarte Tableau-Site-Konfiguration aus. Nur Tableau-Administratoren können auf die Einstellungen auf dieser Registerkarte zugreifen.
Um eine Site hinzuzufügen, wählen Sie Site-Details hinzufügenaus. Oder, um eine Site zu entfernen, klicken Sie auf das Löschsymbol für diese Site.
