Crea una sessione di incorporamento senza cookie

Versione 4.0.23.2

Acquisire una sessione di incorporamento senza cookie.

L'endpoint di acquisizione della sessione ignora la necessità di firmare l'URL di incorporamento e di trasmetterlo come parametro all'accesso di incorporamento. Questo endpoint accetta una definizione di utente incorporata e lo crea se non esiste, altrimenti lo riutilizza. Tieni presente che questo endpoint non aggiorna l'utente, gli attributi utente o gli attributi di gruppo se l'utente di incorporamento esiste già. Si tratta di un comportamento analogo a quello per l'incorporamento dell'accesso SSO.

L'endpoint accetta anche un session_reference_token facoltativo. Se la sessione è scaduta e le credenziali corrispondono a quelle della sessione di incorporamento, verrà generato un nuovo token di autenticazione. Ciò consente alla sessione di incorporamento di collegare un nuovo IFRAME incorporato alla sessione di incorporamento. Tieni presente che la sessione NON verrà estesa in questo scenario, ovvero il parametro session_length viene ignorato.

Se session_reference_token è scaduto, verrà ignorato e verrà creata una nuova sessione di incorporamento.

Se le credenziali non corrispondono alle credenziali associate a un session_reference_token esistente, viene restituito un errore 404.

L'endpoint restituisce quanto segue:

  • Token di autenticazione: un token passato all'endpoint /embed/login che crea o si collega alla sessione di incorporamento. Questo token può essere utilizzato una sola volta e ha una durata di 30 secondi.
  • Token di riferimento della sessione: un token valido per tutta la durata della sessione. Questo token viene utilizzato per generare nuovi API e token di navigazione OPPURE per creare nuovi IFRAME da incorporare.
  • Token API: dura 10 minuti. Il client Looker richiederà questo token una volta caricato nell'iframe.
  • Token di navigazione: vive per 10 minuti. Il client Looker richiederà questo token una volta caricato nell'iframe.

Richiesta

POST /embed/cookieless_session/acquire
Tipo di dati
Descrizione
Richiesta
HTTPRequest
body
HTTPBody
Espandi definizione HTTPBody...
body
Incorpora dettagli utente
Espandi definizione EmbedCookielessSessionAcquire...
lunghezza_sessione
integer
Numero di secondi di validità della sessione di incorporamento SSO dopo l'inizio della sessione di incorporamento. Il valore predefinito è 300 secondi. La durata massima della sessione accettata è 2592000 secondi (30 giorni).
force_logout_login
boolean
Quando il valore è true, la sessione di incorporamento elimina definitivamente ogni stato di accesso di Looker residuo (ad esempio nei cookie del browser) prima di creare un nuovo stato di accesso con le informazioni utente di incorporamento specificate. Il valore predefinito è true.
id_utente_esterno
string
Un valore di un sistema esterno che identifica in modo univoco l'utente di incorporamento. Poiché gli user_id degli utenti di incorporamento di Looker possono cambiare a ogni sessione di incorporamento, l'external_user_id fornisce un modo per assegnare un identificatore utente stabile e noto in più sessioni di incorporamento.
first_name
string
Nome dell'utente per l'incorporamento. Se non specificato, il valore predefinito è "Incorpora".
last_name
string
Cognome dell'utente per l'incorporamento. Se non specificato, il valore predefinito è 'Utente'
fuso orario utente
string
Imposta il fuso orario dell'utente per la sessione utente di incorporamento, se l'impostazione User Specific Timezones (Fusi orari specifici degli utenti) è abilitata nelle impostazioni di amministrazione di Looker. Un valore "null" obbliga l'utente all'incorporamento a utilizzare il fuso orario predefinito dell'applicazione Looker. Se l'impostazione Fusi orari specifici degli utenti è disattivata, DEVI omettere questa proprietà dalla richiesta. I valori di fuso orario vengono convalidati in base allo standard IANA per il fuso orario e possono essere visualizzati nell'elenco a discesa Fuso orario dell'applicazione nella pagina di amministrazione delle impostazioni generali di Looker.
autorizzazioni
stringa[]
modelli
stringa[]
id_gruppo
stringa[]
id_gruppo_esterno
string
Un valore univoco che identifica un gruppo esclusivo di incorporamento. Più utenti incorporati che utilizzano lo stesso valore "external_group_id" potranno condividere tra loro contenuti Looker. Gli utenti di contenuti e di incorporamento associati a "external_group_id" non saranno accessibili ai normali utenti Looker o agli utenti di incorporamento non associati a questo "external_group_id".
attributi_utente
oggetto
Un dizionario di coppie nome-valore che associa il nome di un attributo utente Looker a un valore.
token_riferimento_sessione
string
Token che fa riferimento alla sessione di incorporamento e viene utilizzato per generare nuovi token di autenticazione, navigazione e API.

Risposta

200: Incorpora la risposta di sessione di acquisizione senza cookie

Tipo di dati
Descrizione
token_autenticazione
string
Token monouso utilizzato per creare o collegare una sessione incorporata nel server delle applicazioni Looker.
token_autenticazione
integer
Durata del token di autenticazione in secondi.
token_navigazione
string
Token utilizzato per caricare e navigare tra le pagine Looker.
token_navigazione_ttl
integer
Durata del token di navigazione in secondi.
token_api
string
Token da utilizzare per chiamare le API Looker.
api_token_ttl
integer
Durata del token API in secondi.
token_riferimento_sessione
string
Token che fa riferimento alla sessione di incorporamento effettiva. Viene utilizzato per generare nuovi token API, navigazione e autenticazione. I token di navigazione e API sono di breve durata e devono essere aggiornati regolarmente. È necessario acquisire un nuovo token di autenticazione per ogni IFRAME creato. Il valore session_reference_token dovrebbe essere protetto, idealmente nel server di applicazioni dell'incorporamento.
token_riferimento_sessione_ttl
integer
Durata del token di riferimento della sessione in secondi. Tieni presente che questa sessione è uguale a quella effettiva.

400: Richiesta errata

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione

404: Non trovata

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione

409: Risorsa già esistente

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione

422: Errore di convalida

Tipo di dati
Descrizione
messaggio
string
Error details (Dettagli errore)
Espandi definizione ValidationErrorDetails...
campo
string
Campo con errore
codice
string
Codice di errore
messaggio
string
Messaggio informativo sull'errore
documentazione_url
string
Link alla documentazione
documentazione_url
string
Link alla documentazione

429: Troppe richieste

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione