| Attestazione | Nome | Descrizione o valore richiesto |
"kid" | ID chiave | Obbligatorio (nell’intestazione). Identificatore di chiave univoco restituito dal provider di identità. |
"iss" | Rilasciato da | Obbligatorio (nell’intestazione o come attestazione). URI dell’emittente univoco che identifica l’app connessa attendibile e la relativa chiave di firma. |
"alg" | Algoritmo | Obbligatorio (nell’intestazione). Algoritmo di firma JWT. I nomi degli algoritmi supportati sono elencati nella pagina Class JWSAlgorithm della documentazione javadoc.io. L’algoritmo di firma può essere configurato utilizzando il comando descritto in vizportal.oauth.external_authorization_server.blocklisted_jws_algorithms. |
"sub" | Oggetto | Nome utente dell’utente autenticato di Tableau Server. |
"aud" | Destinatari | Il valore deve essere: " |
"exp" | Ora di scadenza | Un token JWT valido non deve essere scaduto. L’ora di scadenza del token JWT (in UTC) deve rientrare nel periodo di validità massimo configurato. Il periodo di validità massimo può essere configurato utilizzando il comando vizportal.oauth.external_authorization_server.max_expiration_period_in_minutes. |
"jti" | ID JWT | L’attestazione ID JWT fornisce un identificatore univoco per il token JWT, applicando la distinzione tra maiuscole e minuscole. |
"scp" | Ambito | Per l’incorporamento di flussi di lavoro, i valori supportati includono: " Note:
Per i workflow di autorizzazione dell’API REST, consulta Metodi API REST che supportano l’autorizzazione JWT. Per i flussi di lavoro dell’API dei metadati che utilizzano l’API REST per l’autenticazione, l’unico ambito supportato è Per i flussi di lavoro del servizio VizQL Data che utilizzano l’API REST per l’autenticazione, l’unico ambito supportato è |
https://tableau.com/groups | Appartenenza ai gruppi dinamica | Solo per l’incorporamento di flussi di lavoro. Il valore deve corrispondere al nome di uno o più gruppi di Tableau Server. Per maggiori informazioni, consulta Appartenenza ai gruppi dinamica con le asserzioni. |
| (Attributi utente) | (Valori degli attributi utente) | Solo per l’incorporamento di flussi di lavoro. A partire da Tableau Server 2025.1, è possibile includere attributi utente nel token Web JSON. Quindi, quando le funzioni degli attributi utente vengono utilizzate in contenuti incorporati, Tableau controlla il contesto dell’utente autenticato e determina quali dati possono essere visualizzati in fase di esecuzione. Note:
|
| Codice di errore | Riepilogo | Descrizione | Potenziale risoluzione o spiegazione |
| 5 | SYSTEM_USER_NOT_FOUND | Impossibile trovare l’utente di Tableau | Per risolvere questo problema, verifica che il valore dell’attestazione " sub" (Soggetto) in JWT sia "username" per Tableau Server autenticato. Questo valore distingue tra maiuscole e minuscole. |
| 16 | LOGIN_FAILED | Accesso non riuscito | Questo errore è in genere causato da uno dei seguenti problemi di attestazione nel token JWT:
|
| 67 | FEATURE_NOT_ENABLED | L’accesso su richiesta non è supportato | L’accesso su richiesta è disponibile solo tramite i siti Tableau Cloud con licenza. |
| 10081 | COULD_NOT_RETRIEVE_IDP_METADATA | Endpoint dei metadati EAS mancante | Per risolvere questo problema, verifica che l’EAS sia configurato correttamente e che venga chiamato l’emittente corretto. |
| 10082 | AUTHORIZATION_SERVER_ISSUER_NOT_SPECIFIED | Emittente mancante | Per risolvere questo problema, verifica che venga chiamato l’emittente corretto. Per modificare l’URL dell’emittente, puoi utilizzare il comando vizportal.oauth.external_authorization_server.issuer. |
| 10083 | BAD_JWT | L’intestazione JWT presenta problemi | Le attestazioni "kid" (ID del segreto) o "clientId" (Emittente) non sono presenti nell’intestazione JWT. Per risolvere questo problema, assicurati che queste informazioni siano incluse. |
| 10084 | JWT_PARSE_ERROR | Il token JWT presenta problemi | Per risolvere il problema, verifica quanto segue:
|
| 10085 | COULD_NOT_FETCH_JWT_KEYS | JWT non è riuscito a trovare le chiavi | Impossibile trovare il segreto. Per risolvere questo problema, verifica che venga chiamato l’emittente corretto. Per modificare l’URL dell’emittente, puoi utilizzare il comando vizportal.oauth.external_authorization_server.issuer. |
| 10087 | BLOCKLISTED_JWS_ALGORITHM_USED_TO_SIGN | Problema dell’algoritmo di firma JWT | Per risolvere il problema, puoi rimuovere l’algoritmo di firma. Per maggiori informazioni, consulta vizportal.oauth.external_authorization_server.blocklisted_jws_algorithms. |
| 10088 | RSA_KEY_SIZE_INVALID | Problema dei requisiti di firma JWT | Per risolvere questo problema, verifica con l’EAS o l’IdP che il token JWT sia firmato con una chiave RSA di 2048. |
| 10091 | JTI_ALREADY_USED | JWT univoco richiesto | Il token JWT è già stato utilizzato nel processo di autenticazione. Per risolvere questo problema, l’EAS o l’IdP deve generare un nuovo token JWT. |
| 10092 | NOT_IN_DOMAIN_ALLOW_LIST | Il dominio del contenuto incorporato non è specificato | Per risolvere questo problema, assicurati che l’impostazione unrestrictedEmbedding sia configurata su true o che il parametro domainAllowlist includa i domini in cui è incorporato il contenuto di Tableau utilizzando il metodo Aggiorna le impostazioni di incorporamento per il sito nell’API REST di Tableau. |
| 10094 | MISSING_REQUIRED_JTI | ID JWT mancante | Per risolvere questo problema, verifica che "jti" (ID JWT) sia incluso nel JWT. |
| 10096 | JWT_EXPIRATION_EXCEEDS_CONFIGURED_EXPIRATION_PERIOD | Il valore "exp" (Ora di scadenza) è superiore al periodo di validità massimo predefinito. Per risolvere questo problema, esamina le attestazioni registrate richieste per un token JWT valido e assicurati che venga utilizzato il valore corretto. Per modificare il periodo di validità massimo, puoi utilizzare il comando vizportal.oauth.external_authorization_server.max_expiration_period_in_minutes. | |
| 10097 | SCOPES_MALFORMED | Problemi con l’attestazione relativa agli ambiti | Questo errore può verificarsi quando l’attestazione "scp" (Ambito) non è presente nel JWT o non è passata come tipo di elenco. Per risolvere questo problema, verifica che "scp" sia incluso nel JWT e passato come tipo di elenco. Per informazioni sulla risoluzione dei problemi con un JWT, consulta Debugger sul sito auth0. |
| 10098 | JWT_UNSIGNED_OR_ENCRYPTED | Il token JWT non è firmato o è crittografato | Tableau non supporta i token JWT non firmati o crittografati. |
| 10099 | SCOPES_MISSING_IN_JWT | Attestazione mancante per gli ambiti | Nel token JWT manca l’attestazione "scp" (Ambito) richiesta. Per risolvere questo problema, verifica che "scp" sia incluso nel JWT. Per informazioni sulla risoluzione dei problemi con un JWT, consulta Debugger sul sito auth0. |
| 10100 | JTI_PERSISTENCE_FAILED | Errore ID JWT imprevisto | Si è verificato un errore imprevisto con "jti" (ID JWT). Per risolvere questo problema, è necessario generare un nuovo token JWT con un nuovo "jti". |
| 10103 | JWT_MAX_SIZE_EXCEEDED | JWT supera la dimensione massima | Questo errore può verificarsi quando la dimensione del token JWT è superiore a 8.000 byte. Per risolvere questo problema, assicurati che vengano passate a Tableau Server solo le attestazioni necessarie. |