--- schema_version: "1" id: efe6de9629dfc5911d8172dbe91583a1ed5885ea54e0d7fdf26998a64ca91c11 title: Ambiti di accesso per le app connesse collection: tableau version: next locale: it-it portal_url: https://docs.salesforce.com/tableau/next/it-it/server/connected_apps_scopes.md canonical_url: https://help.tableau.com/v0.0/server/it-it/connected_apps_scopes.htm source_site: help.tableau.com content_type: documentation content_hash: f74af64883b26d647fcecaba492f31ffaf73badc8629d6724f1f6e5d05cfccfd description: Reference of access scopes that authorize REST API methods for connected apps via JWT. --- [Passa al contenuto principale](#main-content) # Ambiti di accesso per le app connesse A partire da Tableau Server versione 2022.3 , utilizzando le app connesse di Tableau puoi chiamare a livello di codice e accedere all’API REST di Tableau tramite la tua applicazione personalizzata per conto degli utenti di Tableau Server. L’accesso all’API REST è abilitato da un token JWT (JSON Web Token), definito come parte della richiesta di accesso iniziale. Il token JWT deve contenere ambiti che definiscono i metodi dell’API REST disponibili per l’applicazione personalizzata e i relativi utenti tramite l’app connessa. Autorizza l’accesso all’API REST utilizzando le app connesse per: - Miglioramento della sicurezza: l’utilizzo di un JWT come token di trasporto è intrinsecamente più sicuro dell’archiviazione e della gestione delle password degli utenti amministratori tramite i file .env nei depositi - Migliorare l’efficienza. L’utilizzo di un JWT come token di trasporto consente una rappresentazione semplificata, con una richiesta all’endpoint di accesso invece di due. - Estendere e automatizzare le complesse integrazioni di Tableau e le query back-end, come il recupero dinamico dei contenuti e il filtro avanzato. ## Azioni di ambito Le app connesse utilizzano ambiti che concedono l’accesso al contenuto o alle azioni amministrative tramite i [Metodi API REST che supportano l’autorizzazione JWT](#scopes) (di seguito). Un ambito è una stringa separata da due punti che inizia con lo spazio dei nomi `tableau`, seguito dalla risorsa di Tableau a cui viene concesso l’accesso, ad esempio `datasources`, e termina con l’azione consentita sulla risorsa, ad esempio `update`. Le azioni che un ambito può eseguire includono: - `create` - `read` - `run` - `update` - `download` - `delete` Ad esempio, un ambito che consente all’applicazione personalizzata di chiamare il metodo [Aggiorna origine dati](https://help.tableau.com/current/api/rest_api/it-it/REST/rest_api_ref_data_sources.htm#update_data_source) è simile al seguente: `tableau:datasources:update` ## Tipi di ambito Il tipo di ambito utilizzato dipende dal contenuto o dall’azione amministrativa che si desidera abilitare. Gli ambiti generalmente rientrano in uno dei seguenti tipi: lettura del contenuto, individuale, carattere jolly e cross-category. - **Ambito di lettura del contenuto:** l’ambito di lettura del contenuto, `tableau:content:read` , abilita i metodi GET supportati per i contenuti di Tableau. Quando si utilizza questo ambito, si abilitano le azioni tra le categorie dell’API REST. In particolare, utilizzando questo ambito si abilitano i metodi GET per origini dati, metriche, viste, cartelle di lavoro, progetti e siti. A partire da Tableau Server 2023.3, devi specificare questo ambito anche in un token Web JSON che verrà utilizzato per creare un token di credenziali da utilizzare con l’[API dei metadati](https://help.tableau.com/current/api/metadata_api/en-us/docs/meta_api_auth.html). A partire da Tableau Server 2025.1, devi specificare questo ambito anche in un token Web JSON che verrà utilizzato per creare un token di credenziali da utilizzare con il [servizio VizQL Data](https://help.tableau.com/current/api/vizql-data-service/it-it/index.html). **Nota:** per abilitare i metodi GET per azioni amministrative, come utenti e gruppi, puoi utilizzare i loro ambiti individuali. - **Ambiti individuali:** per abilitare il contenuto supportato e le azioni amministrative, puoi utilizzare i loro ambiti individuali. Un singolo ambito è generalmente associato a un singolo metodo e a una singola categoria dell’API REST. Esempi: - Per abilitare la pubblicazione o l’aggiornamento di un’azione dell’origine dati, puoi utilizzare l’ambito individuale `tableau:datasources:create` o `tableau:datasources:update`, rispettivamente. - Per azioni amministrative come aggiungere o rimuovere utenti, puoi utilizzare l’ambito individuale `tableau:users:create` o `tableau:users:delete`, rispettivamente. **Nota:** esistono alcuni ambiti individuali che possono abilitare azioni tra le categorie di API REST. Ad esempio, `tableau:views:download` abilita le azioni nelle categorie Dati vista e Cartelle di lavoro dell’API REST. - **[Ambiti con caratteri jolly:](#wildcard)** per determinati (\*) ambiti, è possibile sostituire l’azione con il carattere jolly (\*) per abilitare le azioni supportate all’interno di una specifica categoria dell’API REST. Esempi: - Puoi usare l’ambito con caratteri jolly `tableau:projects:*` per abilitare le azioni di creazione, eliminazione e aggiornamento nella categoria dell’API REST per i progetti. - Puoi usare l’ambito con caratteri jolly `tableau:users:*` per abilitare le azioni di recupero/elenco, aggiunta, eliminazione e aggiornamento nella categoria dell’API REST per gli utenti. - Puoi usare l’ambito con caratteri jolly `tableau:tasks:*` per abilitare le azioni di recupero/elenco, aggiunta, eliminazione, aggiornamento ed esecuzione nelle categorie dell’API REST per le estrazioni e le sottoscrizioni. Inoltre, questo ambito consente l’aggiornamento dell’origine dati (se si tratta di un’estrazione) e l’aggiornamento della cartella di lavoro. - **[Ambiti cross-category:](#cross)** oltre all’ambito di lettura del contenuto, esistono alcuni ambiti aggiuntivi che, se usati, abilitano azioni supportate in diverse categorie dell’API REST. Esempi: - Se si utilizza l’ambito `tableau:tasks:run`, si abilitano le azioni nelle categorie origini dati e cartelle di lavoro dell’API REST. - Ancora una volta, se si utilizza l’ambito `tableau:views:download`, si abilitano le azioni nelle categorie Dati vista e Cartella di lavoro dell’API REST. - Se si utilizzano ambiti di autorizzazione come `tableau:permissions:update` o `tableau:permissions:delete`, si abilitano le azioni nelle categorie origini dati, cartelle di lavoro e progetti dell’API REST. ## Riepilogo delle fasi per autorizzare l’accesso all’API REST Nell’elenco seguente sono riepilogate le fasi per richiedere l’accesso all’API REST tramite un token JWT: 1. **Crea un’app connessa** utilizzando uno dei seguenti metodi: - [Configurare le app connesse con un trust diretto](https://help.tableau.com/v0.0/server/it-it/connected_apps_direct.htm) - [Configurare le app connesse con Trust OAuth 2.0](https://help.tableau.com/v0.0/server/it-it/connected_apps_eas.htm) 2. **Genera un token JWT valido**: in fase di esecuzione la tua applicazione personalizzata genererà un token JWT valido, configurato con gli ambiti che hai incluso 3. **Effettua una richiesta di [accesso](https://help.tableau.com/current/api/rest_api/it-it/REST/rest_api_ref_authentication.htm#sign_in)**: la tua applicazione personalizzata eseguirà una richiesta di accesso utilizzando il token JWT per restituire un token di credenziali Tableau e un ID del sito (LUID) 4. **Utilizza il token di accesso di Tableau nelle richieste successive**: nelle successive chiamate all’API REST, utilizza 1) il token di credenziali Tableau come valore dell’intestazione [`X-Tableau-Auth`](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_auth.htm#using_auth_token) e 2) l’ID del sito (LUID) nell’URI della richiesta ### Esempio Supponi ad esempio di creare un’app connessa utilizzando un trust diretto. Utilizzando un trust diretto, l’applicazione personalizzata che chiama l’API REST genera un token JWT valido utilizzando l’ID client e il segreto client generati dall’app connessa. **Ambiti nel token JWT** Per autorizzare correttamente l’accesso all’API REST, il token JWT deve contenere anche gli ambiti che definiscono le funzionalità dell’API REST. Ad esempio, per abilitare vari metodi relativi all’origine dati, potresti includere i seguenti ambiti nel token JWT: `"tableau:content:read","tableau:datasources:create","tableau:datasources:update","tableau:datasources:download","tableau:tasks:run"` Oppure `"tableau:content:read","tableau:datasources:*","tableau:tasks:run"` **Nota:** i valori degli ambiti devono essere passati come tipo di elenco. **URI della richiesta di accesso** Per effettuare una chiamata all’API REST, l’applicazione personalizzata deve prima effettuare una richiesta di accesso per generare un token per le credenziali di Tableau. ``` POST https://myco/api/3.17/auth/signin ``` **Corpo della richiesta** Per autorizzare l’accesso all’API REST utilizzando un token JWT, il corpo della richiesta di accesso deve contenere il token JWT valido come nell’esempio seguente. ``` ``` **Corpo della risposta** La richiesta di accesso produce il seguente corpo della risposta, che include il token di credenziali Tableau. ``` ``` Dopo aver generato il token delle credenziali di Tableau, aggiungilo all’intestazione di tutte le richieste successive dell’API REST. **Intestazione** X-Tableau-Auth:12ab34cd56ef78ab90cd12ef34ab56cd Tutte le successive richieste API REST che utilizzano il token di accesso di Tableau vengono quindi limitate dagli ambiti nel token JWT. ## Metodi API REST che supportano l’autorizzazione JWT Gli ambiti per le app connesse concedono all’applicazione personalizzata l’accesso alle funzionalità dell’API REST di Tableau per conto degli utenti ### Come trovare gli ambiti Puoi trovare l’ambito richiesto per un metodo supportato da JWT nel relativo blocco delle proprietà nella Guida [dell’API REST di Tableau](https://help.tableau.com/current/api/rest_api/it-it/REST/rest_api.htm) (in inglese). Se un ambito non è elencato nel blocco delle proprietà del metodo, l’accesso a tale metodo non può essere controllato da un JWT. Ad esempio, un ambito che consente di chiamare il metodo di [query sito](https://help.tableau.com/current/api/rest_api/it-it/REST/rest_api_ref_site.htm#query_site) nell’API REST di Tableau è `tableau:sites:read`. **Note:** - Sia i metodi di [accesso](https://help.tableau.com/current/api/rest_api/it-it/REST/rest_api_ref_authentication.htm#sign_in) che di [disconnessione](https://help.tableau.com/current/api/rest_api/it-it/REST/rest_api_ref_authentication.htm#sign_out) sono supportati dall’autorizzazione JWT, ma non richiedono ambiti per l’utilizzo a partire da Tableau Server 2023.3. - Per gli ambiti supportati dall’API di incorporamento v3, consulta uno degli articoli seguenti: - [Configurare le app connesse con un trust diretto](https://help.tableau.com/v0.0/server/it-it/connected_apps_direct.htm) - [Configurare le app connesse con Trust OAuth 2.0](https://help.tableau.com/v0.0/server/it-it/connected_apps_eas.htm) - A partire da Tableau Server 2025.3, un sottoinsieme di ambiti elencati supporta anche l’autorizzazione dell’API REST tramite token di accesso unificati (UAT). Questo significa che gli ambiti di UAT e app connesse sono gli stessi. ### Tipo di ambiti #### Informazioni sugli ambiti con caratteri jolly (\*) Gli ambiti con caratteri jolly utilizzano il carattere jolly (\*), invece di un’azione specifica, per abilitare più azioni supportate all’interno di una specifica categoria dell’API REST di Tableau. #### Esempi
AmbitoMetodi abilitati
tableau:datasources:*Abilita i metodi dell’origine dati di creazione, aggiornamento e aggiornamento della connessione.
tableau:metrics:*Abilita le azioni di query, aggiornamento ed eliminazione delle metriche.
tableau:workbooks:*Consente di pubblicare, aggiornare, scaricare e visualizzare in anteprima le azioni della cartella di lavoro delle immagini.
tableau:groups:*Abilita le azioni di creazione, query, aggiornamento ed eliminazione dei gruppi.
tableau:projects:*Abilita i metodi di creazione, eliminazione e aggiornamento dei progetti.
tableau:users:*Abilita i metodi di recupero/elenco, aggiunta, eliminazione e aggiornamento degli utenti.
tableau:tasks:*

Nota: questo ambito è anche cross-category.

Abilita i metodi di recupero/elenco, aggiunta, eliminazione, aggiornamento ed esecuzione per le estrazioni e le attività di sottoscrizione.

Abilita i metodi di aggiornamento per le origini dati per le cartelle di lavoro.

#### Informazioni sugli ambiti cross-category Gli ambiti cross-category consentono più azioni supportate in più categorie dell’API REST di Tableau. #### Esempi
AmbitoMetodi abilitati
tableau:content:readAbilita i metodi di lettura/elenco per i contenuti di Tableau, incluse origini dati, metriche, viste, cartelle di lavoro, progetti e siti.
tableau:tasks:runAbilita i metodi di esecuzione per origini dati, cartelle di lavoro ed estrazioni.
tableau:views:downloadAbilita i metodi di download per i dati delle viste e le cartelle di lavoro.
tableau:tasks:*

Nota: questo ambito è anche con caratteri jolly.

Abilita i metodi di recupero/elenco, aggiunta, eliminazione, aggiornamento ed esecuzione per le estrazioni e le attività di sottoscrizione.

Abilita i metodi di aggiornamento per le origini dati per le cartelle di lavoro.

## Risolvere i problemi relativi agli ambiti ### 401001 - errore di accesso Se riscontri l’errore 401001, viene aggiunto il corpo della risposta **Accesso** con uno dei seguenti codici di errore aggiuntivi specifici per le app connesse: 16, 10084 o 10085. Ad esempio, nel corpo della risposta seguente, “10084” è il codice di errore delle app connesse che puoi utilizzare per risolvere i problemi relativi all’accesso a Tableau Server utilizzando un token JWT per l’autorizzazione dell’API REST. "summary": "Signin Error", "detail": "Error signing in to Tableau Cloud (10084)" Per agevolare la risoluzione del problema, fai riferimento alla descrizione del codice di errore applicabile e alle sue potenziali cause. - **16: impossibile trovare l’utente** - questo errore può verificarsi perché è stato specificato il valore "`sub`" (Nome utente) errato - **10084: impossibile analizzare il token di accesso** - questo errore può verificarsi per i seguenti motivi: - Il token JWT non è valido o si è verificato un problema imprevisto - È stato specificato il valore "`aud`" (Destinatari) errato - Per un trust diretto, si è verificato un problema con la firma del segreto - **10085: impossibile recuperare il segreto per verificare la firma per l’ID client** - questo errore può verificarsi per i seguenti motivi: - È stato specificato l’ID client errato in "`iss`" - Per un trust diretto, è stato specificato il valore "`kid`" (ID del segreto) errato - Per EAS, è impossibile recuperare le chiavi da JWKSource ### 401002 - errore di accesso non autorizzato Se riscontri l’errore 401002 e hai verificato di disporre delle autorizzazioni appropriate per effettuare la richiesta, assicurati che l’ambito incluso nel token JWT sia corretto e corrisponda alla richiesta che stai tentando di eseguire. Per un elenco di endpoint e ambiti supportati, consulta la sezione [Metodi API REST che supportano l’autorizzazione JWT](#scopes) più indietro.