L'incorporamento con servizio Single Sign-On (SSO) è un modo per presentare ai tuoi utenti dashboard, visualizzazioni, esplorazioni, dashboard o LookML privati senza richiedere loro di disporre di credenziali di accesso Looker separate. Gli utenti verranno invece autenticati tramite la tua applicazione.
L'incorporamento a SSO funziona creando un URL Looker speciale che utilizzerai in un iframe. L'URL contiene le informazioni che vuoi condividere, l'ID dell'utente nel sistema e le autorizzazioni di cui dispone l'utente. Quindi, firmerai l'URL con una chiave segreta fornita da Looker.
Per l'incorporamento pubblico, consulta la sezione Incorporamento pubblico con tag iframe
della pagina della documentazione relativa a condivisione pubblica, importazione e incorporamento di Look.
Prima di utilizzare l'incorporamento SSO nella tua istanza di Looker, è necessario che un amministratore Looker abiliti l'incorporamento dell'SSO nel pannello di amministrazione di Looker e crei una chiave segreta di incorporamento. Per istruzioni, consulta la pagina della documentazione Introduzione all'incorporamento – Attivare l'incorporamento SSO.
Hosting adeguato per incorporamento SSO
Per alcuni browser, ad esempio Safari o browser con estensioni installate che bloccano gli annunci o i cookie di monitoraggio, vengono applicate norme predefinite che bloccano i cookie di terze parti. Quando la funzionalità Incorporamento senza cookie è attivata, i browser che bloccano i cookie di terze parti possono autenticare gli utenti nell'iframe incorporato in domini diversi. L'autenticazione di incorporamento senza cookie richiede una configurazione lato server. Consulta la pagina della documentazione relativa all'incorporamento senza cookie per gli esempi di configurazione.
Se la funzionalità Incorporamento senza cookie non è attiva, Looker utilizza i cookie per l'autenticazione degli utenti. In questo caso, non è possibile tentare di autenticare l'iframe incorporato in più domini nei browser che bloccano i cookie di terze parti (a meno che l'utente non modifichi le impostazioni della privacy dei cookie del browser). Ad esempio, se vuoi incorporare informazioni su https://mycompany.com
, devi assicurarti che Looker condivida lo stesso dominio, come https://analytics.mycompany.com
. In questo caso, se Looker ospita l'istanza, contatta l'assistenza Looker per impostare la configurazione DNS necessaria per abilitare l'utilizzo dei domini personalizzati. In questo modo, Looker potrà condividere lo stesso dominio dell'applicazione di incorporamento e utilizzare cookie originali, accettati per impostazione predefinita in tutti i browser.
Se hai un'istanza di Looker ospitata dal cliente, assicurati che l'applicazione che utilizzerà l'incorporamento SSO utilizzi lo stesso dominio della tua istanza di Looker.
Controllare la visibilità dei client con un sistema chiuso
È comune in una configurazione di incorporamento SSO per gli utenti Looker che presentano dati ai propri clienti e hanno clienti di diverse aziende o gruppi che non devono conoscere tra loro. In questo scenario, per salvaguardare le informazioni private dei clienti, ti consigliamo vivamente di configurare Looker come sistema chiuso, chiamato anche installazione multitenant. In un sistema chiuso, i contenuti sono isolati per impedire agli utenti di gruppi diversi di avere informazioni sugli altri. Per questo motivo, ti consigliamo di abilitare l'opzione Sistema chiuso prima di concedere a qualsiasi utente esterno l'accesso alla tua istanza.
Per ulteriori informazioni, consulta le pagine della documentazione Progettazione e configurazione di un sistema di livelli di accesso e Best practice per la sicurezza delle analisi incorporate.
Creazione dell'URL per l'incorporamento
Esistono diversi modi per creare l'URL per l'incorporamento del servizio SSO. Puoi utilizzare uno di questi metodi:
Utilizza l'endpoint URL
create_sso_embed
dell'API Looker, come descritto più avanti in questo documento.Utilizzare l'SDK Embed di Looker.
Codifica l'URL per l'incorporamento SSO. Per creare l'URL corretto dovrai scrivere il codice in modo da poter codificare correttamente l'URL con la tua chiave segreta e generare altri elementi relativi alla sicurezza. Puoi trovare diversi script di esempio nel repository GitHub di esempi SSO di Looker. Le seguenti sezioni spiegano le informazioni che devi fornire per gli script e le istruzioni su come creare un URL di incorporamento SSO senza utilizzare uno script.
Raccolta delle informazioni di Looker necessarie
Come punto di partenza per la creazione del tuo URL, devi prima determinare tutte le informazioni che è necessario includere. Requisiti:
Incorpora URL
Recupera l'URL dell'aspetto, dell'esplorazione, della visualizzazione della query o della dashboard che vuoi incorporare. Quindi, rimuovi il dominio e inserisci /embed
prima del percorso nel seguente modo:
Elemento | Pattern URL normale | Incorpora URL |
---|---|---|
Look | https://instance_name.looker.com/ looks/4 |
/embed/looks/4 |
Esplora | https://instance_name.looker.com/ explore/my_model/my_explore |
/embed/explore/my_model/my_explore |
Visualizzazione query | https://instance_name.looker.com/ explore/my_model/my_explore?qid=1234567890abcdefghij12 I 22 caratteri alfanumerici che seguono il parametro qid= nell'URL di esplorazione sono composti da Query.client_id . Il valore Query.client_id è una stringa univoca che rappresenta la query e le impostazioni di visualizzazione.Per incorporare una visualizzazione query, recupera il valore Query.client_id della visualizzazione query e copia Query.client_id nell'URL di incorporamento.Puoi utilizzare l'interfaccia utente di Explore di Looker per creare una query con una visualizzazione supportata e copiare il valore Query.client_id dal parametro qid= oppure puoi recuperare Query.client_id con l'API Looker utilizzando, ad esempio, il metodo Get Query . |
/embed/query-visualization/Query.client_id |
Dashboard definita dall'utente | https://instance_name.looker.com/ dashboards/1 Includi eventuali valori del filtro della dashboard o, se nascondi valori filtro, il parametro hide_filter nell'URL della dashboard. |
|
Dashboard precedente definita dall'utente |
https://instance_name.looker.com/ dashboards-legacy/1 |
/embed/dashboards-legacy/1 |
dashboard LookML | https://instance_name.looker.com/ dashboards/my_model::my_dashboard |
/embed/dashboards/my_model::my_dashboard |
Dashboard LookML precedente |
https://instance_name.looker.com/ dashboards-legacy/my_model::my_dashboard |
/embed/dashboards-legacy/my_model::my_dashboard |
I contenuti incorporati riflettono sempre la versione di produzione dei contenuti. Qualsiasi modifica apportata in modalità di sviluppo che influisca sui contenuti di cui non è stato eseguito il deployment in produzione non verrà visualizzata in un incorporamento.
Autorizzazioni
Un set di autorizzazioni definisce le azioni consentite a un utente o a un gruppo. Le autorizzazioni possono essere applicate in due modi:
- Specifica del modello: questo tipo di autorizzazione viene applicato solo ai set di modelli che fanno parte dello stesso ruolo.
- A livello di istanza: questo tipo di autorizzazione si applica all'istanza di Looker nel suo complesso. Gli utenti con autorizzazioni di accesso a livello di istanza possono eseguire determinate funzioni sull'intera istanza di Looker, ma non possono accedere ai contenuti in base ai modelli non inclusi nel set di modelli del loro ruolo.
Determina le autorizzazioni da assegnare all'utente. Il seguente elenco mostra tutte le autorizzazioni disponibili per l'incorporamento con SSO. Le autorizzazioni non incluse nel seguente elenco non sono supportate per l'incorporamento con SSO:
Autorizzazione | Dipende da | Tipo | Definizione |
---|---|---|---|
access_data |
Nessuno | Specifico per il modello | Consente all'utente di accedere ai dati (obbligatorio per la visualizzazione di Look, dashboard o Esplorazioni) |
see_lookml_dashboards |
access_data |
Specifico per il modello | Consente all'utente di visualizzare le dashboard di LookML |
see_looks |
access_data |
Specifico per il modello | Consenti all'utente di visualizzare i Look |
see_user_dashboards |
see_looks |
Specifico per il modello | Consente all'utente di visualizzare le dashboard definite dall'utente e di sfogliare le cartelle da un elemento incorporato |
explore |
see_looks |
Specifico per il modello | Consente all'utente di visualizzare le pagine Esplora |
create_table_calculations |
explore |
A livello di istanza | Necessità di creare calcoli delle tabelle in un'esplorazione |
create_custom_fields |
explore |
A livello di istanza | AGGIUNTO 22.4 Necessario per creare campi personalizzati in un'esplorazione |
can_create_forecast |
explore |
A livello di istanza | AGGIUNTO 22,12 Consente agli utenti di creare o modificare le previsioni nelle visualizzazioni. |
save_content |
see_looks |
A livello di istanza | Consente agli utenti di apportare modifiche ai look e alle dashboard e salvarle |
send_outgoing_webhook |
see_looks |
Specifico per il modello | Consente all'utente di pianificare le consegne di contenuti Looker a un webhook arbitrario |
send_to_s3 |
see_looks |
Specifico per il modello | Consente all'utente di pianificare le pubblicazioni di contenuti Looker in un bucket Amazon S3 |
send_to_sftp |
see_looks |
Specifico per il modello | Consente all'utente di pianificare le pubblicazioni di contenuti Looker su un server SFTP |
schedule_look_emails |
see_looks |
Specifico per il modello | Consente all'utente di pianificare le consegne di contenuti Looker alla propria email (se impostata con un attributo utente denominato "email") o a un indirizzo email compreso nelle limitazioni impostate dalla lista consentita dei domini email. Consente all'utente con autorizzazioni create_alerts di inviare notifiche di avviso a un indirizzo email compreso nelle limitazioni impostate dalla lista consentita dei domini email. |
schedule_external_look_emails |
schedule_look_ emails |
Specifico per il modello | Consente all'utente di pianificare le distribuzioni dei contenuti di Looker a qualsiasi dominio email. Consente all'utente con autorizzazioni create_alerts di inviare notifiche di avviso a qualsiasi dominio email. |
send_to_ integration |
see_looks |
Specifico per il modello | Consente all'utente di fornire contenuti Looker ai servizi di terze parti integrati con Looker tramite l'hub azioni di Looker. Questa autorizzazione non è correlata alle azioni sui dati. |
create_alerts |
see_looks |
A livello di istanza | Consente all'utente di creare avvisi sui riquadri della dashboard per ricevere notifiche quando le condizioni specificate sono soddisfatte o superate. Gli utenti possono modificare, duplicare ed eliminare i loro avvisi e quelli degli Pubblico di altri utenti. Se l'area di lavoro di Slack dell'utente non è collegata all'istanza di Looker, non potrà creare avvisi che inviano notifiche a Slack. |
download_with_limit |
see_looks |
A livello di istanza | Consente all'utente di scaricare i risultati di una query con un limite applicato |
download_without_limit |
see_looks |
A livello di istanza | Consente all'utente di scaricare i risultati di una query senza limiti applicati |
see_sql |
see_looks |
Specifico per il modello | Consente all'utente di visualizzare l'SQL per le query e gli eventuali errori SQL derivanti dall'esecuzione di query |
clear_cache_refresh |
access_data |
Specifico per il modello | AGGIUNTO 21.14 Gli utenti possono svuotare la cache e aggiornare dashboard incorporate, dashboard precedenti, riquadri delle dashboard, Look ed esplorazioni. |
see_drill_overlay |
access_data |
Specifico per il modello | Consente di eseguire il drill-down senza dover accedere alla pagina Esplora completa. |
embed_browse_spaces |
Nessuno | A livello di istanza | Consente al browser di contenuti di consentire a un utente di sfogliare cartelle da un incorporamento. A qualsiasi utente incorporato che dispone dell'autorizzazione embed_browse_spaces viene concesso l'accesso a una cartella di incorporamento personale e alla cartella Condivisi della tua organizzazione, se esistente. L'autorizzazione embed_browse_spaces è consigliata per gli utenti che dispongono dell'autorizzazione save_content , in modo che l'utente possa sfogliare le cartelle quando seleziona dove salvare i contenuti. Per visualizzare i contenuti nelle cartelle, l'utente deve disporre anche delle autorizzazioni see_looks , see_user_dashboards e see_lookml_dashboards . |
embed_save_shared_space |
Nessuno | A livello di istanza |
AGGIUNTA 21.4
Consente all'utente, che dispone anche dell'autorizzazione save_content , di accedere alla cartella Condivisi dell'organizzazione, se presente, dalla finestra di dialogo Salva. Gli utenti che dispongono dell'autorizzazione save_content ma non dell'autorizzazione embed_save_shared_space avranno solo la possibilità di salvare i contenuti nella cartella di incorporamento personale.L'autorizzazione embed_save_shared_space non sostituisce le autorizzazioni di accesso ai contenuti. Ad esempio, per consentire agli utenti di salvare nella cartella Condivisi, devono comunque disporre dell'accesso Gestisci accesso, Modifica alla cartella Condivisi. Inoltre, l'assenza dell'autorizzazione embed_save_shared_space non impedisce a un utente che dispone dell'autorizzazione save_content e dell'accesso Gestione dell'accesso, modifica della cartella Condivisi di salvare i contenuti se ha un modo alternativo per andare alla cartella Condivisi, ad esempio utilizzando l'opzione Esplora da qui da una dashboard incorporata. |
Accesso al modello
Determina a quali modelli LookML deve accedere l'utente. Si tratterà semplicemente di un elenco di nomi di modelli.
Attributi utente
Stabilisci gli attributi utente di cui deve disporre l'utente. Dovrai fornire il nome dell'attributo utente di Looker e il valore che deve avere per l'attributo.
Gruppi
Stabilisci a quali gruppi deve appartenere l'utente. Avrai bisogno degli ID dei gruppi anziché dei nomi dei gruppi. L'aggiunta di un utente di incorporamento SSO a un gruppo Looker ti consente di gestire l'accesso di quell'utente alle cartelle Looker. Gli utenti dell'incorporamento SSO avranno accesso a qualsiasi cartella condivisa con i membri dei loro gruppi di Looker.
Puoi anche utilizzare il parametro external_group_id
per creare un gruppo esterno ai gruppi Looker standard. In questo caso, gli utenti che incorporano SSO con lo stesso external_group_id
avranno accesso a una cartella condivisa, denominata "Gruppo", che è univoca per il gruppo esterno.
Ruoli incorporati
I parametri permissions
e models
creano un ruolo per l'utente di incorporamento. Questo ruolo viene visualizzato come "Ruolo incorporato" nella pagina Utenti della sezione Amministrazione di Looker. Se i parametri permissions
, models
e group_ids
sono tutti specificati nell'URL di incorporamento, il ruolo incorporato è additive a tutti i ruoli già assegnati ai gruppi elencati nel parametro group_ids
. Lo stesso vale per i ruoli standard, in quanto tutti i ruoli in Looker sono cumulativi.
Ad esempio, supponiamo che tu abbia un gruppo in Looker con ID gruppo 1
e che abbia già l'autorizzazione explore
per un modello denominato model_one
e che crei un URL di incorporamento con i seguenti parametri:
group_ids
=[1]
permissions
=["access_data","see_looks"]
models
=["model_two"]
In questo caso, l'utente di incorporamento erediterà la possibilità di visualizzare ed esplorare i dati su model_one
e il ruolo di incorporamento creato con i parametri precedenti concederà anche la possibilità di visualizzare i dati su model_two
.
Creazione dell'URL per l'incorporamento
Un URL di incorporamento SSO ha il seguente formato:
https://HOST/login/embed/Whitelist URL?PARAMETRI&signature=FIRMA
Host
L'host è la posizione in cui è ospitata l'istanza di Looker. Ad esempio, analytics.mycompany.com
. Assicurati di includere il numero di porta se non hai abilitato il port forwarding, ad esempio analytics.mycompany.com:9999
.
Incorpora URL
L'URL per l'incorporamento è stato determinato in precedenza. Il formato sarà il seguente:
/embed/looks/4
/embed/explore/my_model/my_explore
/embed/query-visualization/Query.client_id
/embed/dashboards/1
o/embed/dashboards-legacy/1
/embed/dashboards/my_model::my_dashboard
o/embed/dashboards-legacy/my_model::my_dashboard
Questo significa che il pattern /embed//embed/
verrà visualizzato nell'URL finale; è corretto.
Se utilizzi eventi JavaScript incorporati, assicurati di aggiungere un embed_domain
(il dominio in cui viene utilizzato l'iframe) alla fine dell'URL di incorporamento, in questo modo:
/embed/looks/4
/embed/looks/4?embed_domain=https://mywebsite.com
embed_domain
viene aggiunto dopo l'URL di incorporamento e prima di qualsiasi parametro. Pertanto, se avevi parametri esistenti, come nonce=626
, l'aggiunta di embed_domain
avrebbe il seguente aspetto:
/embed/looks/4?nonce=626
/embed/looks/4?embed_domain=https://mywebsite.com?nonce=626
Se utilizzi l'SDK Embed, assicurati di aggiungere embed_domain
e di includere sdk=2
alla fine dell'URL di incorporamento, in questo modo:
/embed/looks/4
/embed/looks/4?embed_domain=https://mywebsite.com&sdk=2
Il parametro sdk=2
consente a Looker di identificare la presenza dell'SDK e di usufruire delle funzionalità aggiuntive fornite dall'SDK. L'SDK non può aggiungere questo parametro perché fa parte dell'URL SSO firmato.
Parametri
I seguenti parametri URL vengono utilizzati per specificare le informazioni necessarie per l'incorporamento SSO:
Parametro | Valore predefinito | Descrizione | Tipo di dati | Esempio |
---|---|---|---|---|
nonce |
Valore obbligatorio | Qualsiasi stringa casuale che ti piace, ma che non può essere ripetuta entro un'ora e deve contenere meno di 255 caratteri. In questo modo si impedisce a un utente malintenzionato di inviare nuovamente l'URL di un utente legittimo per raccogliere informazioni che non dovrebbe avere. |
Stringa JSON | "22b1ee700ef3dc2f500fb7" |
time |
Valore obbligatorio | L'ora corrente come timestamp UNIX. | Numero intero | 1407876784 |
session_length |
Valore obbligatorio | Il numero di secondi per cui l'utente deve rimanere collegato a Looker, compreso tra 0 e 2.592.000 (30 giorni). | Numero intero | 86400 |
external_user_id |
Valore obbligatorio | Un identificatore di ogni utente dell'applicazione che incorpora Looker. Looker utilizza external_user_id per differenziare gli utenti di incorporamento SSO, quindi a ogni utente deve essere assegnato un ID univoco.Puoi creare un external_user_id per un utente con qualsiasi stringa, purché sia univoca per quell'utente. Ogni ID è associato a un insieme di autorizzazioni, attributi utente e modelli. Un singolo browser può supportare una sola external_user_id o sessione utente alla volta. Non è possibile apportare modifiche alle autorizzazioni o agli attributi utente di un utente durante la sessione.Per motivi di sicurezza, assicurati di non utilizzare lo stesso external_user_id in sessioni di incorporamento differenti per utenti interattivi diversi e assicurati di non utilizzare lo stesso external_user_id per un singolo utente con autorizzazioni, valori dell'attributo utente o accesso al modello diversi.Utilizzare lo stesso external_user_id per più utenti o per lo stesso utente con più autorizzazioni, attributi utente o set di modelli potrebbe causare a chi non avrebbe accesso i dati. |
Stringa JSON | "user-4" |
permissions |
Valore obbligatorio | L'elenco delle autorizzazioni che l'utente deve avere. Per l'elenco delle autorizzazioni consentite, consulta la sezione Autorizzazioni di questa pagina. |
Array di stringhe | [ "access_data", "see_looks" ] |
models |
Valore obbligatorio | L'elenco dei nomi dei modelli a cui l'utente deve avere accesso. | Array di stringhe | [ "model_one", "model_two" ] |
group_ids |
[] | L'elenco di gruppi Looker di cui l'utente deve essere membro, se presente. Utilizza gli ID dei gruppi anziché i nomi dei gruppi. | Array di numeri interi | [4, 3] |
external_group_id |
"" | Un identificatore univoco per il gruppo a cui appartiene l'utente nell'applicazione che incorpora Looker, se lo desidera. Gli utenti autorizzati a salvare contenuti e a condividere un ID gruppo esterno potranno salvare e modificare i contenuti in una cartella Looker condivisa denominata "Group". |
Stringa JSON | "Accounting" |
user_attributes |
{} | L'elenco degli attributi utente di cui deve disporre l'utente. Contiene un elenco di nomi di attributi utente seguiti dal valore dell'attributo utente. Se il tuo modello LookML è localizzato, puoi utilizzare l'attributo utente locale nell'URL per l'incorporamento per specificare una lingua per l'incorporamento. Ad esempio, se includi il parametro user_attributes { "locale" : "fr_FR" } , l'incorporamento carica il francese come lingua. |
Hash di stringhe | { "vendor_id" : "17", "company" : "xactness" } |
access_filters |
Valore obbligatorio | In Looker 3.10 questo parametro è stato rimosso, ma è ancora obbligatorio nell'URL. Utilizza access_filters con un segnaposto vuoto, ad esempio access_filters={} . |
Segnaposto vuoto | {} |
first_name |
"" | Il nome dell'utente. Se il campo viene lasciato vuoto, first_name conserverà il valore dell'ultima richiesta oppure sarà "Embed" se non è mai stato impostato un nome. |
Stringa JSON | "Alice" |
last_name |
"" | Cognome dell'utente. Se il campo viene lasciato vuoto, last_name conserverà il valore dell'ultima richiesta oppure sarà "Embed" se non è mai stato impostato un cognome. |
Stringa JSON | "Jones" |
user_timezone |
"" | Se hai abilitato Fusi orari specifici degli utenti, imposta il valore dell'opzione Fuso orario dello spettatore nel menu a discesa Fuso orario sulla dashboard o sul look incorporati. Questo parametro non modifica direttamente il fuso orario in cui vengono visualizzati i contenuti, l'utente dovrà selezionare il fuso orario desiderato dal menu a discesa. Vedi i valori validi nella pagina della documentazione relativa al riferimento del fuso orario di incorporamento SSO. Suggerimento del team di Chat: se vuoi che i tuoi contenuti incorporati vengano impostati sul valore predefinito del visualizzatore, utilizza uno dei seguenti metodi: ?query_timezone=user_timezone all'URL di incorporamento. Ad esempio:/embed/dashboards/1?query_timezone=user_timezone |
Stringa JSON o null | "US/Pacific" - oppure - null |
force_logout_login |
Valore obbligatorio | Se un normale utente Looker ha già eseguito l'accesso a Looker e visualizza un elemento incorporato SSO, puoi scegliere se: 1) Deve visualizzare l'elemento con le sue attuali credenziali oppure 2) Deve essere disconnesso e accedere di nuovo con le credenziali SSO. |
Booleano (true [vero] o false [falso]) | true |
Firma
Per generare la firma, segui questi passaggi:
- Raccogli i seguenti valori parametro in questo ordine:
- Host, seguito da
login/embed/
(ad esempio,analytics.mycompany.com/login/embed/
) - Incorpora URL
- Nonce
- Ora attuale
- Durata sessione
- ID utente esterno
- Autorizzazioni
- Modelli
- ID gruppo
- ID gruppo esterno
- Attributi dell'utente
- Filtri di accesso (è necessario un segnaposto vuoto)
- Host, seguito da
- Formattare tutti i valori diversi da Host e Incorpora URL come JSON
- Concatena i valori con interruzioni di riga (
\n
) - Firma HMAC la stringa concatenata con la chiave segreta di incorporamento di Looker.
Codifica
Il passaggio finale consiste nella codifica dell'URL.
Prima di codificare l'URL, un URL di incorporamento formattato correttamente che utilizza tutti i possibili parametri potrebbe avere il seguente aspetto:
https://analytics.mycompany.com/login/embed//embed/dashboards/1?
nonce="22b1ee700ef3dc2f500fb7"&
time=1407876784&
session_length=86400&
external_user_id="user-4"&
permissions=["access_data","see_user_dashboards","see_looks"]&
models=["model_one","model_two"]&
group_ids=[4,3]&
external_group_id="Allegra K"&
user_attributes={"vendor_id":"17","company":"xactness"}&
access_filters={}&
first_name="Alice"&
last_name="Jones"&
user_timezone="US/Pacific"&
force_logout_login=true&
signature=123456789ABCDEFGHIJKL
Come indicato in precedenza, è corretto che /embed//embed/
venga visualizzato nell'URL.
Dopo la codifica dell'URL, la pagina avrà il seguente aspetto:
https://analytics.mycompany.com/login/embed/%2embed%2Fdashboards%2F1?
nonce=%2222b1ee700ef3dc2f500fb7&%22&
time=1407876784&
session_length=86400&
external_user_id=%22user-4%22&
permissions=%5B%22access_data%22%2C%22see_user_dashboards%22%2C%22see_looks%22%5D&
models=%5B%22model_one%22%2C%22model_two%22%5D&
group_ids=%5B4%2C3%5D&
external_group_id=%22Allegra%20K%22&
user_attributes=%7B%22vendor_id%22%3A%2217%22%2C%22company%22%3A%22xactness%22%7D&
access_filters%7B%7D%26%0A
first_name=%22Alice%22&
last_name=%22Jones%22&
user_timezone=%22US%2FPacific%22&
force_logout_login=true&
signature=123456789ABCDEFGHIJKL
Utilizzo dell'endpoint API create_sso_embed_url
L'API Looker include l'endpoint create_sso_embed_url
, che accetta una serie di parametri di incorporamento SSO che includono l'URL dei contenuti che vuoi incorporare e restituisce un URL SSO completo, codificato e criptato.
Per utilizzare questo endpoint API da un server web, il server web deve essere in grado di autenticarsi nell'API Looker con privilegi amministrativi. Il dominio del server web deve essere elencato anche nella lista consentita del dominio incorporato.
Puoi anche utilizzare Explorer API per generare un URL SSO che utilizza questo endpoint. Puoi installare Explorer API nella tua istanza di Looker da Looker Marketplace oppure visualizzare una versione pubblica sul portale per sviluppatori di Looker. Una volta generato, l'URL SSO deve essere copiato esattamente e può essere utilizzato una sola volta, altrimenti l'operazione non andrà a buon fine. Explorer API è utile anche per generare un URL SSO e confrontarlo con un URL SSO creato manualmente per la risoluzione dei problemi.
Per ulteriori informazioni sull'API Looker, consulta la pagina della documentazione Introduzione all'API Looker.
Test dell'URL per l'incorporamento
Per testare l'URL finale, incollalo nella sezione Embed URI Validator (Incorpora URI URI) della pagina Embed della sezione Admin (Amministrazione) di Looker. Anche se questa opzione non è in grado di dirti se i dati e le autorizzazioni che hai configurato sono stati configurati correttamente, può confermare che l'autenticazione funzioni correttamente.