Pular para o conteúdo principal

Controle de entrada baseado em contexto

nota

A entrada baseada em contexto requer o nível Enterprise. A entrada baseada em contexto está geralmente disponível (GA), exceto o acesso privado a Workspace e políticas de nível account, que estão em Beta.

Esta página fornece uma visão geral do controle de entrada baseado em contexto, incluindo seus conceitos principais, modos de imposição, auditoria e como ele interage com outros controles de rede. Para configurar políticas, consulte Gerenciar políticas de entrada baseadas em contexto. Para o controle de saída serverless, consulte O que é o controle de saída serverless?.

Visão geral do controle de entrada baseado em contexto​

O controle de entrada baseado em contexto funciona em conjunto com listas de acesso de IP e conectividade privada de front-end para permitir que os administradores de account definam regras de permissão e negação que combinam quem está chamando, de onde eles estão chamando e o que eles podem acessar no Databricks. Isso garante que apenas combinações confiáveis de identidade, tipo de solicitação e origem possam acessar seu workspace. O controle de entrada baseado em contexto é configurado no nível de account. Uma única política pode governar vários Workspace.

Usando o ingresso baseado em contexto, você pode:

  • Impeça o acesso de redes não confiáveis exigindo um segundo fator, uma fonte de rede confiável, além das credenciais.
  • Permita o acesso a clientes de software como um serviço (SaaS) sem IPs de saída estáveis usando key na identidade em vez de intervalos de IP ou permitindo uma plataforma parceira que o Databricks mantém atualizada.
  • Limite o acesso permitindo que fontes menos confiáveis usem apenas determinados escopos, como as APIs Databricks ou a interface do usuário do workspace.
  • Proteja a automação privilegiada: Restrinja entidades de serviço Databricks de alto valor apenas a redes de alta confiança.
  • Auditar com eficiência: capturar logs de negação detalhados em tabelas de sistema do Unity Catalog para monitorar requisições bloqueadas.

Políticas de nível de workspace vs. políticas de nível de conta​

O controle de entrada baseado em contexto usa dois tipos de políticas. As políticas de nível de workspace regem o acesso aos workspaces. As políticas de nível de account regem o acesso a recursos de nível de account, como o console do account e o Genie One de nível de account.

Attribute

Workspace-level policy

Account-level policy

Controls access to

Workspaces

Account-level recursos (account console, account-level Genie One, account APIs)

Tipos de acesso

Workspace UI, API, Apps runtime, Lakebase runtime

Account UI, Account API

Identidades

Todos os usuários e Service Principals, todos os usuários, todos os Service Principals ou identidades selecionadas

Todos os usuários e Service Principals, todos os usuários, todos os Service Principals ou identidades selecionadas

Fontes

Public, private, and cross-workspace

Public and private

Default policy

A default workspace-level policy applies to workspaces without an explicit assignment

A single fixed policy (account-policy), auto-attached and not detachable

Denial logging

log in system.access.inbound_network

log in em system.access.inbound_network, com workspace_id definido como 0

Gerenciar

Gerenciar políticas de entrada baseadas em contexto do Workspace

Gerenciar políticas de entrada baseadas em contexto de account

Attribute

Workspace-level policy

Account-level policy

Controls access to

Workspaces

Account-level recursos (account console, account-level Genie One, account APIs)

Tipos de acesso

Workspace UI, API, Apps runtime, Lakebase runtime

Account UI, Account API

Identidades

Todos os usuários e Service Principals, todos os usuários, todos os Service Principals ou identidades selecionadas

Todos os usuários e Service Principals, todos os usuários, todos os Service Principals ou identidades selecionadas

Fontes

Public, private, and cross-workspace

Public and private

Default policy

A default workspace-level policy applies to workspaces without an explicit assignment

A single fixed policy (account-policy), auto-attached and not detachable

Denial logging

log in system.access.inbound_network

log in em system.access.inbound_network, com workspace_id definido como 0

Gerenciar

Gerenciar políticas de entrada baseadas em contexto do Workspace

Gerenciar políticas de entrada baseadas em contexto de account

As políticas em nível de account estão em Beta. Para começar , habilite Context-Based Ingress: Account Policy.

Conceitos básicos de controle de entrada baseado em contexto​

Fontes​

Uma fonte define a origem das solicitações.

As políticas de acesso público oferecem suporte às seguintes fontes:

  • Todos os IPs públicos : qualquer fonte pública de internet.
  • IPs selecionados : endereços IPv4 específicos ou intervalos CIDR.
  • Plataformas parceiras : Aplicativos de terceiros que o Databricks mantém atualizados para você. Para Power BI, Tableau Cloud, dbt Cloud, ChatGPT e Claude, o Databricks sincroniza os intervalos de IP publicados pelo parceiro. Para os aplicativos Databricks Genie para Slack e Microsoft Teams, o Databricks faz a correspondência com o ID do cliente OAuth do aplicativo. Consulte Permitir plataformas parceiras em políticas de entrada baseadas em contexto.

As políticas de acesso privado oferecem suporte às seguintes fontes:

  • Todos os endpoints privados registrados : Qualquer endpoint privado registrado na account.
  • Endpoints privados selecionados : endpoints privados registrados específicos na account.
info

Beta

O acesso privado a Workspace usando ingresso baseado em contexto está em Beta. Para usá-lo, um administrador account deve ativar Ingresso baseado em contexto: Políticas de acesso privado ao workspace na página de Prévias do console da account. Consulte Gerenciar prévias em nível de account.

Acesso entre Workspace (Beta): controla quais Workspace de origem podem alcançar este Workspace por meio de tráfego Serverless, usando as mesmas identidades e regras de permissão e negação que outras fontes.

  • Workspaces selecionados : Apenas os workspaces cujos IDs você listar.

Você também pode deixar esta política no modo de compatibilidade, caso em que ela não rege a entrada entre workspaces e os controles de rede pré-existentes do workspace se aplicam. Para configurar o acesso entre workspaces nos lados de entrada e saída, e para revisar suas limitações, consulte Acesso entre workspaces.

Tipos de acesso​

As regras se aplicam a diferentes escopos de solicitações recebidas. Cada escopo representa uma categoria de solicitações recebidas que você pode permitir ou negar:

Políticas em nível de workspace oferecem suporte aos seguintes tipos de acesso:

  • interface do usuário do espaço de trabalho : acesso do navegador ao workspace.

  • API : Acesso programático por meio de APIs do Databricks, incluindo SQL endpoints (JDBC / ODBC). Você pode direcionar qualquer um dos seguintes:

    • Todas as APIs.
    • Um escopo de API específico, usando IN . Por exemplo, você pode especificar apps, painéis ou servindo modelo.
    • Todos os escopos de API, exceto os selecionados, usando NOT IN .
  • Tempo de execução de aplicativos : Permita ou negue acesso a implantações do Databricks Apps. See Databricks Apps. Somente a opção de identidade Todos os usuários e entidades de serviço é compatível com este tipo de acesso.

  • Lakebase Runtime : conexões com instâncias de banco de dados do Lakebase. See Lakebase. Apenas a opção de identidade All users and service principals é suportada para este tipo de acesso.

Tipos de acesso a políticas em nível de account (Beta):

  • Account UI : acesso do navegador a recursos de nível de account (por exemplo, o console da account e o Genie One de nível de account).
  • API da conta : Acesso programático por meio das APIs da conta Databricks.

Identidades​

As regras podem ter como destino diferentes tipos de identidade. Para os tipos de acesso Apps runtime e Lakebase runtime , a única opção compatível é Todos os usuários e Service Principal .

  • Todos os usuários e a entidade de serviço Databricks : tanto usuários humanos quanto automatizados.
  • Todos os usuários : somente usuários humanos.
  • Todos Databricks entidade de serviço : apenas identidades de automação.
  • Identidades selecionadas : usuários específicos ou Service Principal do Databricks.

Avaliação de regras​

  • negação padrão : No modo restrito, o acesso é negado, a menos que seja explicitamente permitido.
  • Negar antes de permitir : As regras de negação permitem definir exceções às suas regras de permissão.
  • Política default no nível do workspace : Cada account tem uma política de entrada default no nível do workspace aplicada a todos os workspaces qualificados sem uma atribuição de política explícita.

Modos de execução​

As políticas de entrada baseadas em contexto permitem dois modos:

  • Aplicado a todos os produtos : Databricks aplica ativamente as regras e bloqueia solicitações que as violam.
  • Modo de execução a seco para todos os produtos : Databricks logs as violações, mas não bloqueia as solicitações. Use este modo para avaliar o impacto da política antes de aplicá-la.
nota

Uma política de rede suporta apenas um modo de aplicação por vez.

A Databricks recomenda começar no modo de execução de teste para observar o impacto da política antes de alterná-la para o modo de aplicação.

Auditoria​

As solicitações negadas ou de execução de teste são registradas na tabela do sistema system.access.inbound_network. Caso não tenha acesso às tabelas do sistema, um administrador de metastore pode conceder as permissões. Consulte Conceder acesso às tabelas do sistema.

Cada entrada de log inclui:

  • Horário do evento
  • ID do workspace
  • Rótulo da regra (da regra que negou a solicitação)
  • Tipo de solicitação
  • Identidade
  • Origem
  • Tipo de acesso (DENIED ou DRY_RUN_DENIAL)

As recusas da política de nível da account são registradas com workspace_id definido como 0.

Consulte esses logs para verificar se suas regras funcionam conforme o esperado e para detectar tentativas de acesso inesperadas.

Relacionamento com outros controles​

  • Listas de acesso IP do Workspace : Avaliadas juntamente com a política de ingresso baseada em contexto usando um AND lógico, sem sequência estrita entre as duas. Uma solicitação é permitida somente se a lista de acesso IP e a política de ingresso a permitirem. As listas de acesso IP do Workspace podem restringir ainda mais o acesso, mas não podem ampliá-lo.
  • controle de saída sem servidor : complementa as políticas de entrada controlando o tráfego de rede de saída da compute serverless . Consulte gerenciamento de políticas de rede.
  • Acesso entre Workspace : controla quais Workspace de origem podem alcançar um Workspace por meio de tráfego Serverless, além dos controles de origem e identidade nesta página. Consulte Acesso entre Workspace.
  • Listas de acesso de IP de destinatário do OpenSharing : a entrada baseada em contexto não se aplica às listas de acesso de IP de destinatário do OpenSharing. Este é um controle separado para destinatários abertos que os provedores configuram por destinatário. Consulte Restringir o acesso do destinatário do OpenSharing usando listas de acesso IP (compartilhamento Databricks-para-Open).
dica

Para reduzir a complexidade, a Databricks recomenda usar a política de entrada baseada em contexto como o seu único mecanismo de política, em vez de manter também listas de acesso de IP. Se seus workspaces já tiverem listas de acesso de IP, consulte Migrar listas de acesso de IP de workspaces para entrada baseada em contexto.

  • Listas de Acesso IP da Conta : avaliadas em conjunto com a política no nível da conta de entrada baseada em contexto usando um AND lógico, sem sequência estrita entre as duas. Uma solicitação é permitida somente se a lista de acesso IP e a política no nível da account a permitirem. Listas de acesso IP da conta podem restringir ainda mais o acesso, mas não podem ampliá-lo.
  • Alternância de acesso público para configuração de acesso privado : Aplicado juntamente com políticas de ingresso quando Acesso público é Governado por suas políticas de ingresso do Databricks . Se Acesso público estiver como Bloquear acesso à rede pública , o ingresso público será bloqueado e as políticas de ingresso não serão avaliadas. Consulte Gerenciar configurações de acesso privado.
  • Conectividade privada de front-end :
    • Para que o tráfego seja permitido, tanto as configurações de acesso privado quanto a entrada baseada em contexto devem permitir o endpoint. Por default, a entrada baseada em contexto está definida para Permitir acesso de todos os Endpoint privados , o que adia a decisão de acesso para a configuração de acesso privado do Workspace. Esta opção cobre até 200 Endpoint privados registrados. Para aumentar o limite, entre em contato com sua equipe de account. Para configurar políticas de acesso privado baseadas em contexto, anexe uma configuração de acesso privado ao seu Workspace que permita todos os Endpoint registrados. Isso adia a decisão de acesso para a política de entrada baseada em contexto do seu workspace. Consulte Configurar política de acesso privado.
    • Para a política no nível da conta, a entrada baseada em contexto é a única fonte de verdade para a política de acesso privado.

Gerenciar políticas de entrada baseadas em contexto​

Configure e anexe políticas no nível que corresponde ao recurso que você deseja proteger:

Para configurar regras públicas e privadas na política em nível de conta que protege os recursos em nível de conta, consulte Gerenciar políticas de entrada baseadas em contexto da conta.

API e Terraform​

Além do console da account, você pode gerenciar políticas de entrada baseadas em contexto programaticamente:

  • API REST : Use a API REST do Databricks para gerenciar políticas de rede.
  • Terraform : use o provedor Databricks Terraform para gerenciar políticas de entrada como infraestrutura como código.

Melhores práticas​

  • Comece com o modo de execução de teste para observar os impactos sem interromper o acesso.
  • Use regras baseadas em identidade sempre que possível para clientes SaaS que rotacionam IPs.
  • Aplique as regras de negação primeiro às entidades de serviço privilegiadas do Databricks para limitar a área afetada.
  • Mantenha os nomes das políticas claros e consistentes.

Disponibilidade​

O controle de entrada baseado em contexto está disponível em todas as regiões.