Configurações de administrador: incorporação

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

A página Incorporar na seção Plataforma do menu Admin permite configurar as definições do conteúdo incorporado do Looker.

Observação: se você tiver uma permissão que dá acesso apenas a páginas selecionadas no painel "Admin", como manage_schedules, manage_themes ou see_admin, mas não tiver o papel de administrador, a página ou as páginas descritas aqui talvez não apareçam no painel "Admin".

Lista de permissões de domínio incorporado

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.

**Importante**: não inclua uma barra (/) no final do URL do domínio.

Proteções de mesma origem para páginas de login do Looker

Na página de login do Looker, você pode usar a configuração Proteções de mesma origem para páginas de login do Looker para indicar se quer ou não permitir a incorporação de origem cruzada:

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

Para determinados 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 Desativado:

• Se você usar 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, 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 Ativado 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 incorporações assinadas.

Para mudar a configuração de proteção de mesma origem, use o menu suspenso para selecionar a opção escolhida e selecione o botão Atualizar para salvar a seleção.

Incorporar autenticação SSO

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

URL personalizado de alertas e programação

A menos que seja desativado, os envios 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 entregues no e-mail.

A opção URL personalizado de alertas e programação permite configurar um URL personalizado em alertas e envios de e-mail programados que vão vincular os usuários incorporados ao aplicativo de incorporação, em vez de 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 que os URLs personalizados em envios 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 vão estar 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

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

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

  Observação: as instâncias que têm 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 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 do conteúdo. Por exemplo, app.customer.com/dashboards/CQ1fu99Z9Y1ggq2wcHDfMm.

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

Selecionar o caminho do conteúdo não está 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 esse campo para inserir um novo texto de link padrão, que vai substituir o texto Ver 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 Ativado se quiser mostrar os 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 a navegação do Look permite que os administradores personalizem ainda mais o conteúdo incorporado, especificamente análises incorporadas e painéis incorporados.

Remover a navegação do Look de análises incorporadas

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

• A opção 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 Ativado, o recurso Remover a navegação do Look remove todas as referências aos Looks, incluindo as opções Salvar como um Look e Salvar e programar, do menu de engrenagem Ações de análise da análise incorporada.

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

Remover a navegação do Look de painéis incorporados

Quando a opção Remover a navegação do Look está Ativada, as referências e as opções de navegação para Looks de análises incorporadas e blocos de painel vinculados ao Look são removidas.

Quando a opção Remover a navegação do Look está Desativada, os usuários incorporados têm a opção Ver Look no menu de três pontos Ações do bloco em blocos vinculados ao Look.

Navegação do 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 visualizar pastas e os Looks e painéis 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 incorporado pode ser incluído quando a sessão sem cookies é adquirida. Essa é uma alternativa à adição do domínio incorporado usando o painel Admin > Incorporar do Looker. O Looker salva o domínio incorporado no banco de dados interno do Looker, para que ele não seja mostrado na página Incorporar no painel Admin. Em vez disso, o domínio incorporado é associado à sessão sem cookies e existe apenas durante a sessão. Revise as práticas recomendadas de segurança se decidir aproveitar esse recurso.

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

Incorporar chave secreta JWT

Observação: essa configuração é revelada quando a opção Incorporar autenticação SSO está Ativada e a opção Incorporação sem cookies está ativada.

Uma chave secreta JSON Web Token (JWT) é necessária 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 a Incorporação de chave secreta JWT em vez de Incorporar chave secreta.

Essa opção permite definir ou redefinir a chave secreta JWT incorporada. Definir a chave secreta 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 da chave secreta incorporada, a chave secreta JWT incorporada nunca é exposta, já que é usada apenas internamente pelo servidor do Looker.

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

Incorporar chave secreta

Observação: essa configuração só é revelada se a Incorporação de autenticação SSO estiver definida como Ativada.

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

Para recuperar a chave secreta incorporada, selecione o botão Definir chave secreta.

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

Para mudar a chave secreta, selecione o botão Redefinir chave secreta. No entanto, isso vai interromper todas as incorporações assinadas atuais.

Validador de URI incorporado

Observação: essa configuração só é revelada se a Incorporação de chave secreta tiver sido definida.

Depois de gerar um URL para o recurso de incorporação assinada do Looker, você pode testar o URL colando-o no campo Validador de URI incorporado e clicando em Testar URI. O validador de URI vai retornar uma mensagem indicando se o URL de incorporação assinada é válido.

Depois de inserir um URL de incorporação assinada, a seção Verificação rápida de URI incorporado vai mostrar os parâmetros e valores incluídos no URL de incorporação assinada.