Na página Incorporar da seção Plataforma do menu Administrador, você pode definir configurações para o 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.
- Ativada: o Looker não permite incorporação de origem cruzada.
Para 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 é 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 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 alterar 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 autenticação SSO
O recurso Incorporar autenticação SSO precisa ser ativado para usar o recurso de Incorporação assinada do Looker. Para isso, selecione Ativado e, em seguida, Atualizar.
URL personalizado de alertas e programação
A menos que estejam desativados, os e-mails dos painéis incorporados, sejam de alertas ou entregas programadas, 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 analisem melhor 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 podem ter links para URLs personalizados nos envios de e-mail. Os domínios listados aqui preencherão 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 de domínio com IDs 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 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, 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 o caminho do conteúdo não ficará disponível se o campo Incorporar domínio para a lista de permissões de programações e alertas ficar 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 Ativada se quiser mostrar valores de filtro em Looks incorporados.
Defina essa opção como Desativado 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 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 explorações 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 Abrir ações de uma Análise incorporada:
- A opção de Salvar como um Look
- A opção Salvar e programar (para usuários incorporados que têm as permissões de envio ou programação)
Quando definido como Enabled, o recurso Remover a 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 Explorar 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 & Schedule (Salvar como um Look) nas 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 a navegação do Look estiver Desativada, os usuários incorporados terão a opção de Ver Look no menu de três pontos Ações do bloco nos blocos do Look vinculado.
Navegação de conteúdo incorporado do 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. A ativação desse recurso é necessária para permitir que os leitores de 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 de adicionar o domínio de incorporação usando o painel Administrador > Incorporar do Looker. O Looker salva o domínio incorporado 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. Leia as práticas recomendadas de segurança para aproveitar esse recurso.
Incorporar secret JWT
É necessário ter uma chave secreta JSON Web Token (JWT) para usar o recurso de incorporação sem cookies. A incorporação sem cookies exige que a autenticação de SSO de incorporação esteja ativada, mas a incorporação sem cookies usa a chave secreta de incorporação do JWT em vez de incorporar uma chave secreta.
Essa opção permite definir ou redefinir o secret JWT de incorporação. 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 de incorporação JWT 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.
Incorporar secret
Uma chave secreta de incorporação é necessária para usar o recurso de incorporação assinada do Looker.
Para recuperar a chave secreta de incorporação, selecione o botão Definir chave secreta.
Para alterar sua chave secreta, selecione o botão Redefinir chave secreta. No entanto, isso vai corromper 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, 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.