A página Incorporar na seção Plataforma do menu Administrador permite configurar as opções de conteúdo incorporado do Looker.
Lista de permissões de domínios incorporados
Você precisa usar essa configuração para aproveitar os 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 a esse campo e selecione Atualizar.
Proteções de mesma origem para páginas de login do Looker
Na página de login do Looker, use a configuração Proteções de mesma origem para páginas de login do Looker para indicar se você quer permitir ou não a incorporação entre origens:
- Desativado: o Looker permite a incorporação de origem cruzada.
- Ativado: o Looker não permite incorporação de diferentes origens.
Em alguns casos de uso, é necessário 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 é compatível com o nome de domínio da instância do Looker. Nesses casos, é necessário 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 de conteúdo do Looker em um iframe de uma página da Web hospedada por um domínio que não é do Looker, desative as proteções de mesma origem para páginas de login do Looker. Assim, o Looker poderá 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 Ativado se uma das seguintes condições for verdadeira:
- Você não incorpora nenhum conteúdo do Looker.
- Você usa apenas incorporação assinada, já que a página de login do Looker não é usada para incorporações assinadas.
Para mudar a configuração de proteção de mesma origem, use o menu suspenso para selecionar a opção desejada e clique no botão Atualizar para salvar sua seleção.
Incorporar a autenticação de SSO
O recurso Incorporar autenticação de SSO precisa estar ativado se você quiser usar o recurso Incorporação assinada do Looker. Para fazer isso, selecione Ativado e clique em Atualizar.
URL personalizado de alertas e programação
A menos que estejam desativados, os envios por e-mail de dashboards incorporados, seja por alertas ou envios programados, incluem um link com a mensagem Ver painel completo. Esse link permite que os destinatários do e-mail se conectem à instância do Looker e explorem os dados entregues no e-mail.
A opção URL personalizado de alertas e programação permite configurar um URL personalizado em alertas e entregas de e-mail programadas que vinculam os usuários de incorporação 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 que os URLs personalizados nas entregas de e-mail podem vincular. 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á um domínio para o usuário selecionar na caixa de diálogo de programação ou alertas.
Selecionar o caminho do conteúdo
Nesse menu suspenso, você pode selecionar como o URL no link personalizado é formatado. Ele tem 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 da caixa de diálogo de programação ou alertas e o caminho inserido pelo usuário no campo Caminho da caixa de diálogo de programação ou alertas. Por exemplo,
app.customer.com/my_embed_app.Incorporar o URL de domínio com IDs do Looker: o URL no link personalizado vai incluir o domínio selecionado no campo Domínio da caixa de diálogo de programação ou alertas e o caminho do Looker para o painel incorporado, usando o ID do conteúdo. Por exemplo,
app.customer.com/dashboards/12.Incorporar o URL de domínio com slugs do Looker: o URL no link personalizado inclui o domínio selecionado no campo Domínio da caixa de diálogo de programação ou alertas e o caminho do Looker para o painel incorporado, usando o slug de conteúdo. Por exemplo,
app.customer.com/dashboards/CQ1fu99Z9Y1ggq2wcHDfMm.
A opção Selecionar caminho do conteúdo não fica disponível se o campo Incorporar domínio a uma lista de permissões de alertas e programações for deixado em branco.
Identificador do URL
Use este campo para inserir um novo texto de link padrão, que vai substituir o texto Ver painel completo nas entregas 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
Com o recurso Remover navegação de aparência, os administradores podem personalizar ainda mais o conteúdo incorporado, especificamente os Explores incorporados e os painéis incorporados.
Remover a navegação do Look das análises detalhadas incorporadas
Por padrão, os usuários incorporados que têm as permissões explore e save_content vão encontrar as seguintes opções no menu de engrenagem Ações de análise detalhada de uma análise detalhada incorporada:
- A opção Salvar como uma aparência
- A opção Salvar e programar (para usuários incorporados que têm as permissões de envio ou programação)
Quando definida como Ativada, a opção 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 Ações da análise detalhada da análise detalhada incorporada.
Deixe a opção definida como Desativada para manter as referências aos Looks e as opções Salvar como um Look e Salvar e programar nas análises detalhadas incorporadas.
Remover a navegação do Look dos painéis incorporados
Quando a opção Remover navegação do Look está Ativada, as referências e opções de navegação para Looks de explorações incorporadas e blocos de painel vinculados a Looks incorporados são removidas.
Quando a opção Remover navegação do Look está Desativada, os usuários incorporados têm a opção de Ver Look no menu de três pontos Ações do bloco em blocos vinculados ao Look.
Navegação de conteúdo incorporado do painel
Quando essa opção está ativada, os leitores de painéis incorporados que receberam as permissões necessárias podem ver pastas e os Looks e dashboards que elas contêm em painéis incorporados. É necessário ativar esse recurso para permitir que os leitores de painéis incorporados copiem, movam e excluam painéis.
Gerenciamento de conteúdo incorporado
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 é adquirida. Essa é uma alternativa a adicionar o domínio de incorporação usando o painel Administrador > Incorporar do Looker. O Looker salva o domínio de incorporação no banco de dados interno do Looker, então ele não aparece na página Incorporar do painel Administrador. Em vez disso, o domínio de incorporação é associado à sessão sem cookies e existe apenas durante a sessão. Consulte as práticas recomendadas de segurança se decidir usar esse recurso.
Incorporar secret do JWT
Um secret do JSON Web Token (JWT) é necessário para usar o recurso de incorporação sem cookies. A incorporação sem cookies exige que a autenticação SSO de incorporação esteja ativada, mas usa o secret JWT de incorporação em vez do secret de incorporação.
Essa opção permite definir ou redefinir o secret do JWT de incorporação. Definir o segredo do JWT não é necessário, já que a primeira tentativa de criar uma sessão de incorporação sem cookies vai criar o token JWT. Ao contrário do segredo de incorporação, o segredo JWT de incorporação nunca é exposto, já que é usado apenas internamente pelo servidor do Looker.
A redefinição do token JWT vai invalidar todas as sessões ativas de incorporação sem cookies.
Incorporar secret
Uma chave secreta de incorporação é necessária para usar o recurso de incorporação assinada do Looker.
Para recuperar o secret de incorporação, selecione o botão Definir secret.
Para mudar o secret, selecione o botão Redefinir secret. Isso vai interromper todas as incorporações assinadas atuais.
Validador de URI de incorporação
Depois de gerar um URL para o recurso de incorporação assinada do Looker, você pode testá-lo colando no campo Validador de URI de incorporação e clicando em Testar URI. O validador de URI vai retornar uma mensagem indicando se o URL incorporado assinado é válido.
Depois de inserir um URL de incorporação assinado, a seção Verificação rápida do URI de incorporação vai mostrar os parâmetros e valores incluídos no URL de incorporação assinado.