--- schema_version: "1" id: 7e788656a1a70c0e20842817bd82e8020c5b914b88326e3e822fee6048afbdc3 title: Åtkomstomfång för anslutna program collection: tableau version: current locale: sv-se portal_url: https://docs.salesforce.com/tableau/current/sv-se/server-linux/connected_apps_scopes.md canonical_url: https://help.tableau.com/current/server-linux/sv-se/connected_apps_scopes.htm source_site: help.tableau.com content_type: documentation content_hash: 12384c1b175868e06d538b1ef44ec0f65062f615437050802d93544a193f1ec3 description: Reference of access scopes that authorize REST API methods for connected apps via JWT. --- [Hoppa till huvudinnehåll](#main-content) # Åtkomstomfång för anslutna program Från och med Tableau Server version 2022.3 kan du, med hjälp av Tableau-anslutna program, programmatiskt anropa och öppna Tableau REST API via ett anpassat program för Tableau Server\-användarnas räkning. Åtkomst till REST API möjliggörs av en JSON-webbtoken (JWT) som definieras som en del av den första inloggningsbegäran. JWT måste innehålla omfång som definierar REST API-metoderna som är tillgängliga för ditt anpassade program och dess användare via det anslutna programmet. Auktorisera åtkomst till REST API med anslutna program för att: - Förbättra säkerheten – att använda JWT som bärartoken är i sig säkrare än att lagra och hantera administratörslösenord genom .env-filer i valv - Förbättra effektiviteten – att använda JWT som bärartoken möjliggör en förenklad impersonering med en förfrågan till inloggningsslutpunkten istället för två förfrågningar - Utöka och automatisera komplexa Tableau-integrationer och backend-frågor – som dynamisk innehållshämtning och avancerad filtrering ## Åtgärdernas omfattning Anslutna program använder omfattningar som erbjuder åtkomst till innehåll eller administrativa åtgärder genom [REST API-metoder som stöder JWT-auktorisering](#scopes) (nedan). Ett omfång är en kolonseparerad sträng som börjar med namnområdet `tableau`, följt av Tableau-resursen som åtkomst ges till, som t.ex. `datasources`, och slutar med den åtgärd som är tillåten på resursen, som t.ex. `update`. De åtgärder som en omfattning kan vidta inkluderar: - `create` - `read` - `run` - `update` - `download` - `delete` Till exempel ser en omfattning som tillåter att ditt anpassade program anropar metoden [Uppdatera datakälla](https://help.tableau.com/current/api/rest_api/sv-se/REST/rest_api_ref_data_sources.htm#update_data_source) ut så här: `tableau:datasources:update` ## Omfångstyper Vilken typ av omfattning som används beror på innehållet eller den administrativa åtgärden som ska aktiveras. Omfattningar delas i allmänhet in i en av följande typer: läst innehåll, individuellt, jokertecken och övergripande kategorier. - **Omfattningen läst innehåll:** Omfattningen läst innehåll ,`tableau:content:read` , aktiverar GET-metoder som stöds för Tableau-innehåll. När den här omfattningen använda aktiveras åtgärder över olika REST API-kategorier. Den här omfattningen aktiverar närmare bestämt GET-metoder för datakällor, mätvärden, vyer, arbetsböcker, projekt och platser. Från och med Tableau Server 2023.3 anger du även den här omfattningen i en JSON-webbtoken som sedan används för att skapa en token med inloggningsuppgifter som används med [metadata-API:et](https://help.tableau.com/current/api/metadata_api/sv-se/docs/meta_api_auth.html). Från och med Tableau Server 2025.1 anger du även den här omfattningen i en JSON-webbtoken som sedan används för att skapa en token med inloggningsuppgifter som används med [VizQL Data Service](https://help.tableau.com/current/api/vizql-data-service/sv-se/index.html). **Obs!** För att aktivera GET-metoder för administrativa åtgärder, som användare och grupper, kan du använda individuella omfattningar. - **Individuella omfattningar:** För att aktivera innehåll och administrativa åtgärder som stöds kan du använda varje specifik individuella omfattning. En individuell omfattning är vanligtvis associerad med en enda metod och REST API-kategori. Exempel: - Om du vill aktivera åtgärden att publicera eller uppdatera en datakälla kan du använda den individuella omfattningen `tableau:datasources:create` eller `tableau:datasources:update`. - För administrativa åtgärder såsom att lägga till eller ta bort användare kan du använda den individuella omfattningen `tableau:users:create` eller`tableau:users:delete`, respektive. **Obs!** Det finns vissa individuella omfattningar som kan aktivera åtgärder över olika REST API-kategorier. Till exempel aktiverar `tableau:views:download` åtgärder i REST API-kategorierna för vydata och arbetsböcker. - **[Omfattningar med jokertecken (\*):](#wildcard)** För vissa omfattningar kan du ersätta åtgärden med ett jokertecken (\*) för att aktivera åtgärder som stöds inom en specifik REST API-kategori. Exempel: - Du kan använda jokerteckenomfattningen `tableau:projects:*` för att aktivera åtgärderna skapa, ta bort och uppdatera i REST API-kategorin för projekt. - Du kan använda jokerteckenomfattningen `tableau:users:*` för att aktivera åtgärderna hämta/lista, lägg till, ta bort och uppdatera i REST API-kategorin för användare. - Du kan använda jokerteckenomfattningen `tableau:tasks:*` för att aktivera åtgärderna hämta/lista, lägg till, ta bort, uppdatera och kör för REST API-kategorierna för extrakt och prenumerationer. Dessutom kan du använda den här omfattningen för att uppdatera en datakälla (om den är ett extrakt) och för att uppdatera en arbetsbok. - **[Omfattningar över flera kategorier:](#cross)** Utöver omfattningen läst innehåll finns det några ytterligare omfattningar som, om de används, aktiverar åtgärder som stöds över olika REST API-kategorier. Exempel: - Om omfattningen `tableau:tasks:run` används aktiverar du åtgärder i REST API-kategorierna för datakällor och arbetsböcker. - Om omfattningen `tableau:views:download` används aktiverar du åtgärder i REST API-kategorierna för vydata och arbetsböcker. - Om omfattningar med behörighet används såsom `tableau:permissions:update` eller `tableau:permissions:delete` aktiveras åtgärder i REST API för kategorierna datakällor, arbetsböcker och projekt. ## Sammanfattning av hur du auktoriserar REST API-åtkomst I följande lista sammanfattas stegen för att begära åtkomst till REST API via en JWT: 1. **Skapa ett anslutet program** med någon av följande metoder: - [Konfigurera anslutna program med direkt förtroende (direkt betrodd)](https://help.tableau.com/current/server-linux/sv-se/connected_apps_direct.htm) - [Konfigurera anslutna program med OAuth 2.0-förtroende](https://help.tableau.com/current/server-linux/sv-se/connected_apps_eas.htm) 2. **Generera en giltig JWT** – vid körning kommer ditt anpassade program att generera en giltig JWT, konfigurerad med de omfång du har inkluderat 3. **Gör en [inloggningsbegäran](https://help.tableau.com/current/api/rest_api/sv-se/REST/rest_api_ref_authentication.htm#sign_in)** – ditt anpassade program gör en inloggningsbegäran med JSON-webbtoken för att returnera en Tableau-token med inloggningsuppgifter och ett plats-ID (LUID) 4. **Använd Tableau-åtkomsttoken i efterföljande förfrågningar** – i efterföljande REST API-anrop använder du 1) Tableau-token med inloggningsuppgifter som [`X-Tableau-Auth`](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_auth.htm#using_auth_token)\-rubrikvärdet och 2) plats-ID (LUID) i förfrågans-URI ### Exempel Anta till exempel att du skapar ett anslutet program med hjälp av direkt förtroende (direkt betrodd). Med hjälp av direkt förtroende genererar det anpassade program som anropar REST API en giltig JWT med det klient-ID och den klienthemlighet som genereras av det anslutna programmet. **Omfång i JWT** För att lyckas auktorisera åtkomst till REST API måste JWT också innehålla de omfång som definierar REST API-funktionerna. Till exempel, för att aktivera olika datakällsrelaterade metoder kan du inkludera följande omfång i JWT: `"tableau:content:read","tableau:datasources:create","tableau:datasources:update","tableau:datasources:download","tableau:tasks:run"` Eller `"tableau:content:read","tableau:datasources:*","tableau:tasks:run"` **Obs!** Omfångsvärdena måste skickas som en listtyp. **URI för inloggningsbegäran** För att göra ett anrop till REST API måste ditt anpassade program först göra en inloggningsbegäran för att generera en Tableau-token för inloggningsuppgifterna. ``` POST https://myco/api/3.17/auth/signin ``` **Förfråganstext** För att auktorisera REST API-åtkomst med en JSON-webbtoken måste inloggningsbegäran innehålla den giltiga JSON-webbtoken, som i exemplet nedan. ``` ``` **Svarstext** Inloggningsbegäran producerar följande svarstext, som inkluderar Tableau-token med inloggningsuppgifter. ``` ``` När Tableau-inloggningstoken har genererats ska du lägga till den i rubriken för alla efterföljande REST API-begäranden. **Rubrik** X-Tableau-Auth:12ab34cd56ef78ab90cd12ef34ab56cd Alla efterföljande REST API-förfrågningar som använder Tableau-åtkomsttoken begränsas sedan av omfång i JWT. ## REST API-metoder som stöder JWT-auktorisering Omfattningar för anslutna program ger ditt anpassade program åtkomst till Tableau REST API-funktioner för användarnas räkning ### Så här hittar du omfattningar Du kan hitta den omfattning som krävs för en viss metod som stöds av JWT i motsvarande egenskapsblock i hjälpen för [Tableau REST API](https://help.tableau.com/current/api/rest_api/sv-se/REST/rest_api.htm). Om en omfattning inte tagits med i metodens egenskapsblock kan åtkomst till metoden inte styras med en JWT. Ett exempel på en omfattning som tillåter anrop till metoden [Query Site](https://help.tableau.com/current/api/rest_api/sv-se/REST/rest_api_ref_site.htm#query_site) i Tableau REST API är `tableau:sites:read`. **Obs!** - Både [Logga in](https://help.tableau.com/current/api/rest_api/sv-se/REST/rest_api_ref_authentication.htm#sign_in) och [Logga ut](https://help.tableau.com/current/api/rest_api/sv-se/REST/rest_api_ref_authentication.htm#sign_out) stöds av JWT-auktorisering men behöver inte inkluderas för att kunna användas från och med Tableau Server 2023.3. - För omfattningar som stöds av inbäddnings-API v3 läser du något av följande avsnitt: - [Konfigurera anslutna program med direkt förtroende (direkt betrodd)](https://help.tableau.com/current/server-linux/sv-se/connected_apps_direct.htm) - [Konfigurera anslutna program med OAuth 2.0-förtroende](https://help.tableau.com/current/server-linux/sv-se/connected_apps_eas.htm) - Från och med Tableau Server 2025.3 stöder vissa av de listade omfattningarna även REST API-auktorisering via enhetliga åtkomsttoken (UAT). Det innebär att anslutna program och UAT-omfattningar är desamma. ### Typer av omfattningar #### Om omfattningar med jokertecken (\*) Omfattningar med jokertecken använder jokertecken (\*) i stället för specifika åtgärder, och aktiverar på så sätt flera åtgärder som stöds inom en viss Tableau REST API-kategori. #### Exempel
OmfattningAktiverade metoder
tableau:datasources:*Aktiverar metoder för att skapa, uppdatera och uppdatera anslutningar för datakällor.
tableau:metrics:*Aktiverar åtgärder för att fråga, uppdatera och ta bort mätvärden.
tableau:workbooks:*Aktiverar åtgärder för att publicera, uppdatera, ladda ner och förhandsgranska bilder för arbetsböcker.
tableau:groups:*Aktiverar åtgärder för att skapa, fråga, uppdatera och ta bort grupper.
tableau:projects:*Aktiverar metoder för att skapa, ta bort och uppdatera projekt.
tableau:users:*Aktiverar metoder för att hämta/lista, lägga till, ta bort och uppdatera användare.
tableau:tasks:*

Obs! Denna omfattning är också kategoriövergripande.

Aktiverar metoder för att hämta/lista, lägga till, ta bort, uppdatera och köra extrakt och prenumerationsuppgifter.

Aktiverar uppdateringsmetoder för datakällor för arbetsböcker.

#### Om kategoriövergripande omfattningar Kategoriövergripande omfattningar aktiverar stöd för att utföra flera åtgärder inom flera Tableau REST API-kategorier. #### Exempel
OmfattningAktiverade metoder
tableau:content:readAktiverar metoder för att läsa/lista Tableau-innehåll, bland annat datakällor, mätvärden, vyer, arbetsböcker, projekt och platser.
tableau:tasks:runAktiverar körningsmetoder för datakällor, arbetsböcker och extrakt.
tableau:views:downloadAktiverar nedladdningsmetoder för vydata och arbetsböcker.
tableau:tasks:*

Obs! Denna omfattning är också en jokerteckenomfattning.

Aktiverar metoder för att hämta/lista, lägga till, ta bort, uppdatera och köra extrakt och prenumerationsuppgifter.

Aktiverar uppdateringsmetoder för datakällor för arbetsböcker.

## Felsök omfång ### 401001 – inloggningsfel Om du stöter på fel 401001 läggs **inloggningssvaret** till, med en av följande extra felkoder som är specifika för det anslutna programmet: 16, 10084 eller 10085. I följande svarstext är till exempel ”10084” felkoden för anslutna program som du kan använda för att felsöka problem med att logga in på Tableau Server med en JWT för REST API-auktorisering. "summary": "Signin Error", "detail": "Error signing in to Tableau Cloud (10084)" Se beskrivningen av tillämplig felkod och dess potentiella orsaker för hjälp med att lösa problemet. - **16: Kunde inte hitta användaren** – det här felet kan uppstå då den felaktiga ”`sub`” (användarnamn) indikerades - **10084: Det gick inte att analysera åtkomsttoken** – det här felet kan uppstå av följande anledningar: - JWT är ogiltigt eller ett oväntat problem uppstod - Felaktig ”`aud`” (publik) indikerades - För direkt förtroende var det problem med att signera hemligheten - **10085: Det gick inte att hämta hemligheten för att verifiera signaturen för klient-ID** – det här felet kan uppstå av följande anledningar: - Felaktigt klient-ID i ”`iss`” indikerades - För direkt förtroende indikerades felaktigt ”`kid`” (hemlighets-ID) - Det går inte att hämta nycklar från JWKSource för EAS ### 401002 – fel vid obehörig åtkomst Om fel 401002 uppstår och du har bekräftat att du har rätt behörighet att göra begäran ska du se till att omfattningen som ingår i JWT är korrekt och matchar den begäran som görs. Se avsnittet [REST API-metoder som stöder JWT-auktorisering](#scopes) ovan för en lista över slutpunkter och omfattningar som stöds.