Gerenciar a incorporação do painel e do espaço Genie

Esta página mostra como os administradores de área de trabalho podem gerenciar opções de incorporação para painéis de IA/BI e espaços do Genie.

Que tipos de inserção você pode fazer?

Você pode inserir dashboards e espaços do Genie com segurança em sites e aplicativos externos.

Inserção de painel

Você pode inserir dashboards das seguintes maneiras:

• Inserção básica do Databricks: Os autores do painel podem gerar o código de inserção iframe usando a caixa de diálogo Compartilhar . Os administradores do workspace podem gerenciar quais domínios, se houver, são aprovados para hospedar um painel inserido. A inserção de painel exige que os usuários tenham cookies de terceiros habilitados. Os administradores do workspace devem habilitar a inserção no workspace e definir a lista de domínios qualificados. Consulte a integração básica do dashboard.

• Embedding para usuários externos: (Visualização Pública) Você pode configurar um aplicativo externo para autenticar no Azure Databricks com um principal de serviço e acessar um painel. Os usuários que podem acessar seu aplicativo externo podem acessar o painel. Opcionalmente, você pode filtrar os dados apresentados no painel com base no usuário que está acessando-os. Os administradores do workspace devem configurar o aplicativo externo para usar a entidade de serviço e os tokens de OAuth necessários para autenticação. Veja o que é incorporação para usuários externos?.

Para saber mais sobre as opções de inserção de dashboard disponíveis, consulte Inserir um painel.

Inserção de espaço do Genie

• Incorporação de iframe do espaço Genie: Os autores de espaço do Genie podem conseguir o código de incorporação do iframe na caixa de diálogo Compartilhar. Os usuários que têm acesso ao aplicativo de inserção podem enviar prompts e exibir resultados sem editar a configuração de espaço. Os administradores do workspace devem definir as superfícies permitidas para inserção antes que os autores possam compartilhar um espaço do Genie dessa maneira. Consulte Inserir um espaço do Genie e Controlar destinos de inserção permitidos.

Controlar destinos de inserção permitidos

A inserção de um dashboard ou espaço Genie requer que o site externo seja autorizado explicitamente. Para adicionar destinos de inserção permitidos ao seu workspace:

1. Clique no nome de usuário na barra superior do workspace Azure Databricks e selecione Settings.

2. Clique em Segurança.

3. Role para baixo até a seção Acesso externo .

4. Na seção Incorporar painéis, use o menu suspenso para definir a política de incorporação para seu espaço de trabalho. Esta configuração se aplica tanto aos dashboards quanto aos espaços do Genie.

   Há três opções de política:

   • Permitir: painéis e espaços do Genie podem ser inseridos em qualquer domínio.
   • Permitir domínios aprovados: painéis e espaços do Genie só podem ser inseridos em sites que correspondam à lista aprovada.
   • Negar: os painéis de controle e os espaços do Genie não podem ser embutidos em nenhum domínio.

Se você selecionar Permitir domínios aprovados, use as seguintes instruções para gerenciar sua lista de domínios aprovados:

1. Clique em Gerenciar ao lado de Dashboards Incorporados.
2. Digite um domínio no campo de texto da caixa de diálogo Domínio Aprovado. Clique em Adicionar domínio após cada entrada.
3. Clique em Salvar.

Dicas para definir domínios e rotas aprovados

Para especificar hosts permitidos, use a gramática definida na documentação da Política de Segurança de Conteúdo do W3C. Os exemplos nesta seção ilustram alguns padrões comuns.

Permitir subdomínios

Para permitir todos os subdomínios para um determinado domínio, use um símbolo curinga (*) antes do nome de domínio. Os exemplos a seguir usam *.databricks.com como um domínio de exemplo.

• Corresponde: Qualquer subdomínio
  • some.databricks.com
  • app.databricks.com
  • anything.databricks.com
• Não corresponde: Qualquer coisa que tenha um domínio diferente.
  • another-databricks.com
  • app-databricks.com

Próximas etapas

• Configurar a inserção básica: configurar a inserção para usuários com contas do Databricks que podem entrar diretamente para exibir painéis. Consulte a integração básica do dashboard.
• Configurar incorporação para usuários externos: configure a incorporação para que usuários sem contas do Databricks possam acessar painéis por meio da autenticação do principal de serviço. Veja o que é incorporação para usuários externos?.
• Incorporar um espaço Genie: saiba como os autores de espaço Genie podem gerar o código de incorporação iframe e adicioná-lo a um aplicativo externo. Veja Inserir um espaço do Genie.
• Criar e publicar painéis: saiba como criar, configurar e publicar painéis de IA/BI para inserção. Consulte Dashboards.
• Gerenciar configurações de segurança do workspace: defina configurações de segurança adicionais e controles de acesso para seu workspace. Confira Gerenciar seu workspace.