SqlAuthenticationProvider Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menentukan perilaku inti penyedia autentikasi dan menyediakan kelas dasar untuk kelas turunan.
public ref class SqlAuthenticationProvider abstract
public abstract class SqlAuthenticationProvider
type SqlAuthenticationProvider = class
Public MustInherit Class SqlAuthenticationProvider
- Warisan
-
SqlAuthenticationProvider
- Turunan
Contoh
Contoh berikut menunjukkan penerapan SqlAuthenticationProvider kustom dan menyediakan yang sama untuk SqlClient untuk menimpa mode autentikasi Alur Kode Perangkat:
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!");
}
}
}
}
Keterangan
Kelas turunan harus menyediakan konstruktor tanpa parameter jika dapat digunakan dari file app.config.
Konstruktor
SqlAuthenticationProvider() |
Menentukan perilaku inti penyedia autentikasi dan menyediakan kelas dasar untuk kelas turunan. |
Metode
AcquireTokenAsync(SqlAuthenticationParameters) |
Memperoleh token keamanan dari otoritas. |
BeforeLoad(SqlAuthenticationMethod) |
Metode ini dipanggil segera sebelum penyedia ditambahkan ke registri driver SQL. |
BeforeUnload(SqlAuthenticationMethod) |
Metode ini dipanggil segera sebelum penyedia dihapus dari registri driver SQL. |
GetProvider(SqlAuthenticationMethod) |
Mendapatkan penyedia autentikasi dengan metode . |
IsSupported(SqlAuthenticationMethod) |
Menunjukkan apakah metode autentikasi yang ditentukan didukung. |
SetProvider(SqlAuthenticationMethod, SqlAuthenticationProvider) |
Mengatur penyedia autentikasi menurut metode. |