SqlAuthenticationProvider Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit le comportement de base des fournisseurs d’authentification et fournit une classe de base pour les classes dérivées.
public ref class SqlAuthenticationProvider abstract
public abstract class SqlAuthenticationProvider
type SqlAuthenticationProvider = class
Public MustInherit Class SqlAuthenticationProvider
- Héritage
-
SqlAuthenticationProvider
- Dérivé
Exemples
L’exemple suivant illustre l’implémentation d’un SqlAuthenticationProvider personnalisé et la fourniture de ce dernier à SqlClient pour remplacer le mode d’authentification de flux de code d’appareil :
using System;
using System.Threading.Tasks;
using Microsoft.Identity.Client;
using Microsoft.Data.SqlClient;
namespace CustomAuthenticationProviderExamples
{
/// <summary>
/// Example demonstrating creating a custom device code flow authentication provider and attaching it to the driver.
/// This is helpful for applications that wish to override the Callback for the Device Code Result implemented by the SqlClient driver.
/// </summary>
public class CustomDeviceCodeFlowAzureAuthenticationProvider : SqlAuthenticationProvider
{
public override async Task<SqlAuthenticationToken> AcquireTokenAsync(SqlAuthenticationParameters parameters)
{
string clientId = "my-client-id";
string clientName = "My Application Name";
string s_defaultScopeSuffix = "/.default";
string[] scopes = new string[] { parameters.Resource.EndsWith(s_defaultScopeSuffix) ? parameters.Resource : parameters.Resource + s_defaultScopeSuffix };
IPublicClientApplication app = PublicClientApplicationBuilder.Create(clientId)
.WithAuthority(parameters.Authority)
.WithClientName(clientName)
.WithRedirectUri("https://login.microsoftonline.com/common/oauth2/nativeclient")
.Build();
AuthenticationResult result = await app.AcquireTokenWithDeviceCode(scopes,
deviceCodeResult => CustomDeviceFlowCallback(deviceCodeResult)).ExecuteAsync();
return new SqlAuthenticationToken(result.AccessToken, result.ExpiresOn);
}
public override bool IsSupported(SqlAuthenticationMethod authenticationMethod) => authenticationMethod.Equals(SqlAuthenticationMethod.ActiveDirectoryDeviceCodeFlow);
private Task CustomDeviceFlowCallback(DeviceCodeResult result)
{
Console.WriteLine(result.Message);
return Task.FromResult(0);
}
}
public class Program
{
public static void Main()
{
// Register our custom authentication provider class to override Active Directory Device Code Flow
SqlAuthenticationProvider.SetProvider(SqlAuthenticationMethod.ActiveDirectoryDeviceCodeFlow, new CustomDeviceCodeFlowAzureAuthenticationProvider());
using (SqlConnection sqlConnection = new SqlConnection("Server=<myserver>.database.windows.net;Authentication=Active Directory Device Code Flow;Database=<db>;"))
{
sqlConnection.Open();
Console.WriteLine("Connected successfully!");
}
}
}
}
Remarques
Les classes dérivées doivent fournir un constructeur sans paramètre si elles peuvent être instanciées à partir du fichier app.config.
Constructeurs
SqlAuthenticationProvider() |
Définit le comportement de base des fournisseurs d’authentification et fournit une classe de base pour les classes dérivées. |
Méthodes
AcquireTokenAsync(SqlAuthenticationParameters) |
Acquiert un jeton de sécurité auprès de l’autorité. |
BeforeLoad(SqlAuthenticationMethod) |
Cette méthode est appelée juste avant que le fournisseur ne soit ajouté au registre de pilotes SQL. |
BeforeUnload(SqlAuthenticationMethod) |
Cette méthode est appelée juste avant que le fournisseur ne soit supprimé du registre de pilotes SQL. |
GetProvider(SqlAuthenticationMethod) |
Définit un fournisseur d’authentification par méthode. |
IsSupported(SqlAuthenticationMethod) |
Indique si la méthode d’authentification spécifiée est prise en charge. |
SetProvider(SqlAuthenticationMethod, SqlAuthenticationProvider) |
Définit un fournisseur d’authentification par méthode. |