--- schema_version: "1" id: cedd75160aece71d3a7efd396bd9d84621cdef7d5c75b564432598dcb74df733 title: Toegangsbereiken voor verbonden apps collection: tableau version: next locale: nl-nl portal_url: https://docs.salesforce.com/tableau/next/nl-nl/server-linux/connected_apps_scopes.md canonical_url: https://help.tableau.com/v0.0/server-linux/nl-nl/connected_apps_scopes.htm source_site: help.tableau.com content_type: documentation content_hash: 18f23ec06f3333ed3ecfc41c9dffe8f937ea60c42bc30f511f5d9ef8481c03b1 description: Reference of access scopes that authorize REST API methods for connected apps via JWT. --- [Doorgaan naar hoofdinhoud](#main-content) # Toegangsbereiken voor verbonden apps Vanaf Tableau Server versie 2022.3 kunt u met behulp van met Tableau verbonden apps de Tableau REST API via uw aangepaste toepassing programmatisch aanroepen en openen namens Tableau Server\-gebruikers. Toegang tot de REST API wordt mogelijk gemaakt door een JSON Web Token (JWT) die is gedefinieerd als onderdeel van de initiële aanmeldingsaanvraag. De JWT moet scopes bevatten die de REST API-methoden definiëren die via de verbonden app beschikbaar zijn voor uw aangepaste toepassing en de gebruikers. Autoriseer toegang tot de REST API met behulp van verbonden apps om het volgende te doen: - Beveiliging verbeteren: het gebruik van een JWT als dragertoken is inherent veiliger dan het opslaan en beheren van beheerderswachtwoorden via ENV-bestanden in vaults - Efficiëntie verbeteren: het gebruik van een JWT als dragertoken maakt een vereenvoudigde imitatie van identiteit mogelijk met één verzoek aan het aanmeldingseindpunt in plaats van twee verzoeken - Complexe Tableau-integraties en back-endquery's uitbreiden en automatiseren, zoals het dynamisch ophalen van inhoud en geavanceerde filters ## Acties van scopes Verbonden apps gebruiken scopes die toegang verlenen tot inhoud of beheeracties via de [REST API-methoden die JWT-autorisatie ondersteunen](#scopes) (zie onder). Een scope is een door dubbele punten gescheiden tekenreeks die begint met de naamruimte `tableau`, gevolgd door de Tableau-resource waartoe toegang wordt verleend, zoals `datasources`, en eindigt met de actie die is toegestaan op de resource, zoals `update`. De acties die een scope kan ondernemen zijn onder meer: - `create` - `read` - `run` - `update` - `download` - `delete` Een scope waarmee uw aangepaste toepassing de methode [Databron bijwerken](https://help.tableau.com/current/api/rest_api/nl-nl/REST/rest_api_ref_data_sources.htm#update_data_source) kan aanroepen, ziet er bijvoorbeeld als volgt uit: `tableau:datasources:update` ## Typen scopes Het type scope dat u gebruikt, is afhankelijk van de inhoud of beheeractie die u wilt inschakelen. Scopes vallen over het algemeen onder een van de volgende typen: inhoud lezen, individueel, jokerteken en cross-category. - **Scope Inhoud lezen:** Met de scope voor inhoud lezen, `tableau:content:read`, zijn ondersteunde GET-methoden voor Tableau-inhoud mogelijk. Wanneer u deze scope gebruikt, schakelt u acties in voor alle REST API-categorieën. Met deze scope schakelt u met name GET-methoden in voor databronnen, statistieken, weergaven, werkmappen, projecten en sites. Vanaf Tableau Server 2023.3 geeft u deze scope ook op in een JWT die wordt gebruikt om een referentietoken te maken voor gebruik met de [Metadata-API](https://help.tableau.com/current/api/metadata_api/nl-nl/docs/meta_api_auth.html). Vanaf Tableau Server 2025.1 geeft u deze scope ook op in een JWT dat wordt gebruikt om een referentietoken te maken voor gebruik met de [VizQL Data Service](https://help.tableau.com/current/api/vizql-data-service/nl-nl/index.html). **Opmerking:** als u GET-methoden wilt inschakelen voor beheeracties, zoals gebruikers en groepen, kunt u hun individuele scopes gebruiken. - **Individuele scopes:** als u ondersteunde inhoud en beheeracties wilt inschakelen, kunt u hun individuele scopes gebruiken. Een individuele scope is doorgaans gekoppeld aan één methode en REST API-categorie. Voorbeelden: - Als u het publiceren of bijwerken van een databronactie mogelijk wilt maken, kunt u respectievelijk de individuele `tableau:datasources:create` of `tableau:datasources:update`\-scope gebruiken. - Voor beheeracties zoals het toevoegen of verwijderen van gebruikers kunt respectievelijk de individuele `tableau:users:create` of `tableau:users:delete`\-scope gebruiken. **Opmerking:** er zijn een paar individuele scopes die acties in REST API-categorieën kunnen inschakelen. Zo maakt `tableau:views:download` acties mogelijk in de REST API-categorieën voor weergavedata en werkmappen. - **[Jokerteken (\*)-scopes:](#wildcard)** voor bepaalde scopes kunt u de actie vervangen door het jokerteken (\*) om ondersteunde acties binnen een specifieke REST API-categorie in te schakelen. Voorbeelden: - U kunt gebruikmaken van de `tableau:projects:*`\-jokertekenscope om de acties voor maken, verwijderen en bijwerken in de REST API-projectcategorie in te schakelen. - U kunt gebruikmaken van de `tableau:users:*`\-jokertekenscope om de acties voor ophalen/opsommen, toevoegen, verwijderen en bijwerken in de REST API-gebruikerscategorie in te schakelen. - U kunt gebruikmaken van de `tableau:tasks:*`\-jokertekenscope om de acties voor ophalen/opsommen, toevoegen, verwijderen, bijwerken en uitvoeren in de REST API-categorieën voor extraheren en abonnementen in te schakelen. Bovendien maakt deze scope het bijwerken van de databron (indien een extract) en de werkmap mogelijk. - **[Cross-category scopes:](#cross)** Naast de scope voor inhoud lezen zijn er nog een paar scopes die, indien gebruikt, ondersteunde acties in verschillende REST API-categorieën mogelijk maken. Voorbeelden: - Als u gebruikmaakt van de scope `tableau:tasks:run`, schakelt u acties in de REST API-categorieën van databronnen en werkmappen in. - Als u de scope `tableau:views:download` gebruikt, schakelt u acties in de REST API-categorieën voor weergavedata en werkmappen in. - Als u machtigingsscopes gebruikt zoals `tableau:permissions:update` of `tableau:permissions:delete`, schakelt u acties in de REST API-categorieën van databronnen, werkmappen en projecten in. ## Samenvatting van de autorisatie van REST API-toegang De volgende lijst is een overzicht van de stappen om toegang tot de REST API aan te vragen via een JWT: 1. **Verbonden app maken** met een van de volgende methoden: - [Verbonden apps configureren met directe vertrouwensrelatie](https://help.tableau.com/v0.0/server-linux/nl-nl/connected_apps_direct.htm) - [Verbonden apps configureren met OAuth 2.0-vertrouwensrelatie](https://help.tableau.com/v0.0/server-linux/nl-nl/connected_apps_eas.htm) 2. **Geldige JWT genereren**— tijdens runtime genereert uw aangepaste toepassing een geldige JWT, geconfigureerd met de scopes die u hebt opgenomen 3. **[Aanmeldings](https://help.tableau.com/current/api/rest_api/nl-nl/REST/rest_api_ref_authentication.htm#sign_in)verzoek maken**—uw aangepaste toepassing verzendt met behulp van de JWT een aanmeldingsverzoek om een Tableau-referentietoken en site-ID (LUID) te retourneren 4. **Tableau-toegangstoken bij achtereenvolgende verzoeken gebruiken**—gebruik bij achtereenvolgende REST API-aanroepen 1) de Tableau-referentietoken als de headerwaarde [`X-Tableau-Auth`](https://help.tableau.com/current/api/rest_api/nl-nl/REST/rest_api_concepts_auth.htm#using_auth_token) en 2) de site-ID (LUID) in de aanvraag-URI ### Voorbeeld Stel dat u een verbonden app maakt met behulp van een directe vertrouwensrelatie. Met een directe vertrouwensrelatie genereert uw aangepaste toepassing die de REST API aanroept, een geldige JWT met de client-ID en het clientgeheim die door de verbonden app zijn gegenereerd. **Scopes in de JWT** Om toegang tot de REST API succesvol te autoriseren moet de JWT ook de scopes bevatten die de REST API-mogelijkheden definiëren. Als u bijvoorbeeld verschillende databrongerelateerde methoden wilt inschakelen, kunt u de volgende scopes in de JWT opnemen: `"tableau:content:read","tableau:datasources:create","tableau:datasources:update","tableau:datasources:download","tableau:tasks:run"` of `"tableau:content:read","tableau:datasources:*","tableau:tasks:run"` **Opmerking:** scopewaarden moeten worden doorgegeven als lijsttype. **URI voor aanmeldingsverzoek** Om de REST API aan te roepen moet uw aangepaste toepassing eerst een aanmeldingsverzoek verzenden om een Tableau-referentietoken te genereren. ``` POST https://myco/api/3.17/auth/signin ``` **Hoofdtekst aanvragen** Om REST API-toegang met een JWT te autoriseren moet de hoofdtekst van het aanmeldingsverzoek de geldige JWT bevatten, zoals in het onderstaande voorbeeld. ``` ``` **Tekst van reactie** Het aanmeldingsverzoek levert de volgende hoofdtekst op, die de Tableau-referentietoken bevat. ``` ``` Nadat de Tableau-referentietoken is gegenereerd, voegt u deze toe aan de koptekst van alle volgende REST API-aanvragen. **Koptekst** X-Tableau-Auth:12ab34cd56ef78ab90cd12ef34ab56cd Alle volgende REST API-verzoeken die gebruik maken van de Tableau-toegangstoken, worden vervolgens begrensd door de scopes in de JWT. ## REST API-methoden die JWT-autorisatie ondersteunen Scopes voor verbonden apps verlenen uw aangepaste toepassing toegang tot de Tableau REST API-mogelijkheden namens gebruikers. ### Scopes vinden De vereiste scope voor een JWT-ondersteunde methode vindt u in het eigenschappenblok ervan in de Help voor de [Tableau REST API](https://help.tableau.com/current/api/rest_api/nl-nl/REST/rest_api.htm). Als een scope niet is opgenomen in het eigenschappenblok van de methode, kan toegang tot die methode niet worden beheerd door een JWT. Een bereik waarmee u de methode [Query uitvoeren op sites](https://help.tableau.com/current/api/rest_api/nl-nl/REST/rest_api_ref_site.htm#query_site) in de Tableau REST API kunt aanroepen is bijvoorbeeld. `tableau:sites:read` **Opmerkingen:** - Zowel de methode [Aanmelden](https://help.tableau.com/current/api/rest_api/nl-nl/REST/rest_api_ref_authentication.htm#sign_in) als [Afmelden](https://help.tableau.com/current/api/rest_api/nl-nl/REST/rest_api_ref_authentication.htm#sign_out) worden door JWT-autorisatie ondersteund, maar vereisen vanaf Tableau Server 2023.3 geen scope. - Zie een van de volgende onderwerpen voor scopes die worden ondersteund door de Embedding API v3: - [Verbonden apps configureren met directe vertrouwensrelatie](https://help.tableau.com/v0.0/server-linux/nl-nl/connected_apps_direct.htm) - [Verbonden apps configureren met OAuth 2.0-vertrouwensrelatie](https://help.tableau.com/v0.0/server-linux/nl-nl/connected_apps_eas.htm) - Vanaf Tableau Server 2025.3 ondersteunt een subset van vermelde scopes ook REST API-verificatie via uniforme toegangstokens (UAT's). Dit betekent dat verbonden apps en UAT-scopes hetzelfde zijn. ### Typen scopes #### Over jokerteken (\*)-scopes Jokertekenscopes maken gebruik van het jokerteken (\*) in plaats van een specifieke actie om meerdere ondersteunde acties binnen een specifieke Tableau REST API-categorie in te schakelen. #### Voorbeelden
ScopeIngeschakelde methoden
tableau:datasources:*Hiermee kunnen databronmethoden worden gemaakt en bijgewerkt en kan de verbinding worden bijgewerkt.
tableau:metrics:*Hiermee kan een query worden uitgevoerd op acties voor statistieken, en kunnen deze acties worden bijgewerkt en verwijderd.
tableau:workbooks:*Hiermee kunnen acties voor afbeeldingswerkmappen worden gepubliceerd, bijgewerkt, gedownload en vooraf worden bekeken.
tableau:groups:*Hiermee kunnen groepsacties worden gemaakt, bijgewerkt en verwijderd en kan er een query op worden uitgevoerd.
tableau:projects:*Hiermee kunnen projectmethoden worden gemaakt, verwijderd en bijgewerkt.
tableau:users:*Hiermee kunnen gebruikersmethoden worden opgehaald/in een lijst weergegeven, toegevoegd, verwijderd en bijgewerkt.
tableau:tasks:*

Opmerking: deze scope is ook cross-category.

Hiermee kunnen methoden voor extracten en abonnementstaken worden opgehaald/in een lijst weergegeven, toegevoegd, bijgewerkt en uitgevoerd.

Hiermee worden bijwerkingsmethoden voor databronnen voor werkmappen worden bijgewerkt.

#### Over cross-category scopes Met cross-category scopes zijn meerdere ondersteunde acties mogelijk tussen meerdere Tableau REST API-categorieën. #### Voorbeelden
ScopeIngeschakelde methoden
tableau:content:readHiermee kunnen methoden voor Tableau-inhoud worden opgehaald/in een lijst weergegeven, waaronder databronnen, statistieken, weergaven, werkmappen, projecten en sites.
tableau:tasks:runHiermee kunnen methoden voor databronnen, werkmappen en extracten worden uitgevoerd.
tableau:views:downloadHiermee worden downloadmethoden ingeschakeld voor het bekijken van data en werkmappen.
tableau:tasks:*

Opmerking: deze scope is ook een jokerteken.

Hiermee kunnen methoden voor extracten en abonnementstaken worden opgehaald/in een lijst weergegeven, toegevoegd, bijgewerkt en uitgevoerd.

Hiermee worden bijwerkingsmethoden voor databronnen voor werkmappen worden bijgewerkt.

## Problemen met scopes oplossen ### 401001 - aanmeldingsfout Als u fout 401001 tegenkomt, wordt de antwoordtekst van **Aanmelden** aangevuld met een van de volgende extra foutcodes die specifiek zijn voor verbonden apps: 16, 10084 of 10085. In de volgende antwoordtekst is '10084' bijvoorbeeld een foutcode voor verbonden apps die u kunt gebruiken om problemen op te lossen met het aanmelden bij Tableau Server aan de hand van een JWT voor REST API-autorisatie. "summary": "Signin Error", "detail": "Error signing in to Tableau Cloud (10084)" Zie de beschrijving van de toepasselijke foutcode en de mogelijke oorzaken om het probleem op te lossen. - **16: Kan de gebruiker niet vinden**—deze fout kan optreden als een onjuiste `sub` (gebruikersnaam) is opgegeven - **10084: Kan de toegangstoken niet parseren**—deze fout kan om de volgende redenen optreden: - De JWT is ongeldig of er is een onverwacht probleem opgetreden - Incorrect `aud` (publiek) opgegeven - Bij een directe vertrouwensrelatie is er een probleem met het ondertekenen met het het geheim - **10085: Kan het geheim niet ophalen om handtekening voor client-ID te verifiëren**—deze fout kan om de volgende redenen optreden: - Incorrecte klant-ID in `iss` opgegeven - Bij een directe vertrouwensrelatie is er een incorrecte `kid` (geheim-ID) opgegeven - Bij EAS kunnen geen sleutels worden opgehaald uit de JWKSource ### 401002 - Fout: ongeautoriseerde toegang Als u fout 401002 tegenkomt en hebt bevestigd dat u de juiste machtigingen hebt om het verzoek in te dienen, controleert u of de scope in de JWT correct is en overeenkomt met de aanvraag die u wilt doen. Zie de bovenstaand sectie [REST API-methoden die JWT-autorisatie ondersteunen](#scopes) voor een lijst met eindpunten en ondersteunde scopes.