Configurações de administrador - Incorporar

Na página Inserir, na seção Plataforma do menu Administrador, você pode definir as configurações do conteúdo incorporado do Looker.

Lista de permissões de domínio incorporado

Essa configuração permite usar eventos JavaScript com o objetivo de transmitir dados ou ações entre uma página mãe e um iframe do Looker.

Nesse caso, adicione a esse campo o domínio em que o iframe está sendo usado 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 a incorporação de origem cruzada:

  • Desativada: o Looker permite incorporação de origem cruzada.
  • Ativado: o Looker não permite a incorporação entre 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 for compatível com o nome de domínio da instância do Looker. Nesses casos, a opção Proteções de mesma origem para páginas de login do Looker precisa estar definida como Desativada:

  • Se você usar a incorporação privada de 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 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 Ativada se uma das seguintes condições for verdadeira:

  • Você não incorpora 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 da proteção de mesma origem, use o menu suspenso para selecionar a opção desejada e clique no botão Atualizar para salvar a seleção.

Incorporar a autenticação de SSO

O recurso Inserir autenticação SSO precisa estar ativado se você quiser usar o recurso Inserção assinada do Looker. Para fazer isso, selecione Ativado e, em seguida, Atualizar.

URL personalizado de alertas e programação

A menos que estejam desativadas, as entregas de e-mail de painéis incorporados, de alertas ou de 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 enviados no e-mail.

A opção URL personalizado de alertas e programação permite configurar um URL personalizado em alertas e entregas de e-mails programadas. Esse URL vincula 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 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, porque não haverá um domínio para o usuário selecionar na caixa de diálogo de agendamento ou alertas.

Selecionar o caminho do conteúdo

Esse menu suspenso permite que você selecione como o URL no link personalizado é formatado. Ele tem as seguintes opções:

  • Apenas domínios incorporados: 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 de 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 de conteúdo. Por exemplo, app.customer.com/dashboards/CQ1fu99Z9Y1ggq2wcHDfMm.

A opção Selecionar caminho do conteúdo não estará disponível se o campo Incorporar domínio a uma lista de permissões de alertas e programações estiver em branco.

Identificador do URL

Use esse campo para inserir o novo texto de link padrão, que 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 Ativado se quiser mostrar os valores de filtro nos Looks incorporados.

Defina essa opção como Desativado para ocultar os valores de filtro nos Looks incorporados.

Selecione Atualizar para salvar a configuração.

Remover a navegação do Look

O recurso Remover navegação de Look permite que os administradores personalizem ainda mais o conteúdo incorporado, especificamente Análises incorporadas e painéis incorporados.

Remoção da navegação do Look das Pesquisas 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 da Análise detalhada de uma Análise detalhada incorporada:

Quando definido como Enabled, o recurso Remove Look Navigation remove todas as referências a Looks, incluindo as opções Save as a Look e Save & Programação, no menu de engrenagem Abrir ações incorporado da Análise.

Deixe a opção definida como Disabled para manter referências a Looks e as opções Save as a Look e Save & Programação em "Análises" incorporadas.

Como remover a navegação do Look dos painéis incorporados

Quando a opção Remover navegação do Look estiver Ativada, as referências e as opções de navegação para Looks de Análises incorporadas e blocos do dashboard Vinculados incorporados serão removidas.

Quando a opção Remover navegação de visual estiver desativada, os usuários incorporados vão ter a opção de Visualizar visual no menu de Ações do bloco com três pontos nos blocos vinculados a visual.

Navegação de conteúdo incorporada ao painel

Quando esta opção está ativada, os leitores de dashboards incorporados que receberam as permissões necessárias podem visualizar pastas e os Looks e dashboards que elas contêm em dashboards incorporados. Ativar esse recurso é necessário para que os leitores dos painéis incorporados copiem, movam e excluam painéis.

Gerenciamento de conteúdo incorporado

Quando esta 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 para adicionar o domínio de incorporação usando a guia Administrador > do Looker Incorporar. O Looker salva o domínio de incorporação no banco de dados interno do Looker, para que ele não seja mostrado na página Incorporação no painel Administrador. Em vez disso, o domínio de incorporação é associado à sessão sem cookies e existe apenas durante a duração dela. Consulte as práticas recomendadas de segurança se você decidir usar esse recurso.

Incorporar secret JWT

Um secret de JSON Web Token (JWT) é necessário para usar o recurso de incorporação sem cookies. A incorporação sem cookies exige que a Incorporação de autenticação SSO esteja ativada, mas a incorporação sem cookies usa Incorporação de secret JWT em vez de Incorporação de secret.

Essa opção permite definir ou redefinir o segredo de 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 segredo incorporado, o segredo do JWT incorporado nunca é exposto, porque é usado apenas internamente pelo servidor do Looker.

A redefinição do token JWT invalidará todas as sessões de incorporação sem cookies ativas.

Incluir secret

Uma chave secreta de incorporação é necessária para usar o recurso de incorporação assinada do Looker.

Para recuperar o secret incorporado, selecione o botão Definir secret.

Para mudar o secret, selecione o botão Reset Secret. No entanto, isso vai interromper as incorporações assinadas.

Validador de URI de incorporação

Depois de gerar um URL para o recurso de incorporação assinada do Looker, teste o URL colando-o no campo Validar URI de incorporação e clicando em Testar URI. O validador de URI vai retornar 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 vai mostrar os parâmetros e valores incluídos no URL de incorporação assinado.