Autenticación unificada de Databricks

La autenticación unificada de Azure Databricks proporciona una manera coherente de configurar y automatizar la autenticación como parte de la autorización de OAuth. La autenticación se define una vez y se reutiliza la misma configuración en las herramientas y SDK de Azure Databricks compatibles. Esto evita mantener credenciales independientes para cada herramienta y garantiza un comportamiento de autenticación coherente en todos los entornos.

Cuando usas OAuth de usuario a máquina (U2M) con estas herramientas, puedes autenticarte como tu propia identidad de usuario. También puedes actuar como un principal de servicio que gestionas con OAuth on-behalf-of (OBO), por ejemplo, para ejecutar una herramienta con la identidad del principal de servicio sin configurar un secreto. Consulta Autenticar como un principal de servicio usando OAuth OBO.

Herramientas y SDK participantes

Las herramientas y SDKs participantes de Databricks incluyen:

Todas las herramientas y LOS SDK admiten la autenticación a través de variables de entorno y perfiles de configuración de Azure Databricks. El proveedor de Terraform de Databricks y los SDK de Python, Java y Go también le permiten configurar la autenticación directamente en el código. Para obtener más información, consulte la documentación de la herramienta o el SDK.

Prioridad del método de autenticación

En esta sección se explica cómo las herramientas y los SDK priorizan los métodos de autenticación y dónde buscan credenciales.

Orden de autenticación predeterminado

Las herramientas y los SDK intentan métodos de autenticación en este orden y se detienen después del primer éxito:

  1. Tokens de acceso personal (heredado)
  2. OAuth de máquina a máquina (M2M)
  3. OAuth usuario a máquina (U2M)
  4. Identidad administrada de Azure
  5. Entidad de servicio de Azure
  6. CLI de Azure

Nota:

Para forzar que un SDK use un método específico, establezca el campo Tipo de autenticación de Databricks en la Config API.

Orden de búsqueda de credenciales

Para cada método de autenticación, las herramientas y los SDK buscan credenciales en este orden:

  1. Campos de configuración del SDK: Configuración directa en el código (solo SDK)
  2. Variables de entorno: Variables específicas de la plataforma
  3. Perfil de configuración:.databrickscfg perfil del archivo DEFAULT
  1. Credenciales almacenadas en caché de la CLI de Azure: Consulte Autenticación con la CLI de Azure.

procedimientos recomendados

Para la portabilidad máxima entre entornos, haga lo siguiente:

  1. Creación de un perfil de configuración personalizado en el .databrickscfg archivo
  2. Agregar campos obligatorios para el tipo de autenticación elegido
  3. Establezca la variable de entorno DATABRICKS_CONFIG_PROFILE al nombre de su perfil.

Para obtener una lista completa de las variables de entorno y los campos de configuración admitidos, consulte Variables de entorno y campos para la autenticación unificada.