Idioma

IPublicClientApplication.AcquireTokenWithDeviceCode Método

Definição

Adquire um token num dispositivo sem navegador web permitindo que o utilizador se autentique noutro dispositivo. Este método não procura na cache de tokens, mas armazena o resultado nele. Antes de chamar este método, use outros métodos, como AcquireTokenSilent(IEnumerable<String>, IAccount) verificar a cache do token.

public Microsoft.Identity.Client.AcquireTokenWithDeviceCodeParameterBuilder AcquireTokenWithDeviceCode(System.Collections.Generic.IEnumerable<string> scopes, Func<Microsoft.Identity.Client.DeviceCodeResult,System.Threading.Tasks.Task> deviceCodeResultCallback);
abstract member AcquireTokenWithDeviceCode : seq<string> * Func<Microsoft.Identity.Client.DeviceCodeResult, System.Threading.Tasks.Task> -> Microsoft.Identity.Client.AcquireTokenWithDeviceCodeParameterBuilder
Public Function AcquireTokenWithDeviceCode (scopes As IEnumerable(Of String), deviceCodeResultCallback As Func(Of DeviceCodeResult, Task)) As AcquireTokenWithDeviceCodeParameterBuilder

Parâmetros

scopes
IEnumerable<String>

Os escopos são solicitados para aceder a uma API protegida.

deviceCodeResultCallback
Func<DeviceCodeResult,Task>

Callback contendo informações para mostrar ao utilizador como autenticar e introduzir o código do dispositivo.

Devoluções

Um construtor que permite adicionar parâmetros opcionais antes de executar o pedido de token.

Observações

A aquisição do token é feita em dois passos:

  • O método adquire primeiro um código de dispositivo da autoridade e devolve-o ao chamador através do deviceCodeResultCallback. Este callback trata da interação com o utilizador para o direcionar para autenticar (ou seja, para uma URL específica, com um código).
  • O método prossegue então para consultar o token de segurança, que é concedido após o login bem-sucedido pelo utilizador, com base na informação do código do dispositivo.
Ver Fluxo de Código do Dispositivo.

Aplica-se a