Demander des jetons OAuth avec les détails d’autorisation

Utilisez authorization_details dans une requête de jeton OAuth dans un espace de travail pour demander l’accès à une ressource spécifique. Chaque service Azure Databricks définit les objets d’autorisation dont son token a besoin.

Comment fonctionnent les détails d’autorisation

Envoyer authorization_details comme paramètre de formulaire dans une POST requête à https://<databricks-instance>/oidc/v1/token, où <databricks-instance> est votre <databricks-instance> avec le nom d’instance de l’espace de travail Azure Databricks, par adb-1234567890123456.7.azuredatabricks.netexemple . La valeur est un tableau JSON non vide d’objets d’autorisation. Chaque objet possède un type et des champs définis par le service auquel vous souhaitez accéder.

Pour une demande d’identifiants client, Azure Databricks vérifie si le principal du service dispose des autorisations demandées avant d’émettre le jeton. La réponse du jeton et le jeton d’accès incluent les détails de l’autorisation approuvée. Demander les détails d’autorisation n’accorde pas de permissions au principal du service.

Le flux d’informations d’identification du client machine-à-machine (M2M) OAuth prend en charge ce paramètre. L’échange de tokens AI Search l’utilise également. Les autorisations authorization-code et refresh-token ignorent authorization_details fournis au point de terminaison du jeton.

Services utilisant les détails d’autorisation

Les guides de service suivants documentent les demandes de jetons avec authorization_details:

Demander un jeton

  1. Suivez le guide de votre service dans la liste précédente pour accorder à l’identité demandante l’accès à la ressource et pour construire le tableau JSON requis. Certains services nécessitent d’autres paramètres de requête par jetons, tels que resource.

  2. Pour une requête M2M, suivez Générer un jeton d’accès au niveau de l’espace de travail. Ajoutez la valeur du authorization_details service à la requête de jeton :

    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"
    

    Définissez CLIENT_ID et CLIENT_SECRET comme décrit dans le guide M2M. Remplacez <databricks-instance> par votre <databricks-instance> par le nom de l’instance de l’espace de travail Azure Databricks, par exempleadb-1234567890123456.7.azuredatabricks.net, et <JSON-array-from-service-guide> par le tableau JSON du guide de service. Incluez tous les paramètres supplémentaires requis par le service, comme resource pour Zerobus Ingest.

Pour un échange de tokens AI Search depuis un carnet, suivez plutôt Obtenir un jeton OAuth depuis un carnet .