La incorporación firmada es una forma de presentarles a los usuarios imágenes, visualizaciones, exploraciones, paneles o paneles de LookML incorporados privados sin que tengan que acceder a Looker por separado. En cambio, los usuarios se autenticarán a través de tu propia aplicación.
La incorporación firmada funciona creando una URL especial de Looker que usarás en un iframe. La URL contiene la información que deseas compartir, el ID del usuario en tu sistema y los permisos que deseas que tenga. Luego, firmarás la URL con una clave secreta proporcionada por Looker.
Para obtener información sobre la incorporación pública, consulta la sección Incorporación pública con etiquetas iframe
de la página de documentación Uso compartido, importación y incorporación pública de Looks.
Antes de que puedas usar la incorporación firmada en tu instancia de Looker, un administrador de Looker debe habilitar la incorporación firmada en el panel de administrador de Looker y crear una clave secreta de incorporación. Para obtener instrucciones, consulta la página de documentación Comienza a usar la incorporación: habilita la incorporación firmada.
Alojamiento adecuado para la incorporación firmada
Algunos navegadores (por ejemplo, Safari o aquellos con extensiones instaladas que bloquean anuncios o cookies de seguimiento) utilizan de forma predeterminada una política de cookies que bloquea las cookies de terceros. Cuando se habilita la función Inserción sin cookies, los navegadores que bloquean las cookies de terceros pueden autenticar a los usuarios en el iframe incorporado en diferentes dominios. La autenticación de incorporación sin cookies requiere configuración del servidor. Consulta la página de documentación sobre la incorporación sin cookies para ver ejemplos de configuración.
Si no está habilitada la función Inserción sin cookies, Looker usa cookies para la autenticación de usuarios. En este caso, no es posible intentar autenticar el iframe incorporado en diferentes dominios en los navegadores que bloquean las cookies de terceros (a menos que el usuario modifique la configuración de privacidad de las cookies del navegador). Por ejemplo, si deseas incorporar información en https://mycompany.com
, debes asegurarte de que Looker comparta el mismo dominio, como https://analytics.mycompany.com
. En este caso, si Looker aloja tu instancia, comunícate con el equipo de asistencia de Looker para configurar el DNS necesario y habilitar el uso de dominios personalizados. Esto permitirá que Looker comparta el mismo dominio que la aplicación incorporada y use cookies propias, que se aceptan de forma predeterminada en todos los navegadores.
Si tienes una instancia de Looker alojada por el cliente, asegúrate de que la aplicación que usará la incorporación firmada use el mismo dominio que tu instancia de Looker.
Cómo controlar la visibilidad de los clientes con un sistema cerrado
En una configuración de incorporación firmada, es común que los usuarios de Looker presenten datos a sus propios clientes y, al mismo tiempo, tengan clientes de diferentes empresas o grupos que no deberían conocerse entre sí. En este caso, para proteger la seguridad información privada, te recomendamos que configures Looker como un sistema cerrado, también llamado instalación multiusuario. En un sistema cerrado, el contenido se aísla para evitar que los usuarios de diferentes grupos se conozcan entre sí. Por este motivo, te recomendamos que habilites la opción de sistema cerrado antes de otorgar acceso a tu instancia a cualquier usuario externo.
Para obtener más información, consulta las páginas de documentación Diseña y configura un sistema de niveles de acceso y Prácticas recomendadas de seguridad para estadísticas incorporadas.
Cómo generar la URL de incorporación firmada
Existen varias formas de generar la URL de incorporación firmada. Puedes usar uno de estos métodos:
Puedes generar una URL de incorporación firmada con la opción Obtener URL de incorporación en el menú de tres puntos del panel de un panel o en el menú de ajustes de acciones de Explorar de una función de Búsqueda o Explorar.
Usa el extremo Create Signed Embed Url de la API de Looker, como se describe más adelante en este documento.
Usa el SDK de incorporación de Looker.
Crea la URL de incorporación firmada. Para crear la URL correcta, deberás escribir código para que puedas codificar correctamente la URL con tu clave secreta y generar otros elementos relacionados con la seguridad. Puedes encontrar varias secuencias de comandos de muestra en el repositorio de GitHub de ejemplos de incorporación de Looker. En las siguientes secciones, se explica la información que deberás proporcionar a esas secuencias de comandos, así como cómo compilar una URL de incorporación firmada sin usar una secuencia de comandos.
Programación manual de la URL de incorporación firmada
Para codificar la URL de incorporación firmada, primero recopila la información necesaria de Looker y, luego, crea la URL de incorporación firmada.
Recopila la información necesaria de Looker
Como punto de partida para crear tu URL, primero deberás determinar toda la información que deberás incluir. Necesitarás:
Incorporar URL
Recupera la URL de la vista, la exploración, la visualización de consulta o el panel que deseas incorporar. Luego, quita el dominio y coloca /embed
antes de la ruta de acceso, de la siguiente manera:
Elemento | Patrón de URL normal | Incorporar URL |
---|---|---|
Vista | https://instance_name.looker.com/looks/4 |
/embed/looks/4 |
Explorar | https://instance_name.looker.com/explore/my_model/my_explore |
/embed/explore/my_model/my_explore |
Visualización de la consulta | https://instance_name.looker.com/explore/my_model/my_explore?qid=1234567890abcdefghij12 Los 22 caracteres alfanuméricos que siguen al parámetro qid= en la URL de Explorar comprenden el Query.client_id . El valor Query.client_id es una cadena única que representa la consulta y la configuración de visualización.Para incorporar una visualización de consulta, recupera el valor Query.client_id de la visualización de consulta y copia el Query.client_id en tu URL incorporada.Puedes usar la IU de Explorar de Looker para crear una consulta con una visualización compatible y copiar el valor Query.client_id del parámetro qid= , o bien puedes recuperar el Query.client_id con la API de Looker, por ejemplo, con el método Get Query . |
/embed/query-visualization/Query.client_id |
Panel definido por el usuario | https://instance_name.looker.com/dashboards/1 Incluye cualquier valor de filtro del panel o, si ocultas valores de filtro, el parámetro hide_filter en la URL del panel. |
|
Panel heredado definido por el usuario | https://instance_name.looker.com/dashboards-legacy/1 |
/embed/dashboards-legacy/1 |
panel de LookML | https://instance_name.looker.com/dashboards/my_model::my_dashboard |
/embed/dashboards/my_model::my_dashboard |
Panel heredado de LookML | https://instance_name.looker.com/dashboards-legacy/my_model::my_dashboard |
/embed/dashboards-legacy/my_model::my_dashboard |
El contenido incorporado siempre refleja la versión de producción del contenido. Los cambios realizados en el modo de desarrollo que afecten al contenido y que no se hayan implementado en producción no aparecerán en una incorporación.
Permisos
Un conjunto de permisos define lo que puede hacer un usuario o un grupo. Los permisos se pueden aplicar de una de estas dos maneras:
- Específico del modelo: Este tipo de permiso se aplica solo a los conjuntos de modelos que forman parte del mismo rol.
- Para toda la instancia: Este tipo de permiso se aplica a la instancia de Looker en su totalidad. Los usuarios incorporados con permisos para toda la instancia pueden realizar ciertas funciones en toda la instancia de Looker, pero no pueden acceder al contenido basado en modelos que no se incluyen en el conjunto de modelos de su rol.
Determina los permisos que deseas que tenga el usuario. En la siguiente lista, se muestran todos los permisos disponibles para la incorporación firmada. Los permisos que no se encuentran en la siguiente lista no son compatibles con la incorporación firmada:
Permiso | Depende de | Tipo | Definición |
---|---|---|---|
access_data |
Ninguno | Específico del modelo | Permite que el usuario acceda a los datos (obligatorio para ver looks, paneles o exploraciones) |
see_lookml_dashboards |
access_data |
Específico del modelo | Le permite al usuario ver los paneles de LookML |
see_looks |
access_data |
Específico del modelo | Permite que el usuario vea las miradas. |
see_user_dashboards |
see_looks |
Específico del modelo | Permite que el usuario vea paneles definidos por el usuario y explore carpetas desde una incorporación. |
explore |
see_looks |
Específico del modelo | Permite que el usuario vea las páginas de Explorar |
create_table_calculations |
explore |
Ancho de la instancia | Es necesario crear cálculos de tablas en una exploración |
create_custom_fields |
explore |
A nivel de la instancia | AGREGA 22.4 Es necesario crear campos personalizados en una exploración. |
can_create_forecast |
explore |
Ancho de la instancia | AGREGA 22.12 Permite a los usuarios crear o editar previsiones en visualizaciones. |
save_content |
see_looks |
Ancho de la instancia | Permite que el usuario realice y guarde cambios en las Vistas y los paneles |
send_outgoing_webhook |
see_looks |
Específico del modelo | Permite al usuario programar las entregas de contenido de Looker a un webhook arbitrario |
send_to_s3 |
see_looks |
Específico del modelo | Permite que el usuario programe publicaciones de contenido de Looker en un bucket de Amazon S3. |
send_to_sftp |
see_looks |
Específico del modelo | Permite que el usuario programe publicaciones de contenido de Looker en un servidor SFTP. |
schedule_look_emails |
see_looks |
Específico del modelo | Permite que el usuario programe las entregas de contenido de Looker a su propio correo electrónico (si se configuró con un atributo de usuario llamado “correo electrónico”) o a una dirección de correo electrónico que esté dentro de las limitaciones establecidas en la lista de entidades permitidas de dominios de correo electrónico. Permite que el usuario con permisos create_alerts envíe notificaciones de alerta a una dirección de correo electrónico que esté dentro de las limitaciones establecidas en la lista de entidades permitidas de dominios de correo electrónico. |
schedule_external_look_emails |
schedule_look_emails |
Específico del modelo | Permite que el usuario programe las entregas de contenido de Looker a cualquier dominio de correo electrónico. Permite que el usuario con permisos create_alerts envíe notificaciones de alerta a cualquier dominio de correo electrónico. |
send_to_integration |
see_looks |
Específico del modelo | Permite que el usuario envíe contenido de Looker a los servicios de terceros integrados en Looker a través del Action Hub de Looker. Este permiso no se relaciona con las acciones de datos. |
create_alerts |
see_looks |
A nivel de la instancia | Permite que el usuario cree alertas en las tarjetas del panel para recibir notificaciones cuando se cumplan o se superen condiciones especificadas. Los usuarios pueden editar, duplicar y borrar sus propias alertas y las de otros usuarios. Alertas públicas. Si el espacio de trabajo de Slack del usuario no está conectado a la instancia de Looker, no podrá crear alertas que envíen notificaciones a Slack. |
download_with_limit |
see_looks |
A nivel de la instancia | Permite que el usuario descargue los resultados de una consulta con un límite aplicado. |
download_without_limit |
see_looks |
A nivel de la instancia | Permite que el usuario descargue los resultados de una consulta sin límite aplicado. |
see_sql |
see_looks |
Específico del modelo | Permite que el usuario vea el SQL de las consultas y cualquier error de SQL que resulte de la ejecución de consultas |
clear_cache_refresh |
access_data |
Específico del modelo | SE AGREGARON 21.14 Los usuarios pueden borrar la caché y actualizar los paneles incorporados, los paneles heredados, las tarjetas de panel, los Looks y las Exploraciones. |
see_drill_overlay |
access_data |
Específico del modelo | Permite que el usuario analice sin necesidad de ir a la página Explorar completa. |
embed_browse_spaces |
Ninguno | Ancho de la instancia | Habilita el navegador de contenido para que un usuario pueda examinar las carpetas desde una incorporación. Cualquier usuario incorporado al que se le haya otorgado el permiso embed_browse_spaces recibirá acceso a una carpeta de incorporación personal y a la carpeta Compartido de tu organización, si hay una. Se recomienda el permiso embed_browse_spaces a los usuarios que tienen el permiso save_content , de modo que puedan explorar carpetas cuando seleccionen dónde guardar el contenido. Para ver el contenido de las carpetas, el usuario también necesita los permisos see_looks , see_user_dashboards y see_lookml_dashboards . |
embed_save_shared_space |
Ninguno | A nivel de la instancia |
SE AGREGARON 21.4
Permite que el usuario que también tiene el permiso save_content navegue a la carpeta Compartida de la organización, si la hay, desde el cuadro de diálogo Guardar. Los usuarios que tengan el permiso save_content , pero no el permiso embed_save_shared_space , solo tendrán la opción de guardar contenido en su carpeta de incorporación personal.El permiso embed_save_shared_space no anula los permisos de acceso al contenido. Por ejemplo, para permitir que el usuario pueda guardar contenido en la carpeta Compartido, el usuario aún necesita el acceso de Administrar acceso, Editar a la carpeta Compartido. Además, la falta del permiso embed_save_shared_space no impide que un usuario que tenga el permiso save_content y el acceso Administrar acceso, Editar a la carpeta Compartido guarde contenido allí si tiene una forma alternativa de navegar a la carpeta Compartido, como usar la opción Explorar desde aquí desde un panel incorporado. |
Acceso al modelo
Determina a qué modelos de LookML debe tener acceso el usuario. Esta será simplemente una lista de nombres de modelos.
Atributos de usuario
Determina qué atributos del usuario debe tener el usuario, si corresponde. Necesitarás el nombre del atributo del usuario de Looker, así como el valor que el usuario debe tener para ese atributo.
Grupos
Determina a qué grupos debe pertenecer el usuario, si corresponde. Necesitarás los IDs de los grupos en lugar de los nombres de los grupos. Agregar un usuario incorporado firmado a un grupo de Looker te permite administrar el acceso de ese usuario a las carpetas de Looker. Los usuarios incorporados firmados tendrán acceso a cualquier carpeta que se comparta con los miembros de sus grupos de Looker.
También puedes usar el parámetro external_group_id
para crear un grupo externo a los grupos normales de Looker. En ese caso, los usuarios incorporados firmados con el mismo external_group_id
tendrán acceso a una carpeta compartida, llamada “Grupo”, que es exclusiva del grupo externo.
Roles incorporados
Los parámetros permissions
y models
crean una función para el usuario incorporado. Este rol aparece como "Rol incorporado" en la página Usuarios de la sección Administrador de Looker. Si los parámetros permissions
, models
y group_ids
se especifican en la URL de incorporación, el rol incorporado es aditivo a cualquier rol que ya se haya asignado a los grupos que se indican en el parámetro group_ids
. Esto es igual a los roles estándar, ya que todos los roles en Looker son aditivos.
Por ejemplo, supongamos que tienes un grupo existente en Looker con el ID del grupo 1
, que ya tiene el permiso explore
para un modelo llamado model_one
, y creas una URL de incorporación con los siguientes parámetros:
group_ids
=["1"]
permissions
=["access_data","see_looks"]
models
=["model_two"]
En ese caso, el usuario incorporado heredará la capacidad de ver y explorar los datos en model_one
, y el rol de incorporación creado con los parámetros anteriores también permitirá ver los datos en model_two
.
Cómo crear la URL incorporada
Una URL de incorporación firmada tiene el siguiente formato:
https://HOST/login/embed/URL DE INCORPORACIÓN?PARÁMETROS&signature=SIGNATURE
Host
El host es la ubicación en la que se aloja tu instancia de Looker. Por ejemplo, analytics.mycompany.com
. Asegúrate de incluir el número de puerto si no habilitaste la redirección de puertos, como analytics.mycompany.com:9999
.
Incorporar URL
La URL de incorporación se determinó anteriormente. Tendrá un formato como el siguiente:
/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
Esto significa que el patrón /embed//embed/
aparecerá en tu URL final, lo cual es correcto.
Si usas eventos de JavaScript incorporados, asegúrate de agregar un embed_domain
(el dominio en el que se usa el iframe) al final de la URL de incorporación, de la siguiente manera:
/embed/looks/4
/embed/looks/4?embed_domain=https://mywebsite.com
embed_domain
se agrega después de la URL incorporada y antes de los parámetros. Por lo tanto, si tuvieras parámetros existentes, como nonce=626
, la adición de embed_domain
se vería de la siguiente manera:
/embed/looks/4?nonce=626
/embed/looks/4?embed_domain=https://mywebsite.com?nonce=626
Si usas el SDK de incorporación, asegúrate de agregar embed_domain
y también incluir sdk=2
al final de la URL de incorporación, de la siguiente manera:
/embed/looks/4
/embed/looks/4?embed_domain=https://mywebsite.com&sdk=2
El parámetro sdk=2
permite que Looker identifique que el SDK está presente y puede aprovechar funciones adicionales que proporciona el SDK. El SDK no puede agregar este parámetro por sí mismo porque forma parte de la URL firmada.
Parámetros
Los siguientes parámetros de URL se usan para especificar la información necesaria de la incorporación firmada:
Parámetro | Valor predeterminado | Descripción | Tipo de datos | Ejemplo |
---|---|---|---|---|
nonce |
Valor obligatorio | Cualquier cadena aleatoria que quieras, pero que no se puede repetir en una hora y debe tener menos de 255 caracteresEsto evita que un atacante vuelva a enviar la URL de un usuario legítimo para recopilar información que no debería tener. | Cadena JSON | "22b1ee700ef3dc2f500fb7" |
time |
Valor obligatorio | La hora actual como marca de tiempo UNIX. | Número entero | 1407876784 |
session_length |
Valor obligatorio | Es la cantidad de segundos que el usuario debe permanecer conectado a Looker, entre 0 y 2,592,000 segundos (30 días). | Número entero | 86400 |
external_user_id |
Valor obligatorio | Un identificador para cada usuario en la aplicación que incorpora Looker. Looker usa external_user_id para diferenciar a los usuarios incorporados firmados, por lo que cada usuario debe tener asignado un ID único.Puedes crear un external_user_id para un usuario con cualquier cadena que desees, siempre que sea única para ese usuario. Cada ID está asociado con un conjunto de permisos, atributos de usuario y modelos. Un solo navegador puede admitir solo una external_user_id , o sesión de usuario, a la vez. No se pueden realizar cambios en los permisos ni los atributos de un usuario durante la sesión.Por motivos de seguridad, asegúrate de no usar el mismo external_user_id en diferentes sesiones de incorporación para diferentes usuarios interactivos y de no usar el mismo external_user_id para un solo usuario que tenga diferentes permisos, valores de atributos del usuario o acceso al modelo.El uso del mismo external_user_id para varios usuarios o para el mismo usuario con varios permisos, atributos de usuario o conjuntos de modelos puede hacer que los datos sean visibles para usuarios que, de otro modo, no tendrían acceso a ellos. |
String de JSON | "user-4" |
permissions |
Valor obligatorio | Es la lista de permisos que debe tener el usuario.Consulta la sección Permisos en esta página para obtener la lista de permisos permitidos. | Arreglo de strings | [ "access_data", "see_looks" ] |
models |
Valor obligatorio | La lista de nombres de modelos a los que el usuario debería tener acceso. | Arreglo de strings | [ "model_one", "model_two" ] |
group_ids |
[] | La lista de grupos de Looker de los que el usuario debe ser miembro, si corresponde. Usa los IDs de los grupos en lugar de los nombres de los grupos. | Arreglo de strings | ["4", "3"] |
external_group_id |
"" | Es un identificador único para el grupo al que pertenece el usuario en la aplicación que incorpora Looker, si lo deseas.Los usuarios que tengan permiso para guardar contenido y compartir un ID de grupo externo podrán guardar y editar contenido en una carpeta compartida de Looker llamada “Grupo”. El parámetro external_group_id es el único método disponible para crear grupos externos de usuarios incorporados. No hay forma de configurar grupos de usuarios incorporados externos desde la IU de Looker. |
String de JSON | "Accounting" |
user_attributes |
{} | Es la lista de atributos de usuario que el usuario debería tener, si corresponde. Contiene una lista de nombres de atributos de usuario seguidos del valor del atributo de usuario.Si tu modelo de LookML está localizado, puedes usar el atributo de usuario locale en la URL incorporada para especificar un idioma para la incorporación. Por ejemplo, incluir el parámetro user_attributes { "locale" : "fr_FR" } provocaría que la incorporación cargue el francés como su idioma. |
Hash de cadenas | { "vendor_id" : "17", "company" : "xactness" } |
access_filters |
Valor obligatorio | En Looker 3.10, se quitó este parámetro, pero aún es obligatorio en la URL. Usa access_filters con un marcador de posición vacío, por ejemplo, access_filters={} . |
Marcador de posición vacío | {} |
first_name |
"" | Es el nombre del usuario. Si se deja en blanco, first_name retendrá el valor de la última solicitud o será "Incorporar" si nunca se ha establecido un nombre. |
String de JSON | "Alice" |
last_name |
"" | Apellido del usuario. Si se deja en blanco, last_name retendrá el valor de la última solicitud o será "Embed" si nunca se configuró un apellido. |
String de JSON | "Jones" |
user_timezone |
"" | Si habilitaste las Zonas horarias específicas del usuario, establece el valor de la opción Zona horaria del usuario en el menú desplegable Zona horaria de la vista o el panel incorporados. Este parámetro no cambia directamente la zona horaria en la que se muestra el contenido. el usuario deberá seleccionar una zona horaria del menú desplegable.Consulta los valores válidos en la página de documentación Referencia de la zona horaria de incorporación firmada.Sugerencia para el equipo de Chat: Si quieres que el contenido incorporado tenga la zona horaria predeterminada del usuario, usa uno de los siguientes métodos:?query_timezone=user_timezone a la URL de incorporación. Por ejemplo:/embed/dashboards/1?query_timezone=user_timezone |
Cadena JSON o nulo | "US/Pacific" - o -null |
force_logout_login |
Valor obligatorio | Si un usuario normal de Looker ya accedió a Looker y ve un elemento incorporado firmado, puedes elegir una de las siguientes opciones:1) deben ver el elemento con sus credenciales actualeso2) Debe salir y volver a acceder con las credenciales de incorporación firmadas. | Booleano (verdadero o falso) | true |
Firma
Looker usa la firma para verificar que se usó el secreto de incorporación correcto para generar la firma en la URL de incorporación y que los parámetros de la URL de incorporación no hayan cambiado. Si el secreto de incorporación o los parámetros de URL son diferentes o cambiaron, la firma no coincidirá y se rechazará la autenticación.
Como resultado, la firma en la URL de incorporación proporciona una prueba criptográficamente sólida de que la URL de incorporación no se modificó en tránsito y que la creó una parte de confianza que tiene la clave secreta de incorporación.
Para generar la firma, deberás seguir estos pasos.
- Recopila los siguientes valores de parámetros en este orden:
- Host, seguido de
login/embed/
(por ejemplo,analytics.mycompany.com/login/embed/
) - Incorporar URL
- Nonce
- Hora actual
- Duración de la sesión
- ID de usuario externo
- Permisos
- Modelos
- IDs de grupo
- ID del grupo externo
- Atributos de usuario
- Filtros de acceso (requiere un marcador de posición vacío)
- Host, seguido de
- Formatea todos los valores, excepto Host y Embed URL, como JSON.
- Concatena los valores con saltos de línea (
\n
) - Firma la cadena concatenada con el algoritmo HMAC-SHA1 con tu clave secreta de incorporación de Looker.
Codificación
El último paso es codificar la URL como una URL.
Antes de codificar la URL, una URL incorporada con el formato correcto que usa todos los parámetros posibles podría verse de la siguiente manera:
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
Como se indicó anteriormente, es correcto que /embed//embed/
aparezca en tu URL.
Después de codificar la URL, se verá de la siguiente manera:
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
Cómo usar el extremo de la API de Create Signed Embed Url
La API de Looker incluye el extremo Create Signed Embed Url, que toma un conjunto de parámetros de incorporación firmados que incluyen la URL del contenido que deseas incorporar y muestra una URL completa, codificada y firmada de forma criptográfica.
Para usar este extremo de API desde un servidor web, este debe poder autenticarse en la API de Looker con privilegios de administrador. El dominio del servidor web también debe aparecer en la Lista de dominios de incorporación permitidos.
También puedes usar el Explorador de APIs para generar una URL firmada que use este extremo. Puedes instalar el Explorador de APIs en tu instancia de Looker desde Looker Marketplace. Una vez generada, la URL firmada se debe copiar exactamente y se puede usar solo una vez; de lo contrario, fallará. El Explorador de APIs también es útil para generar una URL firmada y compararla con una URL firmada creada de forma manual para solucionar problemas.
Para obtener más información sobre la API de Looker, consulta la página de documentación Comienza a usar la API de Looker.
Cómo probar la URL incorporada
Para probar la URL final, pégala en el Validador de URI de incorporación en la página Incorporar de la sección Administrador de Looker. Si bien esta opción no puede indicarte si los datos y permisos que imaginas se configuraron correctamente, puede validar que la autenticación funcione correctamente.