A página Incorporar na seção Plataforma do menu Administrador permite definir as configurações do conteúdo incorporado do Looker.
Lista de permissões de domínios incorporados
Você precisa usar essa configuração para usar eventos JavaScript e transmitir dados ou ações entre uma página mãe e um iframe do Looker.
Nesse caso, adicione o domínio em que o iframe está sendo usado nesse campo e selecione Atualizar.
Proteções de mesma origem para páginas de login do Looker
O Looker aplica uma política de mesma origem para conteúdo de iframe, o que significa que uma página não pode ser exibida em um iframe se o nome de domínio da página mãe for diferente do nome de domínio da página do iframe. Isso protege contra possíveis ataques de correção da UI, geralmente conhecidos como clickjacking.
A única exceção a essa política é a página de login do Looker. Na página de login, use a configuração Proteções de mesma origem para páginas de login do Looker para indicar se você quer ou não aplicar a política de mesma origem:
- Desativada: o Looker não aplica a política de mesma origem à página de login.
- Ativada: o Looker aplica a política de mesma origem na página de login.
Em determinados casos de uso, você precisa permitir que as páginas de login do Looker apareçam em um iframe do Looker, mesmo quando a página mãe não for compatível com o nome de domínio da instância do Looker. Nesses casos, é preciso definir a opção Proteções de mesma origem para páginas de login do Looker como Desativada:
- Se você usar a incorporação particular do conteúdo do Looker em um iframe de uma página da Web hospedada por um domínio que não seja do Looker, será necessário desativar as proteções de mesma origem para as páginas de login do Looker para que o Looker possa mostrar a página de login no iframe e permitir que os usuários façam login no Looker.
Defina Proteções de mesma origem para páginas de login do Looker como Ativadas se uma das seguintes condições for verdadeira:
- Você não incorpora conteúdo do Looker.
- Use apenas a incorporação assinada, já que a página de login do Looker não é usada para esse tipo de incorporação.
Para alterar a configuração da proteção de mesma origem, use o menu suspenso para escolher a opção desejada e depois selecione o botão Atualizar para salvar a seleção.
Incorporar autenticação SSO
O recurso Incorporar autenticação SSO precisa estar ativado se você quer usar a Incorporação assinada do Looker. Para fazer isso, selecione Ativado e depois Atualizar.
URL personalizado de alertas e programação
A menos que desativadas, as entregas de e-mails de painéis incorporados, seja de alertas ou entregas programadas, incluem um link com o texto Visualizar painel completo. Com esse link, os destinatários do e-mail podem se conectar à instância do Looker e analisar melhor os dados enviados no e-mail.
Com a opção Alertas e programação de URL personalizado, é possível configurar um URL personalizado em alertas e entregas programadas de e-mail que vão vincular os usuários incorporados ao aplicativo de incorporação em vez de uma instância do Looker.
Incorporar domínio a uma lista de permissões de alertas e programações
Especifique todos os domínios aos quais URLs personalizados podem ser vinculados a envios de e-mail. Os domínios listados aqui vão preencher o campo Domínio nas caixas de diálogo de programação e alertas.
Se esse campo for deixado em branco, os links personalizados não estarão disponíveis, já que não haverá domínio para o usuário selecionar na caixa de diálogo de programação ou alertas.
Selecionar o caminho do conteúdo
Esse menu suspenso permite selecionar como o URL no link personalizado é formatado. Ele inclui as seguintes opções:
Incorporar apenas o domínio: o URL no link personalizado inclui apenas o domínio selecionado no campo Domínio, na caixa de diálogo de programação ou alertas. Por exemplo,
app.customer.com.URL definido pelo usuário: o URL no link personalizado inclui o domínio selecionado no campo Domínio, na caixa de diálogo de programação ou alertas, e o caminho inserido pelo usuário no campo Caminho, na caixa de diálogo de programação ou alertas. Por exemplo,
app.customer.com/my_embed_app.Incorporar o URL do domínio com IDs do Looker: o URL no link personalizado vai incluir o domínio selecionado no campo Domínio, na caixa de diálogo de programação ou alertas, e o caminho do Looker para o painel incorporado, usando o ID de conteúdo. Por exemplo,
app.customer.com/dashboards/12.Incorporar o URL do domínio com slugs do Looker: o URL no link personalizado inclui o domínio selecionado no campo Domínio, na caixa de diálogo de programação ou alertas, e o caminho do Looker para o painel incorporado, usando o slug do conteúdo. Por exemplo,
app.customer.com/dashboards/CQ1fu99Z9Y1ggq2wcHDfMm.
A opção Selecionar o caminho do conteúdo não vai estar disponível se o campo Incorporar domínio para listas de permissões e programações e alertas ficar em branco.
Identificador do URL
Use esse campo para inserir o novo texto do link padrão, que substituirá o texto Visualizar painel completo nos envios de e-mail. O texto padrão pode ser alterado nas caixas de diálogo de programação e alertas.
Mostrar filtros em Looks incorporados
Defina essa opção como Ativada se quiser mostrar valores de filtro em Looks incorporados.
Defina essa opção como Desativada para ocultar os valores de filtro em Looks incorporados. Selecione Atualizar para salvar a configuração.
Remover a navegação do Look
O recurso Remover navegação do Look permite que os administradores personalizem ainda mais o conteúdo incorporado, especificamente Análises e painéis incorporados.
Remover a navegação do Look de "Explores" incorporadas
Por padrão, os usuários de incorporação que têm as permissões explore e save_content vão ter acesso às seguintes opções no menu de engrenagem Ver ações de uma Análise incorporada, incluindo a opção Salvar como um Look. Os usuários de incorporação que têm permissões de envio ou programação também vão encontrar a opção Salvar e programar.
Quando definido como Ativado, o recurso Remover navegação do Look remove todas as referências a Looks, incluindo as opções Salvar como um Look e Salvar e programar, do menu de engrenagem Ver ações da Análise incorporada.
Deixe a opção definida como Desativada para manter as referências a Looks e as opções Salvar como um Look e Salvar e programar em Análises detalhadas incorporadas.
Remover a navegação do Look de painéis incorporados
Além de remover as referências e a navegação para Looks de Explores incorporados, o recurso Remover a navegação do Look também vai remover as referências de blocos vinculados ao Look incorporados em painéis quando esse recurso estiver Ativado.
Quando a opção Remover navegação do Look está desativada, os usuários de incorporação têm a opção de Visualizar Look nos blocos vinculados ao Look.
Navegação de conteúdo incorporado do painel
Quando essa opção está ativada, os leitores do painel incorporado que receberam as permissões necessárias podem acessar pastas, os Looks e os dashboards contidos nos dashboards incorporados. A ativação desse recurso é necessária para permitir que os leitores de painéis incorporados copiem, movam e excluam painéis.
Incorporar gerenciamento de conteúdo
Quando essa opção está ativada, os leitores de painéis incorporados que receberam as permissões necessárias podem copiar, mover e excluir painéis.
Incorporação sem cookies
A partir do Looker 23.8, o domínio de incorporação pode ser incluído quando a sessão sem cookies for adquirida. Essa é uma alternativa à adição do domínio incorporado usando o painel Administrador > Incorporar do Looker. O Looker salva o domínio incorporado no banco de dados interno do Looker. Por isso, ele não vai aparecer no painel Administrador > Incorporar. Em vez disso, o domínio incorporado é associado à sessão sem cookies e existe apenas durante a sessão. Analise as práticas recomendadas de segurança se decidir aproveitar esse recurso.
Incorporar secret JWT
Quando a opção Incorporar Autenticação SSO está Ativada e a opção Incorporação sem cookies está ativada, essa configuração é exibida.
É necessário ter um secret do JSON Web Token (JWT) para usar o recurso de incorporação sem cookies. A incorporação sem cookies exige que a opção Incorporar autenticação SSO esteja ativada, mas a incorporação sem cookies usa chave secreta JWT em vez de chave secreta incorporada.
Esta opção permite definir ou redefinir o secret do JWT incorporado. Não é necessário definir o secret JWT, já que a primeira tentativa de criar uma sessão de incorporação sem cookies vai gerar o token JWT. Ao contrário do secret de incorporação, o secret do JWT incorporado nunca é exposto, porque é usado apenas internamente pelo servidor do Looker.
Redefinir o token JWT invalidará todas as sessões ativas de incorporação sem cookies.
Incorporar secret
Um secret de incorporação é necessário para usar o recurso de incorporação assinada do Looker.
Para recuperar o secret de incorporação, selecione o botão Set Secret.
É importante copiar o secret e salvá-lo em um local seguro imediatamente, já que não é possível recuperá-lo dessa página depois de sair.
Para alterar seu secret, selecione o botão Redefinir secret. No entanto, isso vai corromper as incorporações assinadas.
Incorporar validador de URI
Essa configuração só é revelada se o Chave secreta de incorporação tiver sido definida.
Depois de gerar um URL para o recurso de incorporação assinada do Looker, cole-o no campo Validador de URI de incorporação e clique em Testar URI para testar. O validador de URI retorna uma mensagem indicando se o URL de incorporação assinado é válido.
Depois de inserir um URL de incorporação assinado, a seção Verificação rápida do URI de incorporação exibirá os parâmetros e valores incluídos no URL de incorporação assinado.
