Help bij Tableau Cloud

Workflow van verbonden app

Workflows insluiten

Het onderstaande diagram laat zien hoe verificatie tussen uw externe toepassing (webserver en webpagina) en de met Tableau verbonden app werkt.

1. Gebruiker bezoekt de webpagina: wanneer een gebruiker de ingesloten inhoud op een webpagina bezoekt, stuurt de webpagina een GET-verzoek naar uw externe toepassing om de HTML op die webpagina op te halen.
2. Externe toepassing construeert een verificatietoken: de externe toepassing construeert een JWT die een geheim van de verbonden app bevat (zie stap 3 hieronder voor aanvullende JWT-vereisten) en de scope van gebruikerstoegang voor de ingesloten inhoud. Het geheim wordt ondertekend door de externe toepassing en wordt in een latere stap gebruikt voor verificatie van de vertrouwensrelatie.
3. Externe toepassing reageert met verificatietoken: de externe toepassing reageert op de pagina met de JWT in de URL van de ingesloten inhoud die door de webpagina wordt aangeroepen.
4. Webpagina vraagt om inhoud van Tableau: bij de poging om de ingesloten inhoud te laden roept de webpagina de URL van de ingesloten inhoud aan, die een GET-verzoek naar Tableau verzendt.
5. Tableau valideert de token: Tableau ontvangt de JWT en verifieert de vertrouwensrelatie met de externe toepassing door de verbonden app en het gedeelde geheim te identificeren dat in de JWT wordt gebruikt. Vervolgens maakt Tableau een sessie voor de gebruiker. De sessie houdt niet alleen rekening met de insluitingsscopes die in de JWT zijn gedefinieerd, maar ook met de beperkingen die in de verbonden app zijn opgegeven, inclusief de geaccepteerde domeinen en projecten.
6. Tableau retourneert de inhoud op basis van de beperkte insluitingscontext: de ingesloten inhoud wordt alleen geladen als de pagina zich onder een geaccepteerd domein bevindt en de inhoud naar een geaccepteerd project wordt gepubliceerd (indien van toepassing). De geverifieerde gebruiker kan alleen communiceren met de ingesloten inhoud binnen de scope die in de JWT is gedefinieerd.

Een verbonden app maken

Stap 1: Maak een verbonden app

Maak een verbonden app van de instellingenpagina van Tableau Cloud.

1. Meld u als sitebeheerder aan bij Tableau Cloud.

2. Selecteer in het linkerdeelvenster Instellingen > Verbonden apps.

3. Klik op de vervolgkeuzepijl van de knop Nieuwe verbonden app en selecteer Directe vertrouwensrelatie.

4. In het dialoogvenster Verbonden app maken doet u dat een van de volgende dingen:

   • Voor REST API-autorisatieworkflows (inclusief Metadata API-workflows die de REST API gebruiken voor verificatie) voert u in het tekstvak Naam van verbonden app een naam voor de verbonden app in en klikt u op de knop Maken.

     Opmerking: u kunt bij het configureren van een verbonden app voor REST API- en Tableau-metadata-API-autorisatie de opties Toegangsniveau en Toelatingslijst van domeinen negeren.

   • Voor workflows insluiten doet u het volgende:

     1. Voer in het tekstvak Naam van verbonden app een naam voor de verbonden app in.

     2. Selecteer in het vervolgkeuzemenu Van toepassing op de optie Alle projecten of Slechts één project om te bepalen welke weergaven of statistieken kunnen worden ingesloten. Als u de optie Slechts één project selecteert, selecteert u het specifieke project waarop u zich wilt richten. Zie Toegangsniveau (alleen workflows insluiten) voor meer informatie over deze twee opties.

        Opmerkingen: 

        • In oktober 2023 (Tableau 2023.3) heeft Tableau de mogelijkheid om statistieken in te sluiten buiten gebruik gesteld.
        • In februari 2024 (Tableau 2024.1) kunt u meerdere projecten opgeven met behulp van de Tableau REST API. Zie de methoden Verbonden app maken(Link wordt in een nieuw venster geopend) en Verbonden app bijwerken(Link wordt in een nieuw venster geopend) methoden in de REST API Help voor meer informatie.

     3. Geef op de toelatingslijst van domeinen de domeinen op met behulp van de regels die worden beschreven in Domeinnotatie hieronder om te bepalen waar weergaven of statistieken kunnen worden ingesloten.

        Belangrijk: we raden u aan de toelatingslijst van domeinen te gebruiken als best practice voor beveiliging om ervoor te zorgen dat Tableau-inhoud alleen wordt ingesloten op locaties die u toestaat.

     4. Wanneer u klaar bent, klikt u op de knop Maken.

        

5. Klik naast de naam van de verbonden app op het menu Actie en selecteer Inschakelen. Om veiligheidsredenen wordt een verbonden app bij het maken standaard uitgeschakeld.

   

6. Noteer de ID van de verbonden app, ook wel de client-ID genoemd, zodat u deze in stap 3 hieronder kunt gebruiken.

   

Stap 2: Genereer een geheim

U kunt voor elke verbonden app in totaal twee geheimen genereren. Het tweede geheim kan worden gebruikt voor geheime rotatiedoeleinden ter bescherming tegen problemen als een geheim bekend is geworden.

1. Klik op de detailpagina van de verbonden app die u in stap 1 hebt gemaakt, op de knop Nieuw geheim genereren.

2. Noteer de geheim-ID en de geheime waarde die u in stap 3 hieronder moet gebruiken.

   

Stap 3: Configureer de JWT

Nadat u een geheim hebt gegenereerd, wilt u ervoor zorgen dat uw externe toepassing een geldige JWT kan verzenden. JWT is een standaard die wordt gebruikt om informatie tussen twee partijen veilig over te dragen. De JWT wordt ondertekend door uw externe toepassing om veilig informatie naar Tableau Cloud te verzenden. De JWT verwijst naar de verbonden app, de gebruiker voor wie de sessie wordt gegenereerd en het toegangsniveau dat de gebruiker nodig heeft.

Een geldige JWT bevat de volgende informatie:

• ID van de verbonden app, ook wel de client-ID genoemd, uit stap 1

• Geheim-ID en geheime waarde gegenereerd in stap 2

• Geregistreerde claims en header:

  Claim	Naam	Beschrijving of vereiste waarde
  kid	Geheim-ID	Vereist (in header). De sleutel-ID van het geheim van de verbonden app.
  iss	Uitgever	Vereist (in header). Unieke uitgever-URI die de vertrouwde verbonden app en de ondertekeningssleutel identificeert.
  alg	Algoritme	Vereist (in header). JWT-ondertekeningsalgoritme. Alleen HS256 wordt ondersteund.
  sub	Onderwerp	Gebruikersnaam (e-mailadres) van de geverifieerde Tableau Cloud-gebruiker.
  aud	Doelgroep	Waarde moet zijn: tableau.
  exp	Vervaltijd	Een geldige JWT mag niet vervallen zijn. De vervaltijd (in UTC) van de JWT moet binnen de maximale geldigheidsduur liggen, namelijk 10 minuten.
  jti	JWT-ID	Vereist als claim. De JWT-ID-claim biedt een unieke ID voor de JWT en is hoofdlettergevoelig.
  scp Belangrijk: gebruik niet scope.	Scope	Voor workflows insluiten zijn de ondersteunde waarden onder meer: tableau:views:embed tableau:views:embed_authoring tableau:metrics:embed (buiten gebruik gesteld in oktober 2023 (Tableau 2023.3)) tableau:ask_data:embed(buiten gebruik gesteld in februari 2024 (Tableau 2024.1)) Opmerkingen: Waarden moeten worden doorgegeven als lijsttype. Voor tableau:views:embed en tableau:views:embed_authoring houdt de scope rekening met de gebruikersmachtigingen die al in Tableau Cloud zijn geconfigureerd, en stelt gebruikers in staat om te communiceren met de tools in de ingesloten weergave, mits beschikbaar in de oorspronkelijke weergave. We raden aan dat de insluitcode de werkbalkparameter uitsluit. Zie Bekende problemen (alleen workflows insluiten) hieronder voor meer informatie. Zie REST API-autorisatieworkflows voor REST API-methoden die JWT-autorisatie ondersteunen. Voor Metadata-API-workflows die de REST API voor verificatie gebruiken is de enige ondersteunde scope tableau:content:read.
  https://tableau.com/oda	On-demand toegang - claim (mogelijkheid inschakelen)	Alleen voor workflows insluiten. De waarde moet true zijn en er moeten een of meer Tableau Cloud-groepen worden opgegeven (zie volgende regel). Zie de sectie On-demand toegang (alleen workflows insluiten) hieronder voor meer informatie.
  https://tableau.com/groups	On-demand toegang - claim (groepsnaam opgeven)	Alleen voor workflows insluiten. De waarde moet overeenkomen met de naam van een of meer groepen in Tableau Cloud. Zie de sectie On-demand toegang (alleen workflows insluiten) hieronder voor meer informatie.
  		Alleen voor workflows insluiten. De waarde moet overeenkomen met de naam van een of meer groepen in Tableau Cloud. Zie de sectie Dynamisch groepslidmaatschap (alleen workflows insluiten) hieronder voor meer informatie.
  (Gebruikerskenmerk)	(Gebruikersgedefinieerde waarden)	Alleen voor workflows insluiten. U kunt gebruikerskenmerken in de JWT opnemen. Wanneer functies voor gebruikerskenmerken vervolgens worden gebruikt in ingesloten inhoud, controleert Tableau de context van de geverifieerde gebruiker en bepaalt welke data tijdens runtime kunnen worden weergegeven. Opmerkingen: Raadpleeg de Help van Embedding API v3(Link wordt in een nieuw venster geopend) voor bekende problemen die van invloed kunnen zijn op de workflow. Het gebruikerskenmerk werkt alleen als 1) u de instelling Gebruikerstoegang beheren in verificatieworkflows inschakelt en 2) de auteur van de inhoud een gebruikerskenmerkfunctie(Link wordt in een nieuw venster geopend) maakt. Gebruikerskenmerken zijn hoofdlettergevoelig.

Voorbeelden van JWT's

Hier zijn voorbeelden van JWT's in zowel Java als Python. De Java- en Python-voorbeelden maken gebruik van respectievelijk de nimbus-jose-jwt-bibliotheek en de PyJWT-bibliotheek.

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", "Group1", "Group2")
		.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", "Group1", "Group2"],
		"Region": "East"
	},
		connectedAppSecretKey,
		algorithm = "HS256",
		headers = {
		'kid': connectedAppSecretId,
		'iss': connectedAppClientId
        }
  )

Nadat u de JWT hebt geconfigureerd en de code door uw externe toepassing wordt uitgevoerd, genereert deze een token.

Stap 4: Volgende stappen

Een verbonden app beheren

Op de pagina Verbonden apps kunt u alle verbonden apps voor uw site beheren. U kunt taken uitvoeren zoals het maken, verwijderen en uitschakelen van verbonden apps; en het intrekken of genereren van nieuwe geheimen als bestaande geheimen bekend zijn geworden.

1. Meld u als sitebeheerder aan bij Tableau Cloud.

2. Selecteer in het linkerdeelvenster Instellingen > Verbonden apps.

3. Schakel het selectievakje in naast de verbonden app die u wilt beheren en voer een of meer van de volgende handelingen uit:

   • Nieuw geheim genereren volgens de rotatietijdlijn die is gespecificeerd in het beveiligingsbeleid van uw organisatie. Om een extra geheim te genereren klikt u op de naam van de verbonden app en vervolgens op de knop Nieuw geheim genereren. Een verbonden app kan maximaal twee geheimen hebben. Beide geheimen kunnen tegelijkertijd actief zijn, verlopen niet en blijven geldig totdat ze worden verwijderd.

   • Details van verbonden app bekijken door op de naam van de verbonden app te klikken om te zien wanneer de verbonden app is gemaakt, en wat de ID, de scope van het project en het domein en de geheimen van de app zijn.

   • Projectscope of het domein wijzigen, selecteer in het menu Acties de optie Bewerking. Breng uw wijzigingen aan en klik op Update.

     Opmerking: als u de scope van het project of domein wijzigt en de ingesloten inhoud in het nieuwe project of nieuwe domein niet bestaat, kan de ingesloten weergave of statistiek niet meer worden weergegeven en krijgen gebruikers bij het openen van de ingesloten inhoud een foutmelding te zien.

   • Geheim verwijderen door op de naam van de verbonden app te klikken. Klik op de pagina van de verbonden app op Acties naast het geheim en selecteer Verwijderen. Selecteer in het bevestigingsdialoogvenster opnieuw Verwijderen.

     Opmerking: als het geheim van de verbonden app wordt gebruikt door een externe toepassing, kan de ingesloten weergave of statistiek niet meer worden weergegeven nadat het geheim is verwijderd. Zie Effecten van het uitschakelen of verwijderen van een verbonden app of het verwijderen van een geheim hieronder voor meer informatie.

   • Verbonden app uitschakelen, selecteer in het menu Acties de optie Uitschakelen. Als de verbonden app wordt gebruikt door een externe toepassing, kan de ingesloten weergave of statistiek niet meer worden weergegeven nadat de verbonden app is verwijderd. Zie Effecten van het uitschakelen of verwijderen van een verbonden app of het verwijderen van een geheim hieronder voor meer informatie.

   

Effecten van het uitschakelen of verwijderen van een verbonden app of het verwijderen van een geheim

Als u ingesloten inhoud voor uw gebruikers wilt weergeven of REST API-toegang wilt inschakelen via een verbonden app, moet de verbonden app zijn ingeschakeld en moet het geheim zijn gegenereerd. Als de verbonden app in uw externe toepassing wordt gebruikt en wordt uitgeschakeld of verwijderd, of als het geheim wordt verwijderd of vervangen, krijgen gebruikers foutmelding 403.

Om dit probleem te voorkomen moet u ervoor zorgen dat de verbonden app is ingeschakeld en dat de JWT de juiste geheim-ID en waarde gebruikt.

Regels voor de toelatingslijst van domeinen (alleen workflows insluiten)

Met de toelatingslijst van domeinen van de verbonden app kunt u de toegang tot ingesloten Tableau-inhoud beperken tot alle domeinen of sommige domeinen; of u kunt sommige domeinen uitsluiten of alle domeinen blokkeren.

Belangrijk: we raden u aan de toelatingslijst van domeinen te gebruiken als best practice voor beveiliging om ervoor te zorgen dat Tableau-inhoud alleen wordt ingesloten op locaties die u toestaat.

Domeinopties

Bij het configureren van de toelatingslijst van domeinen van een verbonden app kunt u een van deze twee opties selecteren:

• Alle domeinen: als standaardoptie maakt deze optie onbeperkte toegang tot ingesloten inhoud mogelijk.
• Alleen specifieke domeinen: met deze optie kunt u de toegang tot ingesloten inhoud beperken. Als u deze optie gebruikt, volgt u de opmaakregels die zijn gespecificeerd in de volgende sectie: Domeinnotatie.

Domeinnotatie

In het tekstvak voor de toelatingslijst van domeinen kunt u een of meer domeinen invoeren met behulp van de onderstaande notatievoorbeelden.

Opmerking: regels voor domeinnotatie gelden ook bij gebruik van de Connect App-methoden(Link wordt in een nieuw venster geopend) in de Tableau REST API.

Hier ziet u een aantal notatievoorbeelden op basis van veelvoorkomende scenario's:

Bekende problemen (alleen workflows insluiten)

Er zijn een aantal bekende problemen bij het gebruik van verbonden apps die in een toekomstige release zullen worden aangepakt.

• Functies van de werkbalk: Als bij ingesloten inhoud de werkbalkparameter is gedefinieerd, werken niet alle werkbalkfuncties. Om dit probleem te omzeilen, raden we u aan de werkbalkparameter te verbergen, zoals in het onderstaande voorbeeld.

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

• Gepubliceerde databronnen: Gepubliceerde databronnen die voor databasereferenties zijn ingesteld op Gebruiker vragen, worden niet weergegeven. Om dit probleem te omzeilen, raden we eigenaren van databronnen aan om in plaats daarvan hun databasereferenties in te sluiten.

• Data opvragen-objecten in ingesloten dashboards: Data opvragen-objecten in ingesloten dashboards wordt niet geladen. (In februari 2024 (Tableau 2024.1) heeft Tableau de optie Data opvragen buiten gebruik gesteld.)

• Statistieken en toelatingslijst van domeinen: Ingesloten weergaven van statistieken worden weergegeven ondanks toegangsbeperkingen die mogelijk zijn opgegeven in de acceptatielijsten van domeinen van de verbonden apps. Opmerking: Statistieken die toegankelijk zijn via werkbalken van ingesloten weergaven zullen normaal werken. (In oktober 2023 (Tableau 2023.3) heeft Tableau de mogelijkheid om statistieken in te sluiten buiten gebruik gesteld.)

Problemen oplossen

Raadpleeg Problemen met verbonden apps oplossen – Directe vertrouwensrelatie in geval van fouten die mogelijk verband houden met de verbonden app. U vindt er ook voorgestelde stappen voor probleemoplossing.