Solicitar tokens OAuth con detalles de autorización

Úsase authorization_details en una solicitud de token OAuth de espacio de trabajo para solicitar acceso a un recurso específico. Cada servicio Azure Databricks define los objetos de autorización que necesita su token.

Cómo funcionan los detalles de autorización

Enviar authorization_details como parámetro de formulario en una POST solicitud a https://<databricks-instance>/oidc/v1/token, donde <databricks-instance> es tu <databricks-instance> con el nombre de instancia del espacio de trabajo de Azure Databricks, por adb-1234567890123456.7.azuredatabricks.netejemplo . El valor es un array JSON no vacío de objetos de autorización. Cada objeto tiene un type y campos definidos por el servicio al que quieres acceder.

Para una solicitud de credenciales de cliente, Azure Databricks comprueba si el principal de servicio tiene los permisos solicitados antes de emitir el token. La respuesta del token y el token de acceso incluyen los detalles de autorización aprobada. Solicitar detalles de autorización no concede permisos al principal del servicio.

La concesión de credenciales de cliente máquina a máquina (M2M) OAuth admite este parámetro. AI Search token exchange también lo utiliza. Las concesiones de código de autorización y de token de actualización ignoran los detalles de autorización authorization_details proporcionados al endpoint del token.

Servicios que utilizan detalles de autorización

Las siguientes guías de servicio documentan solicitudes de tokens con authorization_details:

Solicitud de un token

  1. Siga la guía de su servicio en la lista anterior para conceder acceso al recurso al solicitante y construir el array JSON requerido. Algunos servicios requieren otros parámetros de solicitud de token, como resource.

  2. Para una solicitud M2M, siga Generar un token de acceso a nivel de espacio de trabajo. Añade el valor de authorization_details del servicio a la solicitud de token:

    export AUTHORIZATION_DETAILS='<JSON-array-from-service-guide>'
    
    curl --request POST \
      --url "https://<databricks-instance>/oidc/v1/token" \
      --user "$CLIENT_ID:$CLIENT_SECRET" \
      --data 'grant_type=client_credentials' \
      --data 'scope=all-apis' \
      --data-urlencode "authorization_details=$AUTHORIZATION_DETAILS"
    

    Configura CLIENT_ID y CLIENT_SECRET tal como se describe en la guía M2M. Sustituye <databricks-instance> por tu <databricks-instance> por el nombre de instancia del espacio de trabajo de Azure Databricks, por ejemploadb-1234567890123456.7.azuredatabricks.net, y <JSON-array-from-service-guide> por el array JSON de la guía de servicio. Incluye cualquier parámetro adicional requerido por el servicio, como resource para Zerobus Ingest.

Para un intercambio de tokens de búsqueda AI desde un cuaderno, sigue en su lugar Obtener un token OAuth desde un cuaderno .