Aide de Tableau Cloud

Depuis le début janvier 2022, les applications connectées à Tableau offrent une expérience d’authentification transparente et sécurisée en facilitant une relation de confiance explicite entre votre site Tableau Cloud et les applications externes à plusieurs fins :

• Restreindre l’accès au contenu qui peut être intégré et là où ce contenu peut être intégré
• Offrir aux utilisateurs la possibilité d’accéder au contenu intégré à l’aide de l’authentification unique (SSO) sans avoir à effectuer une intégration avec un fournisseur d’identité (IdP)
• Fournir aux utilisateurs la possibilité de s’authentifier directement depuis votre application externe
• Autoriser par programme l’accès à l’API REST de Tableau (et l’API Metadata depuisTableau Cloud octobre 2023) pour le compte des utilisateurs à l’aide d’un jeton Web JSON (JWT)

Comment fonctionnent les applications connectées

La relation de confiance entre votre site Tableau Cloud et l’application externe est établie et vérifiée via un jeton d’authentification observant la norme JSON Web Token (JWT). Elle utilise un secret partagé fourni par l’application connectée à Tableau et signé par votre application externe.

Composants clés d’une application connectée

Les composants suivants de l’application connectée fonctionnent avec le jeton JWT dans votre application externe pour authentifier les utilisateurs et afficher le contenu intégré.

• Secrets : les secrets sont des clés partagées par Tableau et votre application externe. Ils sont utilisés dans les signatures qui constituent le jeton JWT. Un secret est requis en cas d’utilisation d’applications connectées pour intégrer l’authentification ou l’autorisation API REST. Les secrets peuvent être créés dans une application connectée, n’expirent pas et restent valides jusqu’à leur suppression.
• Liste d’autorisations de domaines (intégrant des workflows uniquement) : vous pouvez spécifier une liste de domaines autorisés dans chaque application connectée. Le contenu Tableau intégré via une application connectée n’est autorisé que dans les domaines spécifiés. Cela permet de garantir que le contenu est exposé sous des domaines sécurisés et approuvés par votre entreprise.
• Niveau d’accès(intégrant des workflows uniquement) : vous pouvez spécifier le contenu à intégrer via une application connectée en associant une application connectée à un projet ou à tous les projets. Si vous spécifiez un projet, seul le contenu du projet sélectionné peut être intégré via l’application connectée. Si vous souhaitez spécifier plusieurs projets, vous devez utiliser l’API REST de Tableau.

Remarque : pour que le jeton de session soit valide, les horloges de l’application externe et du serveur qui héberge l’application externe doivent être définies sur le temps universel coordonné (UTC). Si l’une ou l’autre des horloges utilise une norme différente, l’application connectée ne sera pas approuvée.

Workflow de l’application connectée

Intégration des workflows

Le schéma ci-dessous illustre le fonctionnement de l’authentification entre votre application externe (serveur Web et page Web) et l’application connectée.

1. L’utilisateur visite la page Web : lorsqu’un utilisateur visite le contenu intégré sur une page Web, la page Web envoie une demande GET à votre application externe pour récupérer le code HTML sur cette page Web.
2. L’application externe construit un jeton d’authentification : l’application externe construit un jeton JWT, qui contient un secret de l’application connectée (voir l’étape 3 ci-dessous pour les exigences JWT supplémentaires) et la portée de l’accès utilisateur pour le contenu intégré. Le secret est signé par l’application externe et est utilisé pour vérifier la relation de confiance dans une étape ultérieure.
3. L’application externe répond avec un jeton d’authentification : l’application externe répond à la page avec le jeton JWT dans l’URL du contenu intégré appelée par la page Web.
4. La page Web demande du contenu à Tableau : lors de la tentative de chargement du contenu intégré, la page Web appelle l’URL du contenu intégré, qui envoie une requête GET à Tableau.
5. Tableau valide le jeton : Tableau reçoit le jeton JWT et vérifie la relation de confiance avec l’application externe en identifiant l’application connectée et le secret partagé utilisé dans le jeton JWT. Tableau crée ensuite une session pour l’utilisateur. La session respecte non seulement les étendues d’intégration définies dans le JWT, mais également les restrictions spécifiées dans l’application connectée, y compris les domaines autorisés et les projets autorisés.
6. Tableau renvoie le contenu en fonction du contexte d’intégration restreint : le contenu intégré se charge uniquement lorsque la page se trouve sous un domaine autorisé et que le contenu est publié dans un projet autorisé (le cas échéant). L’utilisateur authentifié ne peut interagir avec le contenu intégré que par la portée définie dans le jeton JWT.

Créer une application connectée

Étape 1 : Créer une application connectée

Créez une application connectée à partir de la page Paramètres de Tableau Cloud.

1. En tant qu’administrateur de site, connectez-vous à Tableau Cloud.

2. Dans le volet de gauche, sélectionnez Paramètres > Applications connectées.

3. Cliquez sur la flèche déroulante du bouton Nouvelle application connectée et sélectionnez Approbation directe.

4. Dans la boîte de dialogue Créer une application connectée, effectuez l’une des opérations suivantes :

   1. Pour les workflows d’autorisation de l’API REST (y compris les workflows de l’API Metadata qui utilisent l’API REST pour l’authentification), dans la zone de texte Nom de l’application connectée, entrez un nom pour l’application connectée et cliquez sur le bouton Créer.

      Remarque : vous pouvez ignorer le Niveau d’accès et la Liste d’autorisations du domaine lors de la configuration d’une application connectée pour l’autorisation de l’API REST et de l’API Metadata.

   2. Pour intégrer des workflows, procédez comme suit :

      1. Dans la zone de texte Nom de l’application connectée, saisissez un nom pour l’application connectée.

      2. Dans le menu déroulant S’applique à, sélectionnez Tous les projets ou Un seul projet pour contrôler les vues ou les métriques pouvant être intégrées. Si vous sélectionnez l’option « Un seul projet », sélectionnez le projet spécifique à cibler. Pour plus d’informations sur ces deux options, consultez Niveau d’accès (intégration des workflows uniquement).

         Remarques : 

         • En octobre 2023 (Tableau 2023.3), la possibilité d’intégrer des métriques a été supprimée de Tableau.
         • En février 2024 (Tableau 2024.1), vous pouvez spécifier plusieurs projets à l’aide de l’API REST de Tableau. Pour plus d’informations, consultez les méthodes Créer une application connectée(Le lien s’ouvre dans une nouvelle fenêtre) et Mettre à jour iune application connectée(Le lien s’ouvre dans une nouvelle fenêtre) dans l’aide de l’API REST.

      3. Dans la liste d’autorisations de domaines, spécifiez les domaines à l’aide des règles décrites dans Formatage de domaine ci-dessous pour contrôler où les vues ou les métriques peuvent être intégrées.

      4. Une fois terminé, cliquez sur le bouton Créer.

         

5. À côté du nom de l’application connectée, cliquez sur le menu Actions et sélectionnez Activer. Pour des raisons de sécurité, une application connectée est désactivée par défaut lors de sa création.

   

6. Notez l’ID de l’application connectée, également appelé ID client, à utiliser à l’étape 3 ci-dessous.

   

Étape 2 : Générer un secret

Vous pouvez générer un total de deux secrets pour chaque application connectée. Le deuxième secret peut être utilisé à des fins de rotation des secrets pour renforcer la protection contre les problèmes si un secret est compromis.

1. Dans la page de détails de l’application connectée que vous avez créée à l’étape 1, cliquez sur le bouton Générer un nouveau secret.

2. Notez l’ID secret et la valeur secrète à utiliser à l’étape 3 ci-dessous.

   

Étape 3 : Configurer le JWT

Après avoir généré un secret, vous souhaitez permettre à votre application personnalisée d’envoyer un jeton JWT valide. JWT est une norme utilisée pour transférer en toute sécurité des informations entre deux parties. Le jeton JWT est signé par votre application externe pour envoyer des informations à Tableau Cloud en toute sécurité. Le JWT référence l’application connectée, l’utilisateur pour lequel la session est générée et le niveau d’accès que l’utilisateur doit avoir.

Un JWT valide comprend les informations suivantes :

• ID d’application connectée, également appelé ID client, à partir de l’étape 1

• ID secret et valeur secrète générés à l’étape 2

• Revendications enregistrées et en-tête :

  Revendication	Nom	Description ou valeur requise
  "kid"	ID secret	Obligatoire (dans l’en-tête). L’identifiant de la clé secrète de l’application connectée.
  "iss"	Émetteur	Obligatoire (dans l’en-tête). URI d’émetteur unique qui identifie l’application de connexion de confiance et sa clé de signature.
  "alg"	Algorithme	Obligatoire (dans l’en-tête). Algorithme de signature JWT. Seul HS256 est pris en charge.
  "sub"	Sujet	Nom d’utilisateur (adresse e-mail) de l’utilisateur Tableau Cloud authentifié.
  "aud"	Public	La valeur doit être : "tableau".
  "exp"	Date d’expiration	Pour être valide, un JWT ne doit pas avoir expiré. Le délai d’expiration du jeton JWT (en UTC) doit être compris dans la période de validité maximale configurée, qui est de 10 minutes.
  "jti"	ID JWT	Obligatoire en tant que réclamation. La demande d’ID JWT fournit un identifiant unique pour le jeton JWT et est sensible à la casse.
  "scp" Important : n’utilisez pas "scope".	Portée	Pour l’intégration de workflows, les valeurs prises en charge incluent : "tableau:views:embed" "tableau:views:embed_authoring" "tableau:metrics:embed" (supprimé en octobre 2023 (Tableau 2023.3)) "tableau:ask_data:embed" (Supprimé en février 2024 (Tableau 2024.1)) Remarques : Les valeurs doivent être transmises sous forme de type de liste. Pour tableau:views:embed et tableau:views:embed_authoring, la portée respecte les autorisations utilisateur déjà configurées dans Tableau Cloud et permet aux utilisateurs d’interagir avec les outils dans la vue intégrée s’ils sont disponibles dans la vue d’origine. Nous recommandons que le code d’intégration exclue le paramètre de la barre d’outils. Pour plus d’informations, consultez Problèmes connus (intégration des workflows uniquement) ci-dessous. Pour les workflows d’autorisation de l’API REST, consultez Méthodes d’API REST prenant en charge l’autorisation JWT. Pour les workflows de l’API Metadata qui utilisent l’API REST pour l’authentification, la seule portée prise en charge est tableau:content:read.
  https://tableau.com/oda	Accès à la demande – revendication (activer la capacité)	Pour intégrer des workflows uniquement. La valeur doit être "true" et un ou plusieurs groupes Tableau Cloud doivent être spécifiés (voir la ligne suivante). Pour plus d’informations, consultez la section Accès à la demande (intégration de workflows uniquement) ci-dessous.
  https://tableau.com/groups	Accès à la demande – revendication (préciser le nom du groupe)	Pour intégrer des workflows uniquement. La valeur doit correspondre au nom d’un ou plusieurs groupes dans Tableau Cloud. Pour plus d’informations, consultez la section Accès à la demande (intégration de workflows uniquement) ci-dessous.
  (Attribut utilisateur)	(Valeurs des attributs utilisateur)	Pour intégrer des workflows uniquement. Vous pouvez inclure des attributs utilisateur dans le JWT. Ensuite, lorsque les fonctions d’attribut utilisateur sont utilisées dans le contenu intégré, Tableau vérifie le contexte de l’utilisateur authentifié et détermine les données qui peuvent être affichées lors de l’exécution. Remarques : Consultez l’aide de l’API d’intégration v3(Le lien s’ouvre dans une nouvelle fenêtre) pour consulter les problèmes connus susceptibles d’affecter votre flux de travail. Pour que l’attribut utilisateur fonctionne, 1) vous devez activer le paramètre Contrôler l’accès des utilisateurs dans les workflows d’authentification et 2) l’auteur du contenu doit créer une fonction d’attribut utilisateur(Le lien s’ouvre dans une nouvelle fenêtre). Les attributs utilisateur sont sensibles à la casse.

Exemples de jetons JWT

Voici des exemples de JWT dans les langages Java et Python. Les exemples Java et Python utilisent la bibliothèque nimbus-jose-jwt et la bibliothèque PyJWT respectivement.

Java

import com.nimbusds.jose.*;
import com.nimbusds.jose.crypto.*;
import com.nimbusds.jwt.*;

import java.util.*;

...

String secret = "secretvalue";
	String kid = "connectedAppSecretId";
	String clientId = "connectedAppClientId";
	List<String> scopes = new
ArrayList<>(Arrays.asList("tableau:views:embed"));
	String username = "user@domain.com";
	JWSSigner signer = new MACSigner(secret);
	JWSHeader header = new
JWSHeader.Builder(JWSAlgorithm.HS256).keyID(kid).customParam("iss", clientId).build();
	JWTClaimsSet claimsSet = new JWTClaimsSet.Builder()
		.issuer(clientId)
		.expirationTime(new Date(new Date().getTime() + 60 * 1000)) //expires in 1 minute
		.jwtID(UUID.randomUUID().toString())
		.audience("tableau")
		.subject("username")
		.claim("scp", scopes)
		.claim("https://tableau.com/oda", "true")
		.claim("https://tableau.com/groups", "Contractors", "Team C")
		.claim("Region", "East")
		.build();
	SignedJWT signedJWT = new SignedJWT(header, claimsSet);
	signedJWT.sign(signer);
	model.addAttribute("token", signedJWT.serialize());

Python

import jwt

token = jwt.encode(
	{
		"iss": connectedAppClientId,
		"exp": datetime.datetime.utcnow() + datetime.timedelta(minutes=5),
		"jti": str(uuid.uuid4()),
		"aud": "tableau",
		"sub": user,
		"scp": ["tableau:views:embed", "tableau:metrics:embed"],
		"https://tableau.com/oda":"true",
		"https://tableau.com/groups": ["Contractors", "Team C"],
		"Region": "East"
	},
		connectedAppSecretKey,
		algorithm = "HS256",
		headers = {
		'kid': connectedAppSecretId,
		'iss': connectedAppClientId
        }
  )

Une fois que vous avez configuré le jeton JWT, lorsque le code est exécuté par votre application externe, il génère un jeton.

Étape 4 : Étapes suivantes

Gérer une application connectée

La page Applications connectées vous permet de gérer toutes les applications connectées pour votre site. Vous pouvez effectuer des tâches telles que créer, supprimer et désactiver des applications connectées, et également révoquer ou générer de nouveaux secrets si des secrets existants ont été compromis.

1. En tant qu’administrateur de site, connectez-vous à Tableau Cloud.

2. Dans le volet de gauche, sélectionnez Paramètres > Applications connectées.

3. Cochez la case en regard de l’application connectée que vous souhaitez gérer et effectuez une ou plusieurs des opérations suivantes :

   • Générez un nouveau secret en fonction du calendrier de rotation spécifié par les politiques de sécurité de votre organisation. Pour générer un secret supplémentaire, cliquez sur le nom de l’application connectée, puis sur le bouton Générer un nouveau secret. Une application connectée peut avoir au maximum deux secrets. Les deux secrets peuvent être actifs en même temps, n’expirent pas et restent valides jusqu’à leur suppression.

   • Passez en revue les détails de l’application connectée en cliquant sur le nom de l’application connectée pour voir quand l’application connectée a été créée, son ID, la portée de projet et de domaine, ainsi que ses secrets.

   • Modifiez la portée ou le domaine du projet, dans le menu Actions, sélectionnez Modifier. Apportez les modifications souhaitées, puis cliquez sur Mettre à jour.

     Remarque : si vous modifiez la portée du projet ou du domaine et que le contenu intégré n’existe ni dans le nouveau projet ni dans le nouveau domaine, la vue ou la métrique intégrée ne peut pa s’afficher et les utilisateurs verront une erreur lors de l’accès au contenu intégré.

   • Pour supprimer un secret, cliquez sur le nom de l’application connectée. Dans la page de l’application connectée, cliquez sur Actions à côté du secret et sélectionnez Supprimer. Dans la boîte de dialogue de confirmation, sélectionnez l’onglet Supprimer.

     Remarque : si le secret de l’application connectée est utilisé par une application externe, la métrique ou la vue intégrée ne peut pas s’afficher une fois le secret supprimé. Pour plus d’informations, voir Effets de la désactivation ou de la suppression d’une application connectée, ou de la suppression d’un secret ci-dessous.

   • Pour désactiver une application connectée, dans le menu Actions, sélectionnez Désactiver. Si l’application connectée est utilisée par une application externe, la métrique ou la vue intégrée ne peut pas s’afficher une fois l’application connectée désactivée. Pour plus d’informations, voir Effets de la désactivation ou de la suppression d’une application connectée, ou de la suppression d’un secret ci-dessous.

   

Effets de la désactivation ou de la suppression d’une application connectée, ou de la suppression d’un secret

Pour afficher un contenu intégré à l’attention de votre utilisateur ou activer l’accès à l’API REST via une application connectée, l’application connectée doit être activée et son secret généré. Si l’application connectée est utilisée dans votre application externe et est désactivée ou supprimée, ou si son secret est supprimé ou remplacé, les utilisateurs recevront une erreur 403.

Pour éviter ce problème, assurez-vous que l’application de connexion est activée et que le JWT utilise l’ID et la valeur de secret corrects.

Règles de liste d’autorisations de domaine (intégration de workflows uniquement)

La liste d’autorisations de domaines de l’application connectée vous permet de restreindre l’accès au contenu Tableau intégré à tous les domaines ou à certains domaines, d’exclure certains domaines ou encore de bloquer tous les domaines.

Options de domaine

Vous pouvez sélectionner l’une des deux options lors de la configuration de la liste d’autorisations de domaines d’une application connectée :

• Tous les domaines : par défaut, cette option permet un accès illimité au contenu intégré.
• Domaines spécifiques uniquement : cette option vous permet de limiter l’accès au contenu intégré. Si vous utilisez cette option, suivez les règles de formatage spécifiées dans la section suivante, Formatage de domaine.

Formatage de domaine

Dans la zone de texte de la liste d’autorisations de domaines, vous pouvez saisir un domaine ou plusieurs domaines sur la base des exemples de formatage ci-dessous.

Remarque : les règles de formatage de domaine s’appliquent également lors de l’utilisation des méthodes Connect App(Le lien s’ouvre dans une nouvelle fenêtre) dans l’API REST de Tableau.

Voici quelques exemples de formatage basés sur des scénarios courants :

Problèmes connus (intégration des workflows uniquement)

Il existe quelques problèmes connus liés à l’utilisation d’applications connectées. Ils seront corrigés dans une future version.

• Fonctionnalités de la barre d’outils : lorsque le paramètre de barre d’outils est défini pour le contenu intégré, les fonctionnalités de la barre d’outils ne fonctionneront pas toutes. Pour contourner ce problème, nous vous recommandons de masquer le paramètre de la barre d’outils comme dans l’exemple ci-dessous.

  <tableau-viz id='tab-viz' src='https://online.tableau.com/t/<your_site>/...'
  	toolbar='hidden'>
  </tableau-viz>

• Sources de données publiées : les sources de données publiées définies sur Inviter l’utilisateur pour les informations d’identification de la base de données ne s’afficheront pas. Pour contourner ce problème, si possible, nous recommandons aux propriétaires de sources de données d’intégrer à la place leurs informations d’identification pour la base de données.

• Objets Parle aux données dans les tableaux de bord intégrés : les objets Parle aux données dans les tableaux de bord intégrés ne se chargent pas. (En février 2024 (Tableau 2024.1), Tableau a supprimé la fonction Parlez aux données.)

• Métriques et listes d’autorisations de domaine : les vues de métriques intégrées s’affichent malgré les restrictions d’accès pouvant être spécifiées dans les listes d’autorisations de domaine des applications connectées. Remarque : les données de métriques accessibles à partir des barres d’outils des vues intégrées fonctionneront comme prévu. En octobre 2023 (Tableau 2023.3), la possibilité d’intégrer des métriques a été supprimée de Tableau.