Solicitar tokens OAuth com detalhes de autorização

Use authorization_details em uma solicitação de token OAuth de espaço de trabalho para solicitar acesso a um recurso específico. Cada serviço Azure Databricks define os objetos de autorização que seu token precisa.

Como funcionam os detalhes da autorização

Enviar authorization_details como parâmetro de formulário em uma POST solicitação para https://<databricks-instance>/oidc/v1/token, onde <databricks-instance> é o seu <databricks-instance> com o nome da instância do workspace Azure Databricks, por adb-1234567890123456.7.azuredatabricks.netexemplo. O valor é um array JSON não vazio de objetos de autorização. Cada objeto tem um type e campos definidos pelo serviço que você deseja acessar.

Para uma solicitação de credenciais de cliente, o Azure Databricks verifica se o principal de serviço possui as permissões solicitadas antes de emitir o token. A resposta do token e o token de acesso incluem os detalhes da autorização aprovada. Solicitar detalhes de autorização não concede permissões ao principal do serviço.

A concessão de credenciais de cliente OAuth machine-to-machine (M2M) suporta esse parâmetro. A troca de tokens da AI Search também o utiliza. Os fluxos authorization-code e refresh-token ignoram authorization_details fornecidos ao endpoint de token.

Serviços que utilizam detalhes de autorização

Os seguintes guias de serviço documentam solicitações de token com authorization_details:

Solicitar um token

  1. Siga o guia do seu serviço na lista anterior para conceder acesso ao recurso ao solicitante e construir o array JSON necessário. Alguns serviços exigem outros parâmetros de solicitação de token, como resource.

  2. Para uma solicitação M2M, siga Gere um token de acesso em nível de espaço de trabalho. Adicione o valor de authorization_details do serviço à solicitação 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"
    

    Configure CLIENT_ID e CLIENT_SECRET conforme descrito no guia M2M. Substitua <databricks-instance> por seu <databricks-instance> pelo nome da instância do workspace Azure Databricks, por exemploadb-1234567890123456.7.azuredatabricks.net, e <JSON-array-from-service-guide> pelo array JSON do guia de serviço. Inclua quaisquer parâmetros adicionais exigidos pelo serviço, como resource para Zerobus Ingest.

Para uma troca de token do AI Search a partir de um notebook, siga Obter um token OAuth de um notebook em vez disso.