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:

• CLI do Databricks
• Provedor Databricks Terraform
• Databricks Connect
• Extensão do Databricks para Visual Studio Code
• SDK do Databricks para Python
• SDK do Databricks para Java
• SDK do Databricks para Go

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)

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

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.