OAuth-Token mit Autorisierungsdetails anfordern

Verwenden Sie authorization_details in einer Workspace-OAuth-Token-Anfrage, um Zugriff auf eine bestimmte Ressource anzufordern. Jeder Azure Databricks-Dienst definiert die Autorisierungsobjekte, die sein Token benötigt.

Wie Autorisierungsdetails funktionieren

Senden Sie authorization_details als Formularparameter in einer POST-Anfrage an https://<databricks-instance>/oidc/v1/token, wobei <databricks-instance> Ihr <databricks-instance> mit dem Azure Databricks-workspace instance name ist, zum Beispiel adb-1234567890123456.7.azuredatabricks.net. Der Wert ist ein nichtleeres JSON-Array von Autorisierungsobjekten. Jedes Objekt hat ein type und Felder, die durch den Dienst definiert sind, auf den Sie zugreifen möchten.

Für eine Anfrage zu Client-Anmeldeinformationen prüft Azure Databricks, ob der Service-Principal die angeforderten Berechtigungen besitzt, bevor das Token ausgestellt wird. Die Token-Antwort und das Zugriffstoken enthalten die Details zur genehmigten Autorisierung. Das Anfordern von Autorisierungsdetails erteilt dem Serviceprincipal keine Berechtigungen.

Der OAuth Machine-to-Machine (M2M)-Client-Credentials-Grant unterstützt diesen Parameter. Auch der AI Search Token-Austausch nutzt es. Die Autorisierungscode- und Refresh-Token-Erteilungen ignorieren das dem Token-Endpunkt bereitgestellte authorization_details.

Dienste, die Autorisierungsdetails verwenden

Die folgenden Service-Leitfäden dokumentieren Token-Anfragen mit authorization_details:

Anfordern eines Tokens

  1. Folgen Sie der Leitfaden Ihres Dienstes in der vorstehenden Liste, um der anfragenden Identität Zugriff auf die Ressource zu gewähren und das erforderliche JSON-Array zu erstellen. Einige Dienste benötigen weitere Token-Anfrageparameter, wie etwa resource.

  2. Für eine M2M-Anfrage gehen Sie vor wie unter Generate a workspace-level access token. Fügen Sie der Token-Anfrage den authorization_details Wert des Dienstes hinzu:

    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"
    

    Set CLIENT_ID und CLIENT_SECRET wie im M2M-Leitfaden beschrieben. Ersetzen Sie <databricks-instance> durch Ihren adb-1234567890123456.7.azuredatabricks.net mit dem Azure Databricks-<databricks-instance>, zum Beispiel <JSON-array-from-service-guide>, und durch das JSON-Array aus dem Serviceleitfaden. Fügen Sie alle zusätzlichen vom Dienst erforderlichen Parameter hinzu, beispielsweise resource für Zerobus Ingest.

Für einen AI-Suchtokenaustausch aus einem Notizbuch lesen Sie stattdessen Get an OAuth-Token aus einem Notizbuch abrufen.