Configurações de administrador: incorporação

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 de incorporação do Looker (Google Cloud Core).

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

Observação: para acessar todas as páginas de administrador no Looker, é necessário ter a função de administrador. Se você tiver uma permissão que ativa apenas partes do painel Administrador, como manage_schedules ou manage_themes, mas não tiver a função de administrador, o Looker talvez não mostre as páginas descritas neste artigo no painel Administrador. Além disso, a permissão see_admin concede permissão somente leitura para a maioria das páginas de administrador, mas não todas. Consulte a descrição de see_admin para mais informações.

Lista de permissões de domínios incorporados

É necessário 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

Para a 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 entre origens:

• Desativado: o Looker permite a incorporação entre origens.
• 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 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 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 Atualizar.

URL personalizado de alertas e programação

A menos que sejam 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 envios de e-mails programados que vinculam 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 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

Com esse 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 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.

  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 acontecer 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 alternativa ao valor do ID de conteúdo para uso em URLs. No exemplo anterior, CQ1fu99Z9Y1ggq2wcHDfMm é o slug do painel. Para conferir o slug de um painel, selecione Conseguir link no menu de três pontos.

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 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 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 aparência permite que os administradores personalizem ainda mais o conteúdo incorporado, especificamente Explorações 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:

• A opção Salvar como um visual
• A opção Salvar e programar (para usuários incorporados que têm permissões de envio ou programação)

Quando definido como Ativado, o recurso Remover navegação de 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 seção "Explorar" da seção "Explorar" incorporada.

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

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

Quando a opção Remover navegação de looks estiver ativada, as referências e as opções de navegação para os looks das análises incorporadas e dos blocos de painéis vinculados a looks serão removidas.

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

Navegação de conteúdo incorporada ao painel

Quando essa opção está ativada, os leitores de dashboards incorporados que receberam as permissões necessárias podem acessar as pastas e os Looks e dashboards que elas contêm. 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 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 para adicionar o domínio de incorporação usando o painel Admin > Embed do Looker. 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.

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

Incorporar o secret do JWT

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

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 secret do JWT incorporado. Configurar o segredo 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 incorporado, o segredo incorporado do JWT nunca é exposto, porque é usado apenas internamente pelo servidor do Looker.

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

Incluir secret

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

É necessário um segredo de incorporação para usar o recurso de incorporação assinada do Looker.

Para recuperar o secret de incorporação, selecione o botão Definir secret.

Observação: é importante copiar o segredo e salvá-lo em um local seguro imediatamente, porque não é possível recuperar o segredo depois de sair desta página.

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

Validador de URIs incorporados

Observação: essa configuração só será revelada se o secreto de incorporação tiver sido definido.

Depois de gerar um URL para o recurso de incorporação assinada do Looker, cole-o no campo Validador de URI incorporado e clique 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.