Gestire le estensioni di dashboard e di visualizzazione in Tableau Cloud

Le estensioni di dashboard sono applicazioni Web eseguite in aree personalizzate della dashboard e possono interagire con il resto della dashboard utilizzando l’API Extensions di Tableau(Il collegamento viene aperto in una nuova finestra). Le estensioni di dashboard consentono agli utenti di interagire con i dati di altre applicazioni direttamente in Tableau. Analogamente alle estensioni di dashboard, le estensioni di visualizzazione sono applicazioni Web che utilizzano l’API Extensions di Tableau e consentono agli sviluppatori di creare nuovi tipi di visualizzazione. Gli utenti Tableau possono accedere alle estensioni di visualizzazione tramite la scheda Indicatori del foglio di lavoro.

Nota: per aggiungere estensioni di dashboard e di visualizzazione all’elenco consentiti e controllare il tipo di dati a cui possono accedere le estensioni, devi essere un amministratore del sito. L’amministratore del sito può inoltre configurare se gli utenti del sito visualizzano i prompt quando aggiungono o visualizzano estensioni. Per informazioni sulla sicurezza delle estensioni e le opzioni di distribuzione consigliate, consulta Sicurezza delle estensioni - Procedure consigliate per la distribuzione(Il collegamento viene aperto in una nuova finestra).

Per informazioni sull’utilizzo delle estensioni di dashboard in Tableau, consultaUsare le estensioni di dashboard.

Per informazioni sull’utilizzo delle estensioni di visualizzazione, consulta Aggiungere estensioni di visualizzazione al foglio di lavoro.

Prima di eseguire le estensioni in Tableau Cloud

In Tableau le estensioni vengono ospitate in due diversi modi:

  • Estensioni abilitate alla rete, che vengono ospitate su server Web all’interno e all’esterno della rete locale. Le estensioni abilitate alla rete hanno accesso completo al Web.
  • Estensioni in modalità sandbox, che vengono eseguite in un ambiente protetto senza alcun accesso ad altre risorse o servizi sul Web.

Nota: a partire dalla versione 2021.1, Tableau supporta l’integrazione con Einstein Discovery tramite l’estensione di dashboard Einstein Discovery. Si tratta di una speciale estensione che ha accesso ai dati in Salesforce.com ed è consentita per impostazione predefinita. Non viene considerata un’estensione abilitata alla rete o un’estensione in modalità sandbox. Per maggiori informazioni sull’integrazione di Einstein Discovery, consulta Configurare l’integrazione di Einstein Discovery(Il collegamento viene aperto in una nuova finestra).

Le estensioni in modalità sandbox sono ospitate da Tableau e utilizzano gli standard W3C, come Content Security Policy (CSP), per garantire che l’estensione non possa effettuare chiamate di rete all’esterno del sistema Tableau Server che la ospita. Un’estensione in modalità sandbox può interrogare i dati nella dashboard, ma non può inviare tali dati all’esterno della sandbox. Le estensioni in modalità sandbox sono supportate in Tableau 2019.4 e versioni successive. Per impostazione predefinita, l’esecuzione delle estensioni in modalità sandbox è consentita se le estensioni sono abilitate per il sito.

Le estensioni abilitate per la rete sono applicazioni Web e possono essere in esecuzione su qualsiasi computer configurato come server Web. Questo include i computer locali, i computer nel dominio e i siti Web di terze parti. Poiché le estensioni abilitate per la rete potrebbero essere ospitate su siti di terze parti e avere accesso ai dati nella cartella di lavoro, è consigliabile consentire solo le estensioni considerate attendibili. Consulta Testare la sicurezza delle estensioni abilitate alla rete.

Per motivi di sicurezza, puoi utilizzare le impostazioni per le estensioni su Tableau Cloud per controllare e limitare le estensioni che possono essere eseguite.

  • Per impostazione predefinita, l’esecuzione delle estensioni in modalità sandbox è consentita se le estensioni sono abilitate per il sito.

  • Per impostazione predefinita, le estensioni abilitate alla rete non sono consentite, a meno che non siano state aggiunte esplicitamente all’elenco consentiti.

  • Per impostazione predefinita, sono ammesse solo le estensioni che utilizzano il protocollo HTTPS, che garantisce un canale crittografato per l’invio e la ricezione dei dati (l’unica eccezione è per http://localhost).

  • Se l’estensione abilitata alla rete richiede dati completi (accesso ai dati sottostanti), non potrà essere eseguita su Tableau Cloud, a meno che non venga aggiunta esplicitamente all’elenco consentiti e si conceda all’estensione accesso ai dati completi.

Controllare le estensioni e accedere ai dati

Gli amministratori del sito possono scegliere se abilitare le estensioni per il sito e se consentire le estensioni in modalità sandbox nel sito. Le impostazioni predefinite del sito consentono l’esecuzione delle estensioni in modalità sandbox sul sito, a condizione che l’estensione non sia specificamente bloccata sul server. Le impostazioni predefinite del sito consentono l’esecuzione delle estensioni abilitate alla rete incluse nell’elenco sicuro del sito. È anche possibile aggiungere all’elenco sicuro singole estensioni in modalità sandbox, se le estensioni in modalità sandbox non sono consentite per impostazione predefinita.

  1. Per modificare queste impostazioni del sito, vai su Impostazioni > Estensioni.

  2. In Estensioni di dashboard e di visualizzazione configura queste opzioni:

    • Consenti agli utenti di eseguire estensioni nel sito
    • Consenti l’esecuzione delle estensioni in modalità sandboxed a meno che non siano specificamente bloccate da un amministratore del server

Gli amministratori del sito possono aggiungere o rimuovere le estensioni abilitate alla rete o in modalità sandbox nell’elenco sicuro per un sito. Quando aggiungi un’estensione all’elenco di indirizzi attendibili, puoi scegliere se consentire all’estensione di accedere ai dati completi. Consulta Aggiungere estensioni all’elenco sicuro e configurare i prompt utente.

Identificazione dell’URL di un’estensione

Come applicazione Web, un’estensione è associata a un URL. È possibile utilizzare questo URL per testare e verificare l’estensione. Inoltre, puoi anche utilizzare l’URL per aggiungere l’estensione all’elenco sicuro per consentire l’accesso completo ai dati oppure all’elenco di blocco per impedire qualsiasi accesso.

Dal file manifest

Se il file manifesto di estensione (.trex), un file XML che definisce le proprietà per l’estensione, puoi trovare l’URL nell’elemento <source-location>.


<source-location>
    <url>https://www.example.com/myExtension.html</url>
</source-location>

				

Da Tableau Exchange

Se hai aggiunto o scaricato un’estensione da Tableau Exchange, trovi l’URL dell’estensione su Exchange. Apri la sezione dell’estensione in Specifiche tecniche e cerca l’URL sotto l’intestazione Ospitato in.

Sezione di Tableau Exchange relativa a un’estensione che mostra dove trovare l’URL in Ospitato in

Identificazione di un’estensione di dashboard con la finestra di dialogo Informazioni

Se hai aggiunto l’estensione alla dashboard, puoi trovare l’URL dalle proprietà dell’estensione. Dal menu Più opzioni, fai clic su Informazioni.

La finestra di dialogo Informazioni elenca il nome dell’estensione, l’autore, il sito Web dell’autore e l’URL dell’estensione.

Aggiungere estensioni all’elenco sicuro e configurare i prompt utente

Per garantire che gli utenti possano utilizzare estensioni abilitate alla rete affidabili, puoi aggiungerle all’elenco sicuro del sito. È anche possibile aggiungere estensioni in modalità sandbox all’elenco sicuro, se le estensioni in modalità sandbox non sono abilitate per impostazione predefinita sul sito.

Nell’elenco sicuro, puoi stabilire se concedere all’estensione l’accesso completo ai dati. Per impostazione predefinita, quando aggiungi un’estensione all’elenco sicuro, l’estensione ha accesso solo ai dati di riepilogo (o aggregati). Inoltre, puoi anche controllare se gli utenti visualizzano un prompt che chiede loro di consentire all’estensione di accedere ai dati. Potresti voler aggiungere un’estensione all’elenco consentiti (ad esempio un’estensione in modalità sandbox) in modo da poter configurare se gli utenti visualizzano o meno i prompt. Quando nascondi i prompt agli utenti, l’estensione può essere eseguita immediatamente.

  1. Vai su Impostazioni > Estensioni.

  2. In Consenti estensioni specifiche, aggiungi l’URL dell’estensione. Consulta Identificazione dell’URL di un’estensione.

    Suggerimento: è possibile specificare nell’URL un punto e un asterisco (.*) come carattere jolly per consentire l’accesso a tutte le estensioni in un dominio o una posizione specifica. Ad esempio, per consentire l’accesso a tutte le estensioni nel dominio example.com che utilizzano la porta 8080, l’URL da aggiungere è: https://example.com:8080/.* . Per maggiori informazioni, consulta Utilizzo di espressioni regolari nell’URL dell’elenco consentiti.

  3. Scegli di Consentire o Negare all’estensione l’Accesso completo ai dati.

    L’accesso completo ai dati è l’accesso ai dati sottostanti nella vista, non solo al sommario o ai dati aggregati. L’accesso completo ai dati include inoltre informazioni sulle origini dati, quali nomi della connessione, campi e tabelle. In genere, se aggiungi all’elenco consentiti un’estensione che vuoi utilizzare, è probabile che vuoi anche consentire all’estensione di avere accesso ai dati completi, se richiesto dall’estensione. Prima di aggiungere estensioni all’elenco sicuro, assicurati di aver effettuato il Testare la sicurezza delle estensioni abilitate alla rete.

  4. Scegli di Mostrare o Nascondere i Prompt utente.

    Gli utenti visualizzano i prompt per impostazione predefinita quando aggiungono un’estensione di dashboard a una dashboard o un’estensione di visualizzazione a un foglio di lavoro oppure quando interagiscono con una vista per cui è disponibile un’estensione. Il prompt indica agli utenti i dettagli dell’estensione e se l’estensione ha accesso ai dati completi. Il prompt consente agli utenti di consentire o negare l’esecuzione dell’estensione. Puoi nascondere questo prompt agli utenti, consentendo l’esecuzione immediata dell’estensione.

Utilizzo di espressioni regolari nell’URL dell’elenco consentiti

In generale, quando aggiungi un’estensione all’elenco consentiti, è consigliabile utilizzare l’URL specifico dell’estensione. Tuttavia, a volte potresti voler consentire più estensioni ospitate nello stesso dominio e nella stessa posizione. In questo caso conviene utilizzare un carattere jolly nell’URL. Le impostazioni dell’estensione supportano l’uso delle espressioni regolari.

Espressione regolareDescrizione
.Un punto (.) è un carattere jolly che consente di trovare qualsiasi carattere. Se è necessario specificare un punto (.) nell’URL anziché un carattere jolly, è possibile utilizzare una barra rovesciata (\.) come carattere di escape.
*Un asterisco (*) è un quantificatore che consente di specificare una o più istanze del carattere precedente.

Se utilizzi caratteri jolly, presta attenzione a non rendere l’elenco consentiti troppo permissivo e consentire inavvertitamente l’accesso a estensioni a cui vuoi impedire l’accesso.

La tabella seguente mostra alcuni esempi di utilizzo delle espressioni regolari nell’URL. Tieni presente che questi esempi non mostrano il protocollo e l’URL completo dell’estensione. Sono consentite solo le estensioni che utilizzano il protocollo HTTPS (ad eccezione di http://localhost).

Per specificare...EsempioSpecifica
Gamma di domini.*\.example.comTutti i sottodomini in example.com.
Tutte le porteexample.com:.*Le estensioni possono accedere da tutte le porte su example.com.
Tutte le estensioni presenti nel dominio, porta e percorso specificatiexample.com:8080/xyz/.*

L’accesso è consentito a tutte le estensioni presenti nel dominio example.com che utilizzano la porta 8080 e si trovano in zyz.

Tutte le porte per una gamma di domini.*\.example.com:.*L’accesso è consentito alle estensioni su tutte le porte e in tutti i sottodomini in example.com.
Tutte le estensioni in un dominio e un percorso che corrispondono al modelloexample.com/t.c/.*L’accesso è consentito alle estensioni in esecuzione su example.com nelle cartelle che corrispondono al modello t.c. Ad esempio, tic, tac, toc.

Testare la sicurezza delle estensioni abilitate alla rete

Le estensioni di dashboard e di visualizzazione sono applicazioni Web che interagiscono con i dati in Tableau tramite l’API Extensions. Le estensioni abilitate alla rete possono essere ospitate su server Web all’interno o all’esterno del dominio e possono effettuare chiamate di rete e avere accesso a risorse su Internet. A causa delle potenziali vulnerabilità, ad esempio lo scripting tra i siti, è necessario testare e controllare le estensioni abilitate alla rete prima che vengano utilizzate in Tableau Desktop, nonché prima di consentire le estensioni su Tableau Cloud.

Esaminare i file origine

Le estensioni di dashboard e di visualizzazione sono applicazioni Web e includono vari file HTML, CSS e JavaScript, e un file manifest XML (*.trex) che definisce le proprietà dell’estensione. In molti casi il codice per un’estensione è disponibile pubblicamente su GitHub e può essere esaminato in tale posizione o scaricato. Nel file manifesto (*.trex), è possibile trovare la posizione di origine o l’URL indicato in cui è ospitata l’estensione, il nome dell’autore e il sito Web dell’autore o della società da contattare per l’assistenza. L’elemento <source-location> specifica nell’URL, l’elemento <author> , specifica il nome dell’organizzazione e il sito Web da contattare per l’assistenza (website="SUPPORT_URL"). Il sito Web è il collegamento a Ottieni assistenza che l’utente vede nella finestra di dialogo Informazioni per l’estensione.

Molte estensioni fanno riferimento alle librerie JavaScript esterne, ad esempio la libreria jQuery o le librerie API di terze parti. Verifica che l’URL per le librerie esterne punti a una posizione attendibile per la libreria. Ad esempio, se il connettore fa riferimento alla libreria jQuery, assicurati che la libreria si trovi in un sito considerato standard e sicuro.

Tutte le estensioni devono utilizzare il protocollo HTTPS ihttps:// per ospitare le rispettive estensioni. Dovresti esaminare i file sorgente per l’estensione per assicurarti che ogni riferimento a librerie esterne utilizzi anche HTTPS o sia ospitato sullo stesso sito Web dell’estensione. L’unica eccezione alla richiesta HTTPS è se l’estensione è ospitata sullo stesso computer di Tableau (http://localhost).

Per quanto possibile, assicurati di comprendere il modo in cui il codice svolge le operazioni. In particolare, cerca di comprendere il modo in cui il codice compila le richieste per i siti esterni e quali informazioni vengono inviate nella richiesta. In particolare, controlla se i dati specificati dall’utente vengono convalidati per impedire la creazione di script tra i siti (XSS).

Comprendere l’accesso ai dati

L’API Extensions di Tableau fornisce metodi che consentono di accedere ai nomi delle tabelle e dei campi attivi nell’origine dati, le descrizioni riepilogative delle connessioni all’origine dati e i dati sottostanti in foglio di lavoro. Se un’estensione utilizza uno di questi metodi in una vista, lo sviluppatore deve dichiarare che l’estensione richiede l’autorizzazione dati completa nel file manifesto (.trex). La dichiarazione si presenta come segue.


<permissions>
   <permission>full data</permission>
</permissions>

Tableau utilizza questa dichiarazione per fornire agli utenti un prompt durante l’esecuzione per consentire o meno questo accesso. Se l’estensione utilizza uno qualsiasi di questi metodi, senza dichiarare l’autorizzazione per i dati completi nel file manifest, l’estensione verrà caricata, ma le chiamate ai metodi non riusciranno.

Per informazioni su come un’estensione accede ai dati dalla dashboard e come vengono usati i metodi JavaScript, consulta Accesso ai dati sottostanti(Il collegamento viene aperto in una nuova finestra) nell’API Estensioni Tableau. Per comprendere meglio ciò che l’estensione può scoprire sui dati, puoi utilizzare l’estensione dashboard di esempio DataSources(Il collegamento viene aperto in una nuova finestra) (disponibile nel repository di Estensioni Tableau API GitHub(Il collegamento viene aperto in una nuova finestra)) per vedere quali dati vengono esposti quando viene chiamato il metodo getDataSourcesAsync().

Testare l’estensione in un ambiente isolato

Se possibile, testa l’estensione in un ambiente isolato dal tuo ambiente di produzione e dai computer degli utenti. Aggiungi, ad esempio, un’estensione di visualizzazione o di dashboard a un elenco consentiti in un computer o una macchina virtuale di test che esegue una versione di Tableau Cloud non utilizzata per la produzione.

Monitorare il traffico creato dall’estensione di dashboard

Quando testi un’estensione abilitata alla rete, utilizza uno strumento come Fiddler(Il collegamento viene aperto in una nuova finestra), Charles HTTP proxy(Il collegamento viene aperto in una nuova finestra) o Wireshark(Il collegamento viene aperto in una nuova finestra) per esaminare le richieste e le risposte dell’estensione. Assicurati di aver compreso il contenuto richiesto dall’estensione. Esamina il traffico per essere sicuro che l’estensione non stia leggendo dati o codici che non sono direttamente collegati allo scopo dell’estensione.

Grazie per il tuo feedback.Il tuo feedback è stato inviato. Grazie!