Configurer l’application Tableau pour Microsoft Teams
L’application Tableau pour Microsoft Teams permet à vos utilisateurs d’interagir avec les vues (visualisations) et les métriques Tableau sans quitter leur flux de travail. En tant qu’administrateur Tableau, vous installez et configurez l’application pour connecter votre site Tableau existant à votre déploiement Microsoft Teams. Vous pouvez installer l’application pour Tableau Cloud directement depuis Microsoft Marketplace. Pour installer l’application pour Tableau Server, vous devez télécharger et charger une version latérale de l’application.
Pour plus d’informations sur l’utilisation de l’application Tableau pour Microsoft Teams, consultez l’article Accéder au contenu Tableau dans Microsoft Teams. Cet article traite de la configuration de l’application Tableau.
Voir également
- FAQ de l’application Tableau sur GitHub(Le lien s’ouvre dans une nouvelle fenêtre)
- Notes de version sur GitHub(Le lien s’ouvre dans une nouvelle fenêtre)
- Tutoriel de prise en main sur Youtube(Le lien s’ouvre dans une nouvelle fenêtre)
Conditions préalables
Pour configurer l’application Tableau pour Microsoft Teams, vous avez besoin des applications et des comptes suivants :
- Tableau Cloud ou Tableau Server, version 2023.1 ou plus récente
- Un compte d’administrateur de site pour Tableau Cloud ou un compte d’administrateur de serveur pour Tableau Server
- Un abonnement Microsoft 365 pour Enterprise
- Microsoft Teams
- Un compte d’administrateur Microsoft 365, si les stratégies de votre organisation exigent un compte d’administrateur pour installer des applications
- Licences utilisateur pour Tableau et Microsoft Teams qui sont mappées les unes aux autres en fonction de l’un des attributs de mappage d’utilisateurs
Attributs de mappage des utilisateurs
Pour permettre l’authentification unique avec Tableau, vous devez mapper les comptes utilisateur dans Microsoft Teams aux comptes utilisateur dans Tableau. Vous pouvez configurer ce mappage à l’aide d’attributs du SDK Microsoft Teams ou du profil Microsoft Entra d’un utilisateur.
Attributs du SDK Microsoft Teams
| Attribut | Description |
|---|---|
| Preferred_Username(Le lien s’ouvre dans une nouvelle fenêtre) | L’adresse de courriel de l’utilisateur Microsoft Teams. Dans certains cas, cette valeur diffère de l’adresse de courriel définie dans Microsoft Entra. |
| User Principal Name(Le lien s’ouvre dans une nouvelle fenêtre) | Principal moyen de connexion des utilisateurs à Microsoft Entra. |
Attributs du profil Microsoft Entra
| Attribut | Description |
|---|---|
| Primary Email(Le lien s’ouvre dans une nouvelle fenêtre) | Correspond à l’attribut user.mail et représente l’adresse de courriel de l’utilisateur. |
| Mail Nickname(Le lien s’ouvre dans une nouvelle fenêtre) | Correspond à l’attribut user.mailNickname et représente l’alias de l’utilisateur. |
| Employee ID(Le lien s’ouvre dans une nouvelle fenêtre) | Correspond à l’attribut user.employeeId et représente l’identificateur d’employé attribué par l’entreprise. |
| On-Premise Distinguished Name(Le lien s’ouvre dans une nouvelle fenêtre) | Correspond à l’attribut user.onPremiseDistinguishedName et représente le nom distinctif (DN) synchronisé à partir d’un serveur Active Directory local. |
| On-Premise User Principal Name(Le lien s’ouvre dans une nouvelle fenêtre) | Correspond à l’attribut user.onPremiseUserPrincipalName et représente le nom principal de l’utilisateur (userPrincipalName) synchronisé à partir d’un serveur Active Directory local. |
| On-premise SAM Account Name(Le lien s’ouvre dans une nouvelle fenêtre) | Correspond à l’attribut user.onPremiseSamAccountName et représente le nom de compte Sam (samAccountName) synchronisé à partir d’un serveur Active Directory local. |
| Extension Attribute X(Le lien s’ouvre dans une nouvelle fenêtre) | Microsoft Entra vous permet d’ajouter jusqu’à 15 attributs supplémentaires au profil Entra d’un utilisateur. Si le nom d’utilisateur Tableau n’existe pas dans Microsoft Entra, utilisez un attribut d’extension pour stocker le nom d’utilisateur Tableau pour chaque utilisateur Entra. |
Conditions préalables supplémentaires pour Tableau Server
L’application Tableau utilise des appels d’API pour communiquer avec Tableau Server et intégrer du contenu interactif. Ces appels doivent pouvoir atteindre Tableau Server.
- Si Tableau Server se trouve derrière un pare-feu, autorisez les requêtes HTTP entrantes provenant des plages d’adresses IP 4.152.0.0/15 et 20.2.0.0/16.
- Assurez-vous que les utilisateurs puissent accéder à Tableau Server de la même manière qu’ils accèdent à Microsoft Teams.
- Si les utilisateurs doivent utiliser un VPN pour accéder à Microsoft Teams, Tableau Server doit être accessible à partir du même VPN.
- Si les utilisateurs peuvent accéder à Microsoft Teams depuis l’Internet public, Tableau Server doit être accessible depuis l’Internet public.
- Si les utilisateurs peuvent accéder à Microsoft Teams via des applications mobiles, Tableau Server doit être accessible depuis des appareils mobiles.
Installer l’application Tableau pour Tableau Server
Pour installer l’application Tableau pour Tableau Server, modifiez le manifeste de l’application pour personnaliser le nom d’hôte, puis téléversez le manifeste de l’application sur Microsoft Teams.
Pour installer l’application Tableau pour Tableau Cloud, consultez le Guide de configuration de Tableau Cloud.
1. Télécharger et modifier le manifeste de l’application
- Depuis GitHub, téléchargez le manifeste de l’application.
Extrayez les fichiers du fichier manifeste
tableau-server-app-for-teams.zip.Ouvrez le fichier
manifest.jsondans un éditeur de texte.Recherchez
*.online.tableau.comdansmanifest.jsonet remplacez ce domaine par le nom d’hôte de votre environnement Tableau Server. Si l’URL de votre Tableau Server esthttps://analytics.company.com, le nom d’hôte estanalytics.company.com.Enregistrez vos modifications dans
manifest.json.Compressez les fichiers dans le dossier
tableau-app-for-teams-serverpour créer un fichier zip incluant vos modifications.
2. Téléverser le manifeste de l’application
Les stratégies d’application de votre organisation déterminent si vous êtes en mesure d’installer des applications Microsoft Teams. Un compte d’administrateur Microsoft 365 peut être nécessaires pour installer des applications.
Ouvrez le Centre d’administration Microsoft Teams(Le lien s’ouvre dans une nouvelle fenêtre).
Dans le volet de navigation, sélectionnez Applications Teams > Gérer les applications.
Sélectionnez Actions > Téléverser une nouvelle application.
Téléversez le fichier
tableau-server-app-for-teams.zipque vous avez modifié. Vous recevez ensuite un message de confirmation avec un lien pour gérer l’application.
3. Installer et épingler l’application pour vos utilisateurs
Vous pouvez installer l’application pour la rendre accessible pour tous vos utilisateurs ou pour un sous-ensemble d’utilisateurs. Vous pouvez également épingler l’application afin qu’elle apparaisse dans la barre d’applications de vos utilisateurs.
Ouvrez le Centre d’administration Microsoft Teams(Le lien s’ouvre dans une nouvelle fenêtre).
Dans le volet de navigation, sélectionnez Applications Teams > Configurer les stratégies.
Sous Applications installées, sélectionnez Ajouter des applications, puis ajoutez l’application Tableau.
Si vous le souhaitez, sélectionnez Ajouter des applications sous Applications épinglées, puis ajoutez l’application Tableau.
Enregistrez vos modifications.
Après avoir ajouté l’application Tableau, il peut s’écouler jusqu’à 24 heures avant que l’application ne soit disponible pour vos utilisateurs.
Configurer l’application Tableau
Une fois que vous avez installé l’application Tableau, Microsoft Teams vous invite à configurer l’application. Configurez les informations de votre site pour connecter l’application à votre site Tableau.
1. Créer une application connectée
L’application Tableau pour Microsoft Teams utilise une application connectée pour authentifier les utilisateurs avec l’authentification unique. Créez cette application connectée dans Tableau Cloud ou Tableau Server.
Dans Tableau Cloud ou Tableau Server, créez une application connectée utilisant la confiance directe. Pour plus d’informations, consultez Configurer les applications connectées avec la confiance directe pour Tableau Cloud ou Configurer les applications connectées avec la confiance directe pour Tableau Server(Le lien s’ouvre dans une nouvelle fenêtre).
- Si vous limitez la liste d’autorisations de domaines pour l’application connectée aux domaines spécifiés uniquement, ajoutez les domaines suivants à la liste d’autorisations.
tableau-ms-teams-prod-gycea7csh5hsbfh5.a02.azurefd.netteams.microsoft.com*.teams.microsoft.com
- Si vos utilisateurs accèdent à l’application à partir d’autres plateformes Microsoft, ajoutez les domaines supplémentaires à partir de la liste des URL Microsoft 365(Le lien s’ouvre dans une nouvelle fenêtre).
- Si vous limitez la liste d’autorisations de domaines pour l’application connectée aux domaines spécifiés uniquement, ajoutez les domaines suivants à la liste d’autorisations.
Activez l’application connectée.
Générez un secret d’application connectée.
Copiez l’ID client, l’ID du secret et la valeur secrète de l’application connectée. Enregistrez ces valeurs. Vous en aurez besoin lorsque vous configurerez votre site Tableau dans Microsoft Teams.
2. Ajouter votre configuration de site à l’application Tableau
Lorsque vous ouvrez l’application Tableau, si vous n’avez pas encore configuré l’application, un écran de configuration s’affiche.
Comme Étiquette, donnez un nom au site. C’est le nom qui apparaîtra aux utilisateurs de l’application Microsoft Teams. Si vous ne saisissez pas d’étiquette, l’application affiche le nom du site. Ce champ est facultatif.
Dans le champ Nom du site Tableau, saisissez le nom du site tel qu’il apparaît dans l’URL de votre site. À titre d’exemple, pour l’URL
https://us-west-2b.online.tableau.com/#/site/mysitename/home, vous saisiriezmysitename. Si vous connectez l’application à Tableau Server et que vous souhaitez utiliser le site par défaut, laissez ce champ vide.Pour l’URL de base, saisissez la partie de l’URL du site qui se termine par
tableau.com, par exemple,https://us-west-2b.online.tableau.com.Pour l’attribut de mappage de l’utilisateur, sélectionnez l’attribut Microsoft Entra utilisé pour authentifier l’utilisateur avec l’authentification unique.
Pour l’ID de l’application connectée, l’ID du secret de l’application connectée et la Valeur du secret de l’application connectée, collez les valeurs que vous avez copiées lors de la création de l’application connectée.
Sélectionnez Ajouter une configuration de site.
L’application Tableau teste la connexion avant d’enregistrer les détails de la configuration. La configuration du site ne sera pas ajoutée si l’application ne peut pas se connecter à Tableau. Cet échec peut être dû au fait que l’application connectée n’est pas en mesure de s’authentifier, que l’application connectée n’est pas activée, que les informations du site sont incorrectes ou que le compte que vous utilisez n’est pas un compte administrateur Tableau. Cela peut également signifier que l’application ne peut pas atteindre Tableau Server parce qu’elle se trouve derrière un pare-feu.
Ajouter ou supprimer des configurations de site
Après avoir ajouté une configuration de site, vous pouvez ajouter des sites supplémentaires ou supprimer une configuration de site existante.
Dans l’application Tableau pour Microsoft Teams, sélectionnez l’onglet Configuration.
Sous « Configuration », sélectionnez l’onglet Configuration du site Tableau. Seuls les administrateurs Tableau peuvent accéder aux paramètres de cet onglet.
Pour ajouter un site, sélectionnez Ajouter les détails du site. Ou, pour supprimer un site, sélectionnez l’icône de suppression de ce site.
