Pular para o conteúdo principal

Autenticação unificada do Databricks

A autenticação unificada da Databricks oferece uma maneira consistente de configurar e automatizar a autenticação como parte da autorização OAuth. O senhor define a autenticação uma vez e reutiliza a mesma configuração em todas as ferramentas e SDKs compatíveis da Databricks. Isso evita manter credenciais separadas para cada ferramenta e garante um comportamento de autenticação consistente em todos os ambientes.

Quando você usa OAuth U2M com essas ferramentas, pode se autenticar como sua própria identidade de usuário ou atuar como um Service Principal que gerencia com OAuth OBO — por exemplo, para execução uma ferramenta com a identidade do Service Principal sem configurar um segredo. Consulte Autentique-se como um Service Principal usando OAuth OBO.

Ferramentas e SDKs participantes​

As ferramentas e SDKs participantes do Databricks são:

Todas as ferramentas e SDKs suportam autenticação por meio de perfis de configuração variáveis de ambiente e Databricks. O provedor Terraform da Databricks e os SDKs Python, Java e Go também permitem que o senhor configure a autenticação diretamente no código. Para obter detalhes, consulte a documentação da ferramenta ou do SDK.

Prioridade do método de autenticação​

Esta seção explica como as ferramentas e os SDKs priorizam os métodos de autenticação e onde eles procuram as credenciais.

ordem de autenticação padrão​

As ferramentas e os SDKs usam métodos de autenticação nesta ordem e param após o primeiro sucesso:

  1. Pessoal access tokens (legado)
  2. OAuth máquina a máquina (M2M)
  3. OAuth de usuário para máquina (U2M)
  4. Serviço de nuvem do Google account credenciais
  5. Identidade na nuvem do Google
nota

Para forçar um SDK a usar um método específico, defina o campo Databricks authentication type na API Config.

Ordem de pesquisa de credenciais​

Para cada método de autenticação, as ferramentas e os SDKs pesquisam as credenciais nesta ordem:

  1. Campos de configuração do SDK: Configuração direta no código (somente SDKs)

  2. variável de ambiente: Variáveis específicas da plataforma

  3. Perfil de configuração: arquivo .databrickscfg DEFAULT profile

  4. Google cloud CLI credenciais armazenadas em cache: Consulte Autenticação de ID da nuvem do Google

Melhores práticas​

Para obter a máxima portabilidade entre ambientes, faça o seguinte:

  1. Crie um perfil de configuração personalizado em seu arquivo .databrickscfg
  2. Adicione campos obrigatórios para o tipo de autenticação escolhido
  3. Defina a variável de ambiente DATABRICKS_CONFIG_PROFILE com o nome de seu perfil

Para obter uma lista completa dos campos de configuração e variáveis de ambiente compatíveis, consulte variável de ambiente e campos para autenticação unificada.