Configurações de administrador: incorporar

Observação :se você estiver usando uma instância do Looker (Google Cloud Core), essa página só vai aparecer se você estiver usando a edição Embed do Looker (Google Cloud Core).

Na página Incorporar da seção Plataforma do menu Administrador, é possível definir as configurações de conteúdo incorporado do Looker.

Lista de permissões de domínios incorporados

Você precisa usar essa configuração para utilizar eventos JavaScript e 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:

• Desativado: o Looker permite incorporação de origem cruzada.
• Ativado: o Looker não permite incorporação de origem cruzada.

Em determinados casos, 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, é 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 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 páginas de login do Looker para que o Looker possa exibir 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 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 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 o recurso Incorporação assinada do Looker. Para fazer isso, selecione Ativado e depois Atualizar.

URL personalizado de alertas e programação

A menos que estejam 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. Esse link permite que os destinatários do e-mail se conectem à instância do Looker deles e explorem melhor os dados enviados no e-mail.

Com a opção Alertas e URL personalizado de programação, é possível configurar um URL personalizado nos alertas e nas entregas programadas de e-mails. Esse URL vai direcionar os usuários incorporados ao aplicativo de incorporação, e não a uma instância do Looker.

Observação :o aplicativo de incorporação é responsável por autenticar e verificar qualquer usuário que clicar no link para retornar a um URL personalizado.

Incorporar domínio a uma lista de permissões de alertas e programações

Especifique todos os domínios aos quais os URLs personalizados nas entregas de e-mail podem estar vinculados. 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 que você selecione como o URL no link personalizado é formatado. Ele tem as seguintes opções:

• Incorporar somente o domínio: o URL do 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 Content ID. Por exemplo, app.customer.com/dashboards/12.

  Observação: as instâncias com um recurso de licença específico ativado vão adicionar o caminho do Looker usando o slug do painel, mesmo quando essa opção estiver selecionada. Se isso ocorrer e você quiser usar o ID do painel no URL do link personalizado, abra uma solicitação de suporte.

• 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 de conteúdo. Por exemplo, app.customer.com/dashboards/CQ1fu99Z9Y1ggq2wcHDfMm.

  Observação :o slug é uma string curta escolhida aleatoriamente, usada como alternativa ao valor do ID do conteúdo para uso em URLs. No exemplo anterior, CQ1fu99Z9Y1ggq2wcHDfMm é o slug do dashboard. Para conferir um slug do painel, selecione Gerar link no menu de três pontos do painel.

A opção Selecionar caminho do conteúdo não vai ficar disponível se o campo Incorporar domínio para programações e alertas estiver em branco.

Identificador do URL

Use esse campo para inserir o novo texto de 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 Enabled se quiser mostrar valores de filtro em Looks incorporados.

Defina essa opção como Disabled 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 as Análises e os painéis incorporados.

Remover a navegação do Look de Explores incorporados

Por padrão, os usuários que têm as permissões explore e save_content têm acesso às seguintes opções no menu de engrenagem Ações de análise de uma Análise incorporada:

• A opção para Salvar como um Look
• A opção Salvar e programar (para usuários incorporados com permissões de envio ou programação)

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 Ações de análise incorporado.

Deixe a opção definida como Desativado para manter as referências a Looks e às opções Salvar como um Look e Salvar e programar em Análises detalhadas incorporadas.

Como remover a navegação do Look dos dashboards incorporados

Quando a opção Remover navegação do Look estiver ativada, as referências e opções de navegação dos Looks de Explores incorporados e dos blocos incorporados do dashboard vinculados serão removidas.

Quando a opção Remover 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 vinculados ao Look.

Navegação de conteúdo incorporado do painel

Quando essa opção está ativada, os leitores incorporados do painel que receberam as permissões necessárias podem conferir as pastas, os Looks e os dashboards contidos nos dashboards incorporados. É necessário ativar esse recurso 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 incorporados do painel 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 incorporado poderá 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 dele. Por isso, ele não aparece na página Incorporar do painel Administrador. Em vez disso, o domínio incorporado é associado à sessão sem cookies e existe somente durante a sessão. Analise as práticas recomendadas de segurança se decidir aproveitar esse recurso.

Importante :para usar a incorporação sem cookies, a configuração Sessões persistentes também precisa estar ativada no painel Administrador > Autenticação > Sessões.

Incorporar secret JWT

Observação :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 um secret do 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 Chave secreta do JWT em vez da Chave secreta de incorporação.

Esta 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 JWT de incorporação nunca é exposto, porque só é usado internamente pelo servidor do Looker.

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

Incorporar secret

Observação :essa configuração só será revelada se a opção Incorporar autenticação SSO estiver definida como Ativada.

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 secret.

Observação: é importante copiar e salvar a chave secreta em um local seguro imediatamente, já que não é possível recuperá-la depois de sair da página.

Para alterar a chave secreta, selecione o botão Redefinir secret. No entanto, isso vai corromper todas as incorporações assinadas.

Validador de URI de incorporação

Observação :essa configuração só é revelada se a política Embed Secret tiver sido definida.

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