Definições de administrador – Incorporação

A página Incorporar na secção Plataforma do menu Administração permite-lhe configurar definições para conteúdo do Looker incorporado.

Lista de autorizações de domínios incorporados

Tem de usar esta definição para usar eventos JavaScript para transmitir dados ou ações entre uma página principal e um iFrame do Looker.

Nesse caso, adicione o domínio onde o iFrame está a ser usado a este campo e, de seguida, selecione Atualizar.

Proteções de mesma origem para páginas de início de sessão do Looker

Para a página de início de sessão do Looker, pode usar a definição Proteções de mesma origem para páginas de início de sessão 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 exemplos de utilização, tem de permitir que as páginas de início de sessão do Looker apareçam num iFrame do Looker, mesmo quando a página principal não é compatível com o nome do domínio da instância do Looker. Nestes casos, tem de ter a opção Proteções de mesma origem para páginas de início de sessão do Looker definida como Desativada:

  • Se usar a incorporação privada de conteúdo do Looker num iFrame de uma página Web alojada por um domínio que não seja do Looker, tem de desativar as proteções de mesma origem para páginas de início de sessão do Looker para que o Looker possa apresentar a página de início de sessão no iFrame e permitir que os utilizadores iniciem sessão no Looker.

Defina Proteções de mesma origem para páginas de início de sessão do Looker como Ativado se alguma das seguintes afirmações for verdadeira:

  • Não incorpora conteúdo do Looker.
  • Usar apenas a incorporação assinada, uma vez que a página de início de sessão do Looker não é usada para incorporações assinadas.

Para alterar a definição de proteção de mesma origem, use o menu pendente para selecionar a opção pretendida e, em seguida, certifique-se de que seleciona o botão Atualizar para guardar a seleção.

Incorporação da autenticação de SSO

A funcionalidade Incorporar autenticação SSO tem de estar ativada se quiser usar a funcionalidade de incorporação assinada do Looker. Para o fazer, selecione Ativado e, de seguida, Atualizar.

URL personalizado de alertas e agendamentos

A menos que estejam desativados, os envios por email de painéis de controlo incorporados, quer sejam de alertas ou de envios agendados, incluem um link com a indicação Ver painel de controlo completo. Este link permite aos destinatários de email estabelecer ligação à respetiva instância do Looker e explorar ainda mais os dados enviados por email.

A opção URL personalizado de alertas e agendamentos permite-lhe configurar um URL personalizado em alertas e entregas de email agendadas que associam os utilizadores de incorporação à aplicação de incorporação, em vez de a uma instância do Looker.

Incorporar domínio para lista de autorizações de alertas e agendamentos

Especifique todos os domínios aos quais os URLs personalizados nas entregas de emails podem criar links. Os domínios indicados aqui vão preencher o campo Domínio nas caixas de diálogo de agendamento e alertas.

Se este campo for deixado em branco, os links personalizados não estão disponíveis, uma vez que não existe um domínio para um utilizador selecionar na agenda ou na caixa de diálogo de alertas.

Selecionar caminho do conteúdo

Este menu pendente permite-lhe selecionar o formato do URL no link personalizado. Tem as seguintes opções:

  • Incorporar apenas domínio: o URL no link personalizado inclui apenas o domínio selecionado no campo Domínio na caixa de diálogo de agendamento ou alertas. Por exemplo, app.customer.com.

  • URL definido pelo utilizador: o URL no link personalizado inclui o domínio selecionado no campo Domínio na caixa de diálogo de agendamento ou alertas, e o caminho introduzido pelo utilizador no campo Caminho na caixa de diálogo de agendamento ou alertas. Por exemplo, app.customer.com/my_embed_app.

  • Incorporar URL do 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 agendamento ou alertas e o caminho do Looker para o painel de controlo incorporado, usando o ID do conteúdo. Por exemplo, app.customer.com/dashboards/12.

  • Incorporar URL do domínio com nomes curtos do Looker: o URL no link personalizado inclui o domínio selecionado no campo Domínio na caixa de diálogo de agendamento ou alertas e o caminho do Looker para o painel de controlo incorporado, usando o nome curto do conteúdo. Por exemplo, app.customer.com/dashboards/CQ1fu99Z9Y1ggq2wcHDfMm.

A opção Selecionar caminho do conteúdo não está disponível se o campo Incorporar domínio para lista de autorizações de alertas e agendamentos for deixado em branco.

Etiqueta do URL

Use este campo para introduzir um novo texto do link predefinido, que vai substituir o texto Ver painel de controlo completo nas entregas de email. O texto predefinido pode ser alterado nas caixas de diálogo de agendamento e alertas.

Mostrar filtros em Looks incorporados

Defina esta opção como Ativado se quiser apresentar valores de filtro em Looks incorporados.

Defina esta opção como Desativada para ocultar os valores de filtro em Looks incorporados.

Selecione Atualizar para guardar a definição.

Remova a navegação do Look

A funcionalidade Remover navegação do Look permite que os administradores personalizem ainda mais o conteúdo incorporado, especificamente explorações incorporadas e painéis de controlo incorporados.

Remoção da navegação do Look dos Explorar incorporados

Por predefinição, os utilizadores incorporados que tenham as exploreautorizações save_content vão ver as seguintes opções no menu de engrenagem Explorar ações de uma exploração incorporada:

Quando definida como Ativada, a funcionalidade Remover navegação de Looks remove todas as referências a Looks, incluindo as opções Guardar como Look e Guardar e agendar, do menu de engrenagem Ações de exploração do Explorar incorporado.

Deixe a opção definida como Desativado para manter as referências a visuais e as opções Guardar como visual e Guardar e agendar em Explores incorporados.

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

Quando a opção Remover navegação de Looks está ativada, as referências e as opções de navegação para Looks de exploradores incorporados e mosaicos de painéis de controlo associados a Looks incorporados são removidas.

Quando a opção Remover navegação do Look está desativada, os utilizadores da incorporação têm a opção de Ver Look no menu de três pontos Ações do mosaico em mosaicos associados a Looks.

Navegação no conteúdo incorporado do painel de controlo

Quando esta opção está ativada, os visitantes de painéis de controlo incorporados aos quais foram concedidas as autorizações necessárias podem ver pastas e os Looks e painéis de controlo que contêm a partir de painéis de controlo incorporados. A ativação desta funcionalidade é necessária para permitir que os visitantes dos painéis de controlo incorporados copiem, movam e eliminem painéis de controlo.

Gestão de conteúdos incorporados

Quando esta opção está ativada, os visitantes do painel de controlo incorporado que receberam as autorizações necessárias podem copiar, mover e eliminar painéis de controlo.

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. Esta é uma alternativa à adição do domínio de incorporação através do painel Administração > Incorporar do Looker. O Looker guarda o domínio de incorporação na base de dados interna do Looker, pelo que não é apresentado na página Incorporar no painel Administração. Em alternativa, o domínio de incorporação está associado à sessão sem cookies e existe apenas durante a sessão. Reveja as práticas recomendadas de segurança se decidir tirar partido desta funcionalidade.

Incorporar código secreto JWT

É necessário um segredo do símbolo da Web JSON (JWT) para usar a funcionalidade de incorporação sem cookies. A incorporação sem cookies requer que a autenticação SSO de incorporação esteja ativada, mas a incorporação sem cookies usa o segredo JWT de incorporação em vez do segredo de incorporação.

Esta opção permite-lhe definir ou repor o segredo JWT de incorporação. A definição do segredo do JWT não é necessária, uma vez que a primeira tentativa de criar uma sessão de incorporação sem cookies cria o token JWT. Ao contrário do segredo de incorporação, o segredo JWT de incorporação nunca é exposto, uma vez que só é usado internamente pelo servidor do Looker.

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

Incorporar Secret

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

Para obter o segredo de incorporação, selecione o botão Definir segredo.

Para alterar o seu segredo, selecione o botão Repor segredo. No entanto, tenha em atenção que esta ação vai interromper todas as incorporações assinadas existentes.

Validador de URI incorporado

Depois de gerar um URL para a funcionalidade de incorporação assinada do Looker, pode testar o URL colando-o no campo Validador de URI de incorporação e clicando em Testar URI. O validador de URI devolve uma mensagem a indicar se o URL incorporado assinado é válido.

Depois de introduzir um URL incorporado assinado, a secção Verificação rápida do URI incorporado apresenta os parâmetros e os valores incluídos no URL incorporado assinado.