Incorporamento del Single Sign-On (SSO)

Contatta il tuo account manager Looker se vuoi utilizzare queste funzionalità.

L'incorporamento del servizio SSO (Single Sign-On) è un modo per presentare ai tuoi utenti Look, visualizzazioni, visualizzazioni, dashboard o dashboard LookML privati senza richiedere che abbiano un accesso Looker separato. Gli utenti verranno invece autenticati tramite la tua applicazione.

L'incorporamento SSO funziona creando un URL Looker speciale che utilizzerai in un iframe. L'URL contiene le informazioni che vuoi condividere, l'ID dell'utente presente nel tuo sistema e le autorizzazioni di cui dispone per quell'utente. Quindi, firma 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 Condivisione pubblica, importazione e incorporamento di Look.

Hosting corretto per l'incorporamento SSO

Alcuni browser, ad esempio Safari o i browser in cui sono installate estensioni di blocco degli annunci o del monitoraggio, utilizzano per impostazione predefinita una norma sui cookie che blocca i cookie di terze parti. Poiché Looker utilizza i cookie per l'autenticazione degli utenti, non è possibile tentare di autenticare l'iframe incorporato in più domini in questi browser (a meno che l'utente non modifichi le impostazioni sulla privacy dei cookie del browser). Ad esempio, se vuoi incorporare informazioni su https://mycompany.com, devi assicurarti che Looker condivida lo stesso dominio, ad esempio https://analytics.mycompany.com.

Se Looker ospita l'istanza, contatta l'assistenza Looker per impostare la configurazione DNS necessaria per abilitare l'uso del dominio personalizzato. Questo consentirà a Looker di condividere lo stesso dominio dell'applicazione di incorporamento e di utilizzare i cookie originali, che sono accettati per impostazione predefinita in tutti i browser. Apri una richiesta di assistenza nel Centro assistenza Looker facendo clic su Contattaci.

Se hai un'istanza di Looker ospitata dal cliente, assicurati che l'applicazione che utilizzerà l'incorporamento SSO utilizzi lo stesso dominio dell'istanza di Looker.

Controllare la visibilità dei client con un sistema chiuso

In genere, in una configurazione di incorporamento SSO gli utenti di Looker presentano dati ai propri clienti mentre hanno clienti di aziende o gruppi diversi che non devono essere a conoscenza gli uni degli altri. In questo scenario, per salvaguardare le informazioni private dei tuoi clienti, ti consigliamo vivamente di configurare Looker come un sistema chiuso, chiamato anche installazione multitenant. In un sistema chiuso, i contenuti sono isolati per impedire a utenti di gruppi diversi di avere informazioni sugli altri. Per questo motivo, ti consigliamo di abilitare l'opzione Sistema chiuso prima di consentire a qualsiasi utente esterno di accedere 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 per le analisi incorporate.

Generazione della chiave segreta di Looker

Per verificare che una richiesta di incorporamento SSO sia legittima e non sia stata falsificata da qualcun altro, devi prima generare un "secret incorporato". Ecco come fare:

1. Vai alla pagina Embed (Incorpora) nella sezione Admin (Amministrazione) di Looker.
2. Seleziona Abilitata dal menu a discesa Incorpora autenticazione SSO, quindi fai clic su Aggiorna.
3. Fai clic sul pulsante Reimposta secret per generare il secret di incorporamento. Assicurati di copiare questo secret in una posizione sicura, perché non potrai più recuperarlo da Looker senza reimpostarlo. La reimpostazione della chiave comporterà l'interruzione di tutti gli incorporamenti che utilizzavano la chiave precedente.

Chiunque abbia accesso alla chiave segreta può creare un URL per accedere a qualsiasi modello a cui l'istanza di Looker è connessa, come qualsiasi utente, con qualsiasi autorizzazione. Proteggi il secret di incorporamento SSO come faresti con le credenziali amministrative dell'istanza di Looker incorporata e mantieni disabilitato l'incorporamento SSO se non lo utilizzi.

Creare l'URL di incorporamento

Per creare l'URL corretto dovrai scrivere 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 nostro repository GitHub di esempi SSO. Le seguenti sezioni spiegano le informazioni che dovrai fornire a questi script.

Raccolta delle informazioni di Looker necessarie

Come punto di partenza per la creazione del tuo URL, innanzitutto vuoi determinare tutte le informazioni che dovrai 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 posiziona /embed prima del percorso, come segue:

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 includono 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 query di 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=. In alternativa, 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	/embed/dashboards/1
Dashboard legacy 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 legacy	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 abbia un impatto sui contenuti e di cui non è stato eseguito il deployment in produzione non verrà visualizzata in un incorporamento.

Autorizzazioni

Un set di autorizzazioni definisce le azioni che un utente o un gruppo può eseguire. 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 incorporati con autorizzazioni 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 che vuoi concedere all'utente. Il seguente elenco mostra tutte le autorizzazioni disponibili per l'incorporamento SSO. Le autorizzazioni non incluse nel seguente elenco non sono supportate per l'incorporamento SSO:

Autorizzazione	Dipende	Tipo	Definizione
access_data	Nessuno	Specifico per il modello	Consente all'utente di accedere ai dati (obbligatorio per visualizzare Look, dashboard o Esplorazioni)
see_lookml_dashboards	access_data	Specifico per il modello	Consenti 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 incorporamento
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 tabulari in un'esplorazione
create_custom_fields	explore	A livello di istanza	AGGIUNTO 22.4 necessaria 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 all'utente di apportare e salvare le modifiche a Look e dashboard
send_outgoing_webhook	see_looks	Specifico per il modello	Consente all'utente di pianificare le dashboard e l'aspetto di un webhook arbitrario
send_to_s3	see_looks	Specifico per il modello	Consente all'utente di pianificare dashboard e Look a un bucket Amazon S3
send_to_sftp	see_looks	Specifico per il modello	Consente all'utente di pianificare le dashboard e l'aspetto di un server SFTP
schedule_look_emails	see_looks	Specifico per il modello	Consenti all'utente di pianificare le dashboard e l'invio di Look al proprio indirizzo email (che è impostato con un attributo utente denominato "email") o a un indirizzo email che rientra nelle limitazioni impostate dalla lista consentita dei domini email. Consente all'utente con autorizzazioni di create_alerts di inviare notifiche di avviso a un indirizzo email che rientra 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 dashboard e l'aspetto a qualsiasi email. Consente all'utente con autorizzazioni di 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 vengono soddisfatte o superate. Gli utenti possono modificare, duplicare ed eliminare i loro avvisi e quelli di altri utenti. Pubblico. Se l'area di lavoro di Slack dell'utente non è connessa all'istanza di Looker, l'utente 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 applicare limiti
see_sql	see_looks	Specifico per il modello	Consente all'utente di visualizzare il linguaggio 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 cancellare la cache e aggiornare le dashboard incorporate, le dashboard precedenti, i riquadri della dashboard, i Look e le esplorazioni.
see_drill_overlay	access_data	Specifico per il modello	Consente all'utente di eseguire il drill-down senza dover accedere alla pagina Esplora completa.
embed_browse_spaces	Nessuno	A livello di istanza	Attiva il browser dei contenuti in modo che l'utente possa sfogliare le cartelle di un incorporamento. A ogni utente incorporato a cui viene concessa l'autorizzazione embed_browse_spaces viene concesso l'accesso a una cartella di incorporamento personale e alla cartella Condivisi della tua organizzazione, se presente. L'autorizzazione embed_browse_spaces è consigliata agli utenti in possesso dell'autorizzazione save_content, in modo che l'utente possa sfogliare le cartelle quando seleziona dove salvare i contenuti. Per vedere i contenuti nelle cartelle, l'utente deve avere anche le autorizzazioni see_looks, see_user_dashboards e see_lookml_dashboards.
embed_save../_shared_space	Nessuno	A livello di istanza	AGGIUNTO 21.4 Consente all'utente che dispone anche dell'autorizzazione save_content di accedere alla cartella Condivisi dell'organizzazione, se presente, nella finestra di dialogo Salva. Gli utenti che dispongono dell'autorizzazione save_content, ma non dell'autorizzazione embed_save_shared_space, potranno salvare solo i contenuti nella cartella di incorporamento personale. L'autorizzazione embed_save_shared_space non sostituisce le autorizzazioni di accesso ai contenuti. Ad esempio, per abilitare il salvataggio dell'utente nella cartella Shared, devono comunque richiedere l'accesso Manage Access, Edit (Gestione accesso, modifica) alla cartella Shared. Inoltre, la mancanza dell'autorizzazione embed_save_shared_space non impedisce a un utente con l'autorizzazione save_content e con l'accesso Gestione accesso, modifica della cartella Condivisi di salvare i contenuti in quella posizione se ha un metodo alternativo per accedere alla cartella Condivisi, ad esempio utilizzando l'opzione Esplora da qui da una dashboard incorporata.

Accesso al modello

Stabilisci a quali modelli LookML deve accedere l'utente. Si tratta semplicemente di un elenco di nomi di modello.

Attributi utente

Stabilisci quali attributi dell'utente deve avere l'utente, se presenti. Avrai bisogno del nome dell'attributo utente di Looker e del valore che l'utente deve avere per quell'attributo.

Gruppi

Stabilisci a quali gruppi dovrebbe appartenere l'utente. Dovrai utilizzare gli ID dei gruppi e non i 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 di Looker. Gli utenti di incorporamento SSO avranno accesso a tutte le cartelle condivise con i membri dei loro gruppi Looker.

Puoi anche utilizzare il parametro external_group_id per creare un gruppo esterno ai normali gruppi Looker. In tal caso, gli utenti di incorporamento SSO con lo stesso external_group_id avranno accesso a una cartella condivisa, denominata "Group," 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 Amministratore di Looker. Se i parametri permissions, models e group_ids sono tutti specificati nell'URL di incorporamento, il ruolo incorporato è additivo per tutti i ruoli già assegnati ai gruppi elencati nel parametro group_ids. Questo è lo stesso dei ruoli standard poiché tutti i ruoli in Looker sono cumulativi.

Ad esempio, supponiamo che tu abbia un gruppo esistente in Looker con l'ID gruppo 1 e che abbia già l'autorizzazione explore per un modello denominato model_one e crei un URL di incorporamento con i seguenti parametri:

• group_ids = [1]
• permissions = ["access_data","see_looks"]
• models = ["model_two"]

In tal 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 di incorporamento

Un URL di incorporamento SSO ha il seguente formato:

https://HOST/login/incorporamento/URL YOUTUBE?PARAMETRI&signature=SIGNATURE

Host

L'host è la posizione in cui viene ospitata l'istanza di Looker. Ad esempio, analytics.mycompany.com. Assicurati di includere il numero di porta se non hai attivato il port forwarding, ad esempio analytics.mycompany.com:9999.

Incorpora URL

L'URL di 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

Ciò significa che il pattern /embed//embed/ verrà visualizzato nell'URL finale; questo è corretto.

Se utilizzi eventi JavaScript incorporati, assicurati di aggiungere un elemento 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. Quindi, se avessi 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 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 sfruttare le 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 obbligatorio?	Descrizione	Tipo di dati	Esempio
nonce	Sì	Qualsiasi stringa casuale ti piace, ma non può essere ripetuta entro un'ora e deve contenere meno di 255 caratteri. In questo modo impedisci a un utente malintenzionato di inviare di nuovo l'URL di un utente legittimo per raccogliere informazioni che non dovrebbe avere.	Stringa JSON	"22b1ee700ef3dc2f500fb7"
time	Sì	L'ora corrente come timestamp UNIX.	Numero intero	1407876784
session_length	Sì	Il numero di secondi per cui l'utente deve rimanere connesso a Looker, compreso tra 0 e 2.592.000 secondi (30 giorni).	Numero intero	86400
external_user_id	Sì	Un identificatore di ciascun utente nell'applicazione che incorpora Looker. Looker utilizza external_user_id per differenziare gli utenti di incorporamento SSO, quindi ogni utente deve avere un ID univoco assegnato. Puoi creare un external_user_id per un utente con qualsiasi stringa, a condizione che sia univoco per l'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 diverse per utenti diversi interattivi e assicurati di non utilizzare lo stesso external_user_id per un singolo utente con autorizzazioni, valori di attributi 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 altrimenti set di dati che potrebbero non essere visibili.	Stringa JSON	"user-4"
permissions	Sì	L'elenco delle autorizzazioni che l'utente deve avere. Per informazioni, consulta la sezione Autorizzazioni in questa pagina.	Array di stringhe	[   "access_data",   "see_looks" ]
models	Sì	L'elenco dei nomi dei modelli a cui l'utente deve avere accesso.	Array di stringhe	[   "model_one",   "model_two" ]
group_ids	No	L'elenco dei gruppi Looker di cui l'utente deve essere membro, se presente. Utilizza gli ID gruppo al posto dei nomi.	Array di numeri interi	[4, 3]
external_group_id	No	Un identificatore univoco del gruppo a cui appartiene l'utente nell'applicazione che incorpora Looker, se necessario. Gli utenti che sono autorizzati a salvare i contenuti e a condividere un ID gruppo esterno possono salvare e modificare i contenuti in una cartella di Looker condivisa denominata "quot;Group".".	Stringa JSON	"Accounting"
user_attributes	No	L'elenco degli attributi utente di cui l'utente deve eventualmente disporre. Contiene un elenco di nomi di attributi utente seguiti dal valore di attributo utente. Se il tuo modello LookML è localizzato, puoi utilizzare l'attributo utente locale nell'URL di incorporamento per specificare una lingua per l'incorporamento. Ad esempio, l'inclusione del parametro user_attributes { "locale" : "fr_FR" } comporta il caricamento della lingua francese per l'incorporamento.	Hash di stringhe	{   "vendor_id" : "17",   "company" : "xactness" }
access_filters	Sì	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	No	Il nome dell'utente. Se il campo viene lasciato vuoto, first_name conserverà il valore dell'ultima richiesta oppure, se non è stato impostato alcun nome, verrà utilizzato"Incorpora".	Stringa JSON	"Alice"
last_name	No	Il cognome dell'utente. Se il campo viene lasciato vuoto, last_name conserverà il valore dell'ultima richiesta oppure, se non è stato impostato il cognome, verrà impostato "&Incorpora".	Stringa JSON	"Jones"
user_timezone	No	Se hai attivato i fusi orari specifici dell'utente, imposta il valore dell'opzione Fuso orario dello spettatore nel menu a discesa Fuso orario nella dashboard o nel look incorporato. 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 fuso orario di incorporamento SSO. Suggerimento del team di Chat: se vuoi che i contenuti incorporati vengano impostati automaticamente sul fuso orario dello spettatore, utilizza uno dei seguenti metodi: Aggiungi il parametro ?query_timezone=user_timezone all'URL di incorporamento. Ad esempio: /embed/dashboards/1?query_timezone=user_timezone Salva la dashboard incorporata o il look con il fuso orario predefinito impostato su Fuso orario del visualizzatore, che utilizzerà il fuso orario dell'utente per impostazione predefinita sia per gli utenti incorporati sia per quelli che non lo fanno.	Stringa JSON o null	"US/Pacific" oppure - null
force_logout_login	Sì	Se un utente normale di 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 credenziali attuali oppure 2) deve essere disconnesso e accedere di nuovo con le credenziali SSO.	Booleano (true [vero] o false [falso])	true

Tutti i parametri precedenti sono obbligatori, ma qualsiasi parametro con "No" nella colonna "Valore obbligatorio?" può essere utilizzato con un valore vuoto. Ad esempio, potresti utilizzare group_ids [] o user_attributes {}.

Firma

Per generare la firma devi seguire questi passaggi.

1. Raccogli i seguenti valori dei parametri in questo ordine:
   • Host, seguito da login/embed/ (ad esempio, analytics.mycompany.com/login/embed/)
   • Incorpora URL
   • Nonce
   • Ora corrente
   • Durata sessione
   • ID utente esterno
   • Autorizzazioni
   • Modelli
   • ID gruppi
   • ID gruppo esterno
   • Attributi dell'utente
   • Filtri di accesso (è necessario un segnaposto vuoto)
2. Formattare tutti i valori diversi dall'host e dall'URL di incorporamento come JSON
3. Concatena i valori con interruzioni di riga (\n)
4. Firma HMAC con la stringa concatenata con il secret di incorporamento Looker

Codifica

Il passaggio finale consiste nella codifica dell'URL.

Prima di codificare l'URL, un URL di incorporamento formattato in modo corretto che utilizza tutti i parametri possibili 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, l'URL 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

Utilizzare l'endpoint API create_sso_embed_url

L'API Looker include l'endpoint create_sso_embed_url, che accetta un set 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 di amministratore. Il dominio del server web deve essere presente anche nell'incorporamento della lista consentita del dominio.

Puoi anche utilizzare API Explorer per generare un URL SSO che utilizzi questo endpoint. Puoi installare Explorer API sulla tua istanza di Looker da Looker Marketplace oppure puoi 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 non riuscirà. Explorer API è anche utile 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 relativa all'uso dell'API Looker.

Test dell'URL di incorporamento

Per verificare l'URL finale, incollalo nello Strumento di convalida URI di incorporamento nella pagina Incorpora della sezione Amministratore di Looker. Questa opzione non può dirti se i dati e le autorizzazioni che credi siano stati configurati correttamente, ma possono comunque confermare che l'autenticazione funzioni correttamente.