WebAuthenticationCoreManager.FindSystemAccountProviderAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| FindSystemAccountProviderAsync(String) |
Tenta de forma assíncrona encontrar um provedor de conta Web para autenticação em todo o dispositivo. |
| FindSystemAccountProviderAsync(String, String) |
Tenta de forma assíncrona encontrar um provedor de conta Web para autenticação em todo o dispositivo. |
| FindSystemAccountProviderAsync(String, String, User) |
Tenta de forma assíncrona encontrar um provedor de conta Web para autenticação em todo o dispositivo. |
FindSystemAccountProviderAsync(String)
Tenta de forma assíncrona encontrar um provedor de conta Web para autenticação em todo o dispositivo.
public:
static IAsyncOperation<WebAccountProvider ^> ^ FindSystemAccountProviderAsync(Platform::String ^ webAccountProviderId);/// [Windows.Foundation.Metadata.Overload("FindSystemAccountProviderAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<WebAccountProvider> FindSystemAccountProviderAsync(winrt::hstring const& webAccountProviderId);[Windows.Foundation.Metadata.Overload("FindSystemAccountProviderAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<WebAccountProvider> FindSystemAccountProviderAsync(string webAccountProviderId);function findSystemAccountProviderAsync(webAccountProviderId)Public Shared Function FindSystemAccountProviderAsync (webAccountProviderId As String) As IAsyncOperation(Of WebAccountProvider)Parâmetros
- webAccountProviderId
-
String
Platform::String
winrt::hstring
A ID do provedor de conta Web a ser encontrada.
Retornos
Uma operação de localização assíncrona. Após a conclusão bem-sucedida, contém um objeto WebAccountProvider que representa o provedor de conta Web encontrado.
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10, version 1803 (introduzida na 10.0.17134.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v6.0)
|
Aplica-se a
FindSystemAccountProviderAsync(String, String)
Tenta de forma assíncrona encontrar um provedor de conta Web para autenticação em todo o dispositivo.
public:
static IAsyncOperation<WebAccountProvider ^> ^ FindSystemAccountProviderAsync(Platform::String ^ webAccountProviderId, Platform::String ^ authority);/// [Windows.Foundation.Metadata.Overload("FindSystemAccountProviderWithAuthorityAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<WebAccountProvider> FindSystemAccountProviderAsync(winrt::hstring const& webAccountProviderId, winrt::hstring const& authority);[Windows.Foundation.Metadata.Overload("FindSystemAccountProviderWithAuthorityAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<WebAccountProvider> FindSystemAccountProviderAsync(string webAccountProviderId, string authority);function findSystemAccountProviderAsync(webAccountProviderId, authority)Public Shared Function FindSystemAccountProviderAsync (webAccountProviderId As String, authority As String) As IAsyncOperation(Of WebAccountProvider)Parâmetros
- webAccountProviderId
-
String
Platform::String
winrt::hstring
A ID do provedor de conta Web a ser encontrada.
- authority
-
String
Platform::String
winrt::hstring
A autoridade do provedor de conta Web a ser encontrada.
Retornos
Uma operação de localização assíncrona. Após a conclusão bem-sucedida, contém um objeto WebAccountProvider que representa o provedor de conta Web encontrado.
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10, version 1803 (introduzida na 10.0.17134.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v6.0)
|
Exemplos
Veja a seguir um exemplo desse caso especial de recuperação de token em todo o dispositivo.
// create a WebTokenRequest with device-wide authentication
WebTokenRequest CreateWebTokenRequestForAad(WebAccountProvider provider){
// check if the ID provider allows system-wide scope, and construct token request accordingly:
return new WebTokenRequest(
provider,
provider.IsSystemProvider ? "systemInfo" : "userInfo",
"<InsertClientID>");
)
}
// retrieve a device-wide auth token for Azure Active Directory
string GetAadToken() {
var provider = WebAuthenticationCoreManager.FindSystemAccountProviderAsync(
"https://login.microsoft.com","organizations");
var request = CreateWebTokenRequestForAad(provider);
var result = WebAuthenticationCoreManager.GetTokenSilentlyAsync(request);
// handle the request result in the usual way.
if (result.ResponseStatus == WebTokenRequestStatus.Success){
return result.ResponseData[0].Token;
} else {
throw new Exception(result.ResponseError.ErrorMessage);
}
}
Comentários
O recurso de token de dispositivo destina-se a casos em que um serviço precisa se conectar aos recursos de nuvem antes que um usuário entre no dispositivo (por exemplo, em experiências prontas para uso em que há políticas de SCCM (System Center Configuration Manager) que devem ser aplicadas imediatamente). Somente provedores de ID de primeira parte (Xbox, MSA, AAD) permitem tokens em todo o dispositivo; outros provedores de ID não.
Confira também
Aplica-se a
FindSystemAccountProviderAsync(String, String, User)
Tenta de forma assíncrona encontrar um provedor de conta Web para autenticação em todo o dispositivo.
public:
static IAsyncOperation<WebAccountProvider ^> ^ FindSystemAccountProviderAsync(Platform::String ^ webAccountProviderId, Platform::String ^ authority, User ^ user);/// [Windows.Foundation.Metadata.Overload("FindSystemAccountProviderWithAuthorityForUserAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<WebAccountProvider> FindSystemAccountProviderAsync(winrt::hstring const& webAccountProviderId, winrt::hstring const& authority, User const& user);[Windows.Foundation.Metadata.Overload("FindSystemAccountProviderWithAuthorityForUserAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<WebAccountProvider> FindSystemAccountProviderAsync(string webAccountProviderId, string authority, User user);function findSystemAccountProviderAsync(webAccountProviderId, authority, user)Public Shared Function FindSystemAccountProviderAsync (webAccountProviderId As String, authority As String, user As User) As IAsyncOperation(Of WebAccountProvider)Parâmetros
- webAccountProviderId
-
String
Platform::String
winrt::hstring
A ID do provedor de conta Web a ser encontrada.
- authority
-
String
Platform::String
winrt::hstring
A autoridade do provedor de conta Web a ser encontrada.
- user
- User
O usuário associado ao provedor de conta Web a ser encontrado.
Retornos
Uma operação de localização assíncrona. Após a conclusão bem-sucedida, contém um objeto WebAccountProvider que representa o provedor de conta Web encontrado.
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10, version 1803 (introduzida na 10.0.17134.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v6.0)
|
Aplica-se a
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de