Nesta página, vamos mostrar como configurar a incorporação particular. A opção de incorporação privada requer que você gerencie o elemento <iframe> Elemento HTML diretamente para incorporar seu conteúdo do Looker e exige que o usuário faça login no Looker separadamente do aplicativo host.
Vamos examinar este exemplo de código de embedding particular:
<iframe
src="https://instance.looker.com/embed/dashboards/4?Timeframe=14+day"
width="600"
height="300"
frameborder="0">
</iframe>
1. Criar o URL de incorporação de conteúdo
Considere um exemplo de conteúdo do Looker no URL https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day
. A partir desse URL de conteúdo do Looker, vamos construir o URL de conteúdo incorporado e definir o atributo src
do iframe para ele. Use seu URL de conteúdo do Looker durante essas etapas.
O URL de conteúdo incorporado do exemplo de código anterior é o seguinte:
O URL de conteúdo incorporado consiste em três partes:
- Nome do host: o nome do host da instância do Looker
- Caminho: caminho do URL do conteúdo do Looker com o prefixo
/embed
(com etapas extras para visualizações de consultas) - Parâmetros: parâmetros de URL que especificam filtros e temas.
O protocolo precisa ser sempre https://
. Vamos construir cada parte em detalhes.
Parte 1: nome do host
- Acesse seu conteúdo do Looker. Seguindo o URL de conteúdo do Looker de exemplo:
https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day
. - O nome do host do URL do conteúdo incorporado é
instance.looker.com
.
Parte 2: caminho
O caminho do URL do conteúdo incorporado depende do conteúdo do Looker incorporado.
Incorporar todo o conteúdo do Looker, exceto visualizações de consulta.
- Acesse seu conteúdo do Looker. Seguindo o URL de conteúdo do Looker de exemplo:
https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day
- Identifique o caminho do URL de conteúdo do Looker:
/dashboards/4
. - Insira o prefixo
/embed
no caminho do URL de conteúdo do Looker. O caminho do URL de conteúdo incorporado é/embed/dashboards/4
.
Como incorporar uma visualização de consulta
- Navegue até a visualização da consulta. URL de exemplo:
instance.looker.com/explore/my_model/my_explore?qid=1234567890abcdefghij12
- Identifique o ID do cliente da consulta. O parâmetro
qid
:1234567890abcdefghij12
é o ID do cliente da consulta que representa as configurações da consulta e das visualizações. - O caminho do URL de conteúdo incorporado é
/embed/query-visualization/
, anexado com o ID do cliente da consulta. O caminho do URL de conteúdo incorporado do exemplo é/embed/query-visualization/1234567890abcdefghij12
Parte 3: parâmetros
Os parâmetros de URL do conteúdo incorporado controlam os filtros e temas do conteúdo incorporado.
Filtros
- Acesse o URL de conteúdo do Looker.
- Ajuste manualmente os filtros do conteúdo como quiser. Para este exemplo, o URL de conteúdo resultante do Looker é:
https://instance.looker.com/dashboards/4?Timeframe=14+day
- Os parâmetros de URL de conteúdo incorporado são os parâmetros de URL de conteúdo do Looker, por exemplo,
Timeframe=14+day
Neste exemplo, o parâmetro Timeframe=14+day
define o valor do filtro Timeframe
do painel.
Temas
Confira o guia de temas para ler sobre como controlar a aparência do seu conteúdo incorporado.
2. Testar o URL de conteúdo incorporado
Abra o URL do conteúdo incorporado no navegador para visualizar o comportamento e a aparência dele.
3. Criar seu iframe
- Crie o elemento iframe no aplicativo host.
- Defina o atributo
src
para o URL de conteúdo incorporado. - Defina o
width
, oheight
e outros atributos necessários para mostrar melhor o conteúdo incorporado do Looker.
4. Considerar os problemas de acesso dos usuários
O usuário precisa fazer login no Looker para acessar o conteúdo incorporado. O iframe mostrará uma página de erro 401 se o usuário não estiver conectado.
Opções de login do usuário
O usuário pode fazer login no Looker de duas maneiras:
1. Faça login no Looker com antecedência
O usuário precisa fazer login no Looker no mesmo navegador para ter acesso ao conteúdo incorporado.
2. Ativar uma tela de login opcional do Looker
Adicione allow_login_screen=true
aos parâmetros de URL de conteúdo incorporado para apresentar uma tela de login do Looker no iframe se o usuário não tiver feito login. Nosso URL de conteúdo incorporado de exemplo fica: https://instance_name.looker.com/embed/dashboards/4?Timeframe=14+day&allow_login_screen=true
Lembre-se de duas ressalvas:
- Desative a configuração "Proteções de mesma origem para páginas de login do Looker" para ativar a tela de login do Looker na incorporação do iframe.
- Se a instância do Looker autenticar usuários usando o Logon único (SSO) com um provedor de identidade, o provedor poderá bloquear a tela de login no seu iframe. Você vai precisar usar a opção 1 se isso acontecer.
Política de cookies do navegador do usuário
O Looker usa cookies para autenticação de usuários e armazenamento de sessões. O navegador do usuário precisará ativar cookies de terceiros se ele acessar o nome do host do URL do conteúdo incorporado da instância do Looker em um domínio diferente do aplicativo host.
Alguns navegadores, como o Firefox e o Safari, têm como padrão uma política de cookies que bloqueia cookies de terceiros. Se o navegador do usuário não permitir cookies de terceiros, adicione um domínio personalizado à sua instância do Looker para que o aplicativo host e a instância do Looker no nome do host do URL de conteúdo incorporado residam no mesmo domínio.
5. Interagir com o iframe
Comece a usar o Looker para incorporar mensagens de postagem do iframe.
Próximas etapas
Comece a usar a incorporação assinada usando nosso SDK de incorporação e confira exemplos do que você pode fazer com a incorporação do Looker.