Aide de Tableau Server sur Windows

Flux de travail de l’application connectée

Intégration des flux de travail

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 à Tableau.

1. L’utilisateur visite la page Web : lorsqu’un utilisateur visite le contenu intégré sur une page Web, la page Web envoie une requête 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 la vérification de 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 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 Server.

1. En tant qu’administrateur de serveur, connectez-vous à Tableau Server.

2. Dans le volet 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 Confiance directe.

   Remarque : Si vous utilisez Tableau Server 2023.3 ou une version antérieure, cliquez sur le bouton Nouvelle application connectée.

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

   • Pour les flux de travail d’autorisation API REST (y compris les flux de travail qui utilisent l’API REST pour l’authentification), dans la zone de texte Nom de l’application connectée, saisissez 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 de domaines lors de la configuration d’une application connectée pour l’autorisation métadonnées API REST et API de métadonnées.

   • Pour l’intégration des flux de travail, 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 mesures 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 flux de travail uniquement).

        Remarques : 

        • Dans Tableau Serveur 2023.3, Tableau a retiré la possibilité d’intégrer des métriques.
        • À partir de Tableau Server 2024.2, vous pouvez spécifier plusieurs projets à l’aide de l’interface API REST de Tableau. Pour plus d’informations, consultez les méthodes de Création d’une application connectée(Le lien s’ouvre dans une nouvelle fenêtre) et de Mise à jour de l’application connectée(Le lien s’ouvre dans une nouvelle fenêtre) dans l’aide de l’interface 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.

        Important : Nous vous recommandons d’utiliser la liste d’autorisations de domaines comme bonne pratique de sécurité pour garantir que le contenu Tableau est intégré uniquement aux emplacements que vous autorisez.

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

        

5. À côté du nom des applications connectées, 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 jeton JWT

Après avoir généré un secret, vous souhaitez permettre à votre application externe d’envoyer un jeton JWT valide. JWT est une norme utilisée pour transférer en toute sécurité des renseignements entre deux parties. Le JWT est signé par votre application externe pour envoyer en toute sécurité des renseignements à Tableau Server. 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 inclut les renseignements suivants :

• 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	Requis (dans l’en-tête) L’identifiant de la clé secrète de l’application connectée.
  "iss"	Émetteur	Requis (dans l’en-tête) URI d’émetteur unique qui identifie l’application de connexion de confiance et sa clé de signature.
  "alg"	Algorithme	Requis (dans l’en-tête) Algorithme de signature JWT. Seul HS256 est pris en charge.
  "sub"	Objet	Nom d’utilisateur de l’utilisateur Tableau Server authentifié.
  "aud"	Public	La valeur doit être : "tableau".
  "exp"	Heure d’expiration	Pour être valide, un jeton JWT ne doit pas avoir expiré. Le délai d’expiration (en UTC) du jeton JWT doit être compris dans la période de validité maximale configurée. La période de validité maximale peut être configurée à l’aide de la commande tsm vizportal.oauth.connected_apps.max_expiration_period_in_minutes.
  "jti"	Identifiant JWT	Obligatoire sous forme de revendication. La revendication d’ID JWT fournit un identifiant unique pour le jeton JWT et est sensible à la casse.
  "scp" Important : N’utilisez pas "scope ".	Étendue	Pour l’intégration des flux de travail, les valeurs prises en charge incluent : « tableau:views:embed » "tableau:views:embed_authoring" Ajouté dans Tableau Server 2022.3 "tableau:metrics:embed" (Retiré de Tableau Server 2023.3) "tableau:ask_data:embed" (Ajouté dans Tableau Server 2023.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 des utilisateurs déjà configurées dans Tableau Server 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 flux de travail uniquement) ci-dessous. Pour les flux de travail d’autorisations API REST , consultez Méthodes d’API REST prenant en charge l’autorisation JWT. Pour les flux de travail de l’API de métadonnées qui utilisent l’API REST pour l’authentification, la seule étendue prise en charge est tableau:content:read.
  https://tableau.com/groups		Pour l’intégration des flux de travail uniquement. La valeur doit correspondre au nom d’un ou de plusieurs groupes dans Tableau Server. Pour plus d’informations, consultez la section Contrôle dynamique des membres de groupes (intégration des flux de travail uniquement) ci-dessous.

Exemples de jetons JWT

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

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 = "username";
	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)
		
		
		.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"]
		
	},
		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 serveur, connectez-vous à Tableau Server.

2. Dans le volet 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 stratégies de sécurité de votre entreprise. Pour générer un secret supplémentaire, cliquez sur le nom de l’application connectée, puis cliquez 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 pas 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 à nouveau l’onglet Supprimer.

     Remarque : si le secret de l’application connectée est utilisé par une application externe, la vue ou la métrique intégrée ne peut pas s’afficher une fois le secret supprimé. Pour plus d’informations, consultez 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 vue ou la mesure intégrée ne peut pas s’afficher une fois l’application connectée désactivée. Pour plus d’informations, consultez 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 rendre le contenu intégré visible par votre utilisateur ou activer l’accès API REST par le biais d’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 jeton JWT utilise l’ID et la valeur de secret corrects.

Règles de liste d’autorisations de domaines (intégration de flux de travail 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.

Important : Nous vous recommandons d’utiliser la liste d’autorisations de domaines comme bonne pratique de sécurité pour garantir que le contenu Tableau est intégré uniquement aux emplacements que vous autorisez.

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 des domaines autorisés, vous pouvez saisir un ou plusieurs domaines en utilisant les 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 flux de travail uniquement)

Il existe quelques problèmes connus à l’utilisation des 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://<your_server>/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.

• Vues intégrées sur plusieurs sites : Dans Tableau Server 2023.1 et versions antérieures, le passage d’une vue à l’autre sur différents sites dans le même navigateur provoque l’erreur 1008 : Impossible de récupérer le secret de l’application connectée. Pour contourner ce problème, effectuez une mise à niveau vers Tableau Server 2023.3 ou vers une version ultérieure.

• Objets Parlez aux données dans les tableaux de bord intégrés : les objets Parlez aux données dans les tableaux de bord intégrés ne se chargent pas. (En Ask Data sera retiré de Tableau Server 2024.2)

• Métriques et listes d’autorisations de domaine : les vues de métriques intégrées s’afficheront 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 Tableau Serveur 2023.3, Tableau a retiré la possibilité d’intégrer des métriques.)

Résolution des problèmes

Vous pouvez consulter la section Résoudre les problèmes liés aux applications connectées - Confiance directe pour connaître les erreurs pouvant être associées à l’application connectée et les étapes de dépannage suggérées.