Microsoft Entra 認証と SqlClient を使用して Azure SQL に接続する

[アーティクル]
02/28/2024

適用対象： .NET Framework .NET .NET Standard

この記事では、.NET アプリケーションから SqlClient で Microsoft Entra 認証を使用して Azure SQL データソースに接続する方法について説明します。

Note

Microsoft Entra ID はAzure Active Directory (Azure AD) の新しい名前ですが、既存の環境の中断を防ぐために、UI フィールド、接続プロバイダー、エラーコード、コマンドレットなど、ハードコーディングされた一部の要素でAzure AD が残ります。この記事では、2 つの名前は交換可能です。

概要

Microsoft Entra 認証では、Microsoft Entra ID を使用して、Azure SQL データベース、Azure SQL Managed Instance、Azure Synapse Analytics などの Azure SQL データソースにアクセスします。 Microsoft.Data.SqlClient 名前空間を使用すると、クライアントアプリケーションで Azure SQL データベースおよび Azure SQL Managed Instance に接続しているときに、さまざまな認証モードで Microsoft Entra 認証情報を指定できます。 Azure SQL で Microsoft Entra 認証を使用するには、Azure SQL で Microsoft Entra 認証を構成して管理する必要があります。

接続文字列の Authentication 接続プロパティを設定すると、クライアントでは、指定された値に従って優先する Microsoft Entra 認証モードを選択できます。

最初の Microsoft.Data.SqlClient バージョンでは、.NET Framework、.NET Core、および .NET Standard の Active Directory Password がサポートされています。また、.NET Framework の Active Directory Integrated 認証と Active Directory Interactive 認証もサポートされています。
Microsoft.Data.SqlClient 2.0.0 から、Active Directory Integrated 認証と Active Directory Interactive 認証のサポートが .NET Framework、.NET Core、および .NET Standard にわたって拡張されました。

SqlClient 2.0.0 には、新しい Active Directory Service Principal 認証モードも追加されています。サービスプリンシパル ID のクライアント ID とシークレットを使用して認証を行います。
Microsoft.Data.SqlClient 2.1.0 には、他にも認証モードが追加されています (Active Directory Device Code Flow や Active Directory Managed Identity (別名 Active Directory MSI) など)。これらの新しいモードにより、アプリケーションでサーバーに接続するためのアクセストークンを取得できます。

次のセクションで説明する以外の Microsoft Entra 認証の詳細については、「Microsoft Entra 認証を使用する」を参照してください。

Microsoft Entra 認証の設定

アプリケーションが Microsoft Entra 認証を使用して Azure SQL データソースに接続するときは、有効な認証モードを指定する必要があります。次の表に、サポートされている認証モードの一覧を示します。アプリケーションでは、接続文字列の Authentication 接続プロパティを使用してモードを指定します。

値	説明	Microsoft.Data.SqlClient のバージョン
Active Directory パスワード	Microsoft Entra ID のユーザー名とパスワードによる認証	1.0 以降
Active Directory 統合	統合 Windows 認証 (IWA) を使用した Microsoft Entra ID での認証	2.0.0 以降¹
Active Directory 対話型	対話型認証を使用した Microsoft Entra ID での認証	2.0.0 以降¹
Active Directory サービスプリンシパル	クライアント ID とシークレットを使用した Microsoft Entra サービスプリンシパルでの認証	2.0.0 以降
Active Directory デバイスコードフロー	デバイスコードフローモードを使用した Microsoft Entra ID での認証	2.1.0 以降
Active Directory Managed Identity、 Active Directory MSI	Microsoft Entra のシステム割り当てまたはユーザー割り当てマネージド ID を使用した認証	2.1.0 以降
Active Directory の既定値	マネージド ID、Visual Studio Code、Visual Studio、Azure CLI など、パスワードレスの非対話型のメカニズムを使用した Microsoft Entra ID での認証	3.0.0 以降
Active Directory のワークロード ID	フェデレーションユーザー割り当てマネージド ID を使用して、ワークロード ID のサポートを有効にしている Azure クライアント環境から SQL Database に接続することで、Microsoft Entra ID で認証します。	5.2.0+

¹Microsoft.Data.SqlClient 2.0.0 より前は、Active Directory Integrated および Active Directory Interactive の認証モードは .NET Framework でのみサポートされます。

パスワード認証の使用

Active Directory Password 認証モードでは、ネイティブまたはフェデレーション Microsoft Entra ユーザーの Microsoft Entra ID を使用した Azure データソースへの認証がサポートされます。このモードを使用する場合は、接続文字列にユーザー資格情報を指定する必要があります。次の例は、Active Directory Password 認証を使用する方法を示しています。

// Use your own server, database, user ID, and password.
string ConnectionString = @"Server=demo.database.windows.net; Authentication=Active Directory Password; Encrypt=True; Database=testdb; User Id=user@domain.com; Password=***";

using (SqlConnection conn = new SqlConnection(ConnectionString)) {
    conn.Open();
}

統合認証の使用

Active Directory Integrated 認証モードを使用するには、クラウドの Microsoft Entra ID に参加しているオンプレミスの Active Directory インスタンスが必要です。たとえば、Active Directory フェデレーションサービス (AD FS) を使用してフェデレーションを行うことができます。

ドメイン参加済みのマシンにサインインしている場合は、このモードで資格情報の入力を求められることなく、Azure SQL データソースにアクセスできます。 .NET Framework アプリケーションの接続文字列にユーザー名とパスワードを指定することはできません。 .NET Core および .NET Standard アプリケーションの接続文字列では、ユーザー名は省略可能です。このモードでは、SqlConnection の Credential プロパティを設定することはできません。

次のコードスニペットは、Active Directory Integrated 認証が使用されている場合の例です。

// Use your own server and database.
string ConnectionString1 = @"Server=demo.database.windows.net; Authentication=Active Directory Integrated; Encrypt=True; Database=testdb";

using (SqlConnection conn = new SqlConnection(ConnectionString1)) {
    conn.Open();
}

// User ID is optional for .NET Core and .NET Standard.
string ConnectionString2 = @"Server=demo.database.windows.net; Authentication=Active Directory Integrated; Encrypt=True; Database=testdb; User Id=user@domain.com";

using (SqlConnection conn = new SqlConnection(ConnectionString2)) {
    conn.Open();
}

対話型認証の使用

Active Directory Interactive 認証では、Azure SQL データソースに接続するための多要素認証テクノロジがサポートされています。この認証モードを接続文字列で指定すると、Azure 認証画面が表示され、ユーザーは有効な資格情報を入力するように求められます。接続文字列にパスワードを指定することはできません。

このモードでは、SqlConnection の Credential プロパティを設定することはできません。 Microsoft.Data.SqlClient 2.0.0 以降では、対話モードの場合に接続文字列でのユーザー名の使用が許可されます。

次の例は、Active Directory Interactive 認証を使用する方法を示しています。

// Use your own server, database, and user ID.
// User ID is optional.
string ConnectionString1 = @"Server=demo.database.windows.net; Authentication=Active Directory Interactive; Encrypt=True; Database=testdb; User Id=user@domain.com";

using (SqlConnection conn = new SqlConnection(ConnectionString1)) {
    conn.Open();
}

// User ID is not provided.
string ConnectionString2 = @"Server=demo.database.windows.net; Authentication=Active Directory Interactive; Encrypt=True; Database=testdb";

using (SqlConnection conn = new SqlConnection(ConnectionString2)) {
    conn.Open();
}

サービスプリンシパル認証の使用

Active Directory Service Principal 認証モードでは、クライアントアプリケーションは、サービスプリンシパル ID のクライアント ID とシークレットを指定することによって、Azure SQL データソースに接続できます。サービスプリンシパル認証には次が伴います。

シークレットを使用してアプリの登録を設定する。
Azure SQL Database インスタンスのアプリにアクセス許可を付与する。
正しい資格情報で接続する。

次の例は、Active Directory Service Principal 認証を使用する方法を示しています。

// Use your own server, database, app ID, and secret.
string ConnectionString = @"Server=demo.database.windows.net; Authentication=Active Directory Service Principal; Encrypt=True; Database=testdb; User Id=AppId; Password=secret";

using (SqlConnection conn = new SqlConnection(ConnectionString)) {
    conn.Open();
}

デバイスコードフロー認証の使用

.NET 用 Microsoft Authentication Library (MSAL.NET) を使用すると、Active Directory Device Code Flow 認証により、クライアントアプリケーションで、対話型の Web ブラウザーがインストールされていないデバイスやオペレーティングシステムから Azure SQL データソースに接続できます。対話型認証は、別のデバイスで実行されます。デバイスコードフロー認証の詳細については、OAuth 2.0 デバイスコードフローに関する記事を参照してください。

このモードを使用している場合、SqlConnection の Credential プロパティを設定することはできません。また、接続文字列でユーザー名とパスワードを指定することはできません。

次のコードスニペットは、Active Directory Device Code Flow 認証を使用する場合の例です。

注意

Active Directory Device Code Flow のタイムアウトの既定値は、接続の Connect Timeout 設定です。デバイスコードフローの認証プロセスを余裕を持って実行できる Connect Timeout を指定してください。

// Use your own server and database and increase Connect Timeout as needed for device code flow.
string ConnectionString = @"Server=demo.database.windows.net; Authentication=Active Directory Device Code Flow; Encrypt=True; Database=testdb; Connect Timeout=180;";

using (SqlConnection conn = new SqlConnection(ConnectionString)) {
    conn.Open();
}

マネージド ID 認証の使用

SQL へのプログラムによるアクセスには、Azure リソース用マネージド ID による認証が推奨される認証方法です。クライアントアプリケーションは、リソースのシステム割り当てマネージド ID またはユーザー割り当てマネージド ID を使用して、ID を指定し、それを使用してアクセストークンを取得することで、Microsoft Entra ID を使用して SQL に対する認証を行うことができます。このメソッドにより、認証情報とシークレットを管理する必要がなくなり、アクセス管理を簡略化できます。

マネージド ID には、次の 2 種類があります。

システム割り当てマネージド ID は、Azure リソース (SQL Managed Instance や論理サーバーなど) の一部として作成され、そのリソースのライフサイクルを共有します。システム割り当て ID は、1 つの Azure リソースにのみ関連付けることができます。
"ユーザー割り当てマネージド ID" は、スタンドアロンの Azure リソースとして作成されます。 Azure サービスの 1 つ以上のインスタンスに割り当てることができます。

マネージド ID の詳細については、Azure リソースのマネージド ID の概要に関する記事を参照してください。

Microsoft.Data.SqlClient 2.1.0 以降、ドライバーでは、マネージド ID を使用してアクセストークンを取得することによる Azure SQL Database、Azure Synapse Analytics、および Azure SQL Managed Instance への認証がサポートされています。この認証を使用するには、接続文字列で Active Directory Managed Identity、Active Directory MSI のいずれかを指定します。パスワードは必要ありません。このモードで SqlConnection の Credential プロパティを設定することはできません。

ユーザー割り当てマネージド ID の場合、Microsoft.Data.SqlClient v3.0 以降を使用するときは、マネージド ID のクライアント ID を指定する必要があります。 Microsoft.Data.SqlClient v2.1 を使用している場合は、マネージド ID のオブジェクト ID を指定する必要があります。

次の例は、システム割り当てマネージド ID で Active Directory Managed Identity 認証を使用する方法を示しています。

// For system-assigned managed identity
// Use your own values for Server and Database.
string ConnectionString1 = @"Server=demo.database.windows.net; Authentication=Active Directory Managed Identity; Encrypt=True; Database=testdb";

using (SqlConnection conn = new SqlConnection(ConnectionString1)) {
    conn.Open();
}

string ConnectionString2 = @"Server=demo.database.windows.net; Authentication=Active Directory MSI; Encrypt=True; Database=testdb";

using (SqlConnection conn = new SqlConnection(ConnectionString2)) {
    conn.Open();
}

次の例では、ユーザー割り当てマネージド ID と Microsoft.Data.SqlClient v3.0 以降を使用する Active Directory Managed Identity 認証を示します。

// For user-assigned managed identity
// Use your own values for Server, Database, and User Id.

// With Microsoft.Data.SqlClient v3.0+
string ConnectionString1 = @"Server=demo.database.windows.net; Authentication=Active Directory Managed Identity; Encrypt=True; User Id=ClientIdOfManagedIdentity; Database=testdb";

using (SqlConnection conn = new SqlConnection(ConnectionString1)) {
    conn.Open();
}

// With Microsoft.Data.SqlClient v3.0+
string ConnectionString2 = @"Server=demo.database.windows.net; Authentication=Active Directory MSI; Encrypt=True; User Id=ClientIdOfManagedIdentity; Database=testdb";

using (SqlConnection conn = new SqlConnection(ConnectionString2)) {
    conn.Open();
}

次の例では、ユーザー割り当てマネージド ID と Microsoft.Data.SqlClient v2.1 を使用する Active Directory Managed Identity 認証を示します。

// For user-assigned managed identity
// Use your own values for Server, Database, and User Id.

// With Microsoft.Data.SqlClient v2.1
string ConnectionString1 = @"Server=demo.database.windows.net; Authentication=Active Directory Managed Identity; Encrypt=True; User Id=ObjectIdOfManagedIdentity; Database=testdb";

using (SqlConnection conn = new SqlConnection(ConnectionString1)) {
    conn.Open();
}

// With Microsoft.Data.SqlClient v2.1
string ConnectionString2 = @"Server=demo.database.windows.net; Authentication=Active Directory MSI; Encrypt=True; User Id=ObjectIdOfManagedIdentity; Database=testdb";

using (SqlConnection conn = new SqlConnection(ConnectionString2)) {
    conn.Open();
}

デフォルトの認証方法の使用

この認証モードはバージョン 3.0 以降で使用可能になり、これを使用すると、ユーザー認証の可能性が広がります。このモードでは、ログインソリューションが、クライアント環境、Visual Studio Code、Visual Studio、Azure CLI などに拡張されます。

この認証モードを使用すると、ドライバーでは、Azure Identity ライブラリから "DefaultAzureCredential" を渡してアクセストークンを取得することによってトークンを取得します。このモードでは、認証情報タイプのセットを使用して、アクセストークンの順に取得することが試みられます。使用する Azure ID ライブラリのバージョンによって認証情報のセットは異なります。バージョン固有の相違点はリストに記載されています。 Azure ID バージョン固有の動作については、Azure.Identity API のドキュメントを参照してください。

EnvironmentCredential
- クライアントとシークレット、またはユーザー名とパスワード、環境変数 AZURE_TENANT_ID、AZURE_CLIENT_ID、AZURE_CLIENT_SECRET、AZURE_CLIENT_CERTIFICATE_PATH、AZURE_USERNAME、AZURE_PASSWORD で構成された詳細を使用して、Microsoft Entra ID への認証を有効にします (詳細)
WorkloadIdentityCredential
- ワークロード ID をサポートする Kubernetes、およびその他のホストで、Microsoft Entra ワークロード ID 認証を有効にします。詳細については、「Microsoft Entra ワークロード ID」を参照してください。対応するバージョンは、Azure Identity バージョン 1.10 および Microsoft.Data.SqlClient 5.1.4 以降です。
ManagedIdentityCredential
- デプロイ環境に割り当てられているマネージド ID を使用して、Microsoft Entra ID への認証を試みます。 "ユーザー割り当てマネージド ID" の "クライアント Id" は、 "User Id" 接続プロパティから読み取られます。
SharedTokenCacheCredential
- Microsoft アプリケーション間で共有されるローカルキャッシュ内のトークンを使用して認証を行います。
VisualStudioCredential
- Visual Studio からのデータを使用して Microsoft Entra ID による認証を有効化する
VisualStudioCodeCredential
- Visual Studio Code からのデータを使用して Microsoft Entra ID による認証を有効化します。
AzurePowerShellCredential
- Azure PowerShell を使用した Microsoft Entra ID による認証を有効にします。対応するバージョンは、Azure Identity バージョン 1.6 および Microsoft.Data.SqlClient 5.0 以降です。
AzureCliCredential
- Azure CLI を使用して Microsoft Entra ID による認証を有効にして、アクセストークンを取得します。
AzureDeveloperCliCredential
- Azure Developer CLI を使用して Microsoft Entra ID での認証を有効にして、アクセストークンを取得します。対応するバージョンは、Azure Identity バージョン 1.10 および Microsoft.Data.SqlClient 5.1.4 以降です。

Note

InteractiveBrowserCredential は "Active Directory Default" のドライバーの実装では無効になっており、"Active Directory Interactive" が、MFA と Interactive 認証を使用してトークンを取得するために使用できる唯一のオプションです。

現在、その他のカスタマイズオプションは使用できません。

次の例では、Active Directory Default 認証を使用する方法を示します。

// Use your own server, database
string ConnectionString = @"Server=demo.database.windows.net; Authentication=Active Directory Default; Encrypt=True; Database=testdb;";

using (SqlConnection conn = new SqlConnection(ConnectionString)) {
    conn.Open();
}

ワークロード ID 認証の使用

マネージド ID と同様に、バージョン 5.2 以降で使用できるワークロード ID認証モードでは、指定されている場合、そのクライアント ID に接続文字列のユーザー ID パラメーターの値が使用されます。ただし、マネージド ID とは異なり、WorkloadIdentityCredentialOptions の既定値は環境変数 (AZURE_TENANT_ID、AZURE_CLIENT_ID、AZURE_FEDERATED_TOKEN_FILE) です。ただし、接続文字列によってオーバーライドできるのはクライアント ID だけです。

次の例は、Microsoft.Data.SqlClient v5.2 以降でのユーザー割り当てマネージド ID による Active Directory Workload Identity 認証を示しています。

// Use your own values for Server, Database, and User Id.
// With Microsoft.Data.SqlClient v5.2+
string ConnectionString = @"Server=demo.database.windows.net; Authentication=Active Directory Workload Identity; Encrypt=True; User Id=ClientIdOfManagedIdentity; Database=testdb";

using (SqlConnection conn = new SqlConnection(ConnectionString)) {
    conn.Open();
}

Microsoft Entra 認証のカスタマイズ

Microsoft.Data.SqlClient 2.1.0 以降では、ドライバーに組み込まれている Microsoft Entra 認証を使用するだけでなく、Microsoft Entra 認証をカスタマイズするためのオプションがアプリケーションに提供されます。カスタマイズは、SqlAuthenticationProvider 抽象クラスから派生した ActiveDirectoryAuthenticationProvider クラスに基づきます。

Microsoft Entra 認証中、クライアントアプリケーションは次のいずれかの方法で独自の ActiveDirectoryAuthenticationProvider クラスを定義できます。

カスタマイズされたコールバックメソッドを使用する。
アクセストークンをフェッチするために SqlClient ドライバーを使用してアプリケーションクライアント ID を MSAL ライブラリに渡す。

次の例は、Active Directory Device Code Flow 認証を使用している場合にカスタムコールバックを使用する方法を示しています。

using System;
using System.Threading.Tasks;
using Microsoft.Identity.Client;
using Microsoft.Data.SqlClient;

namespace CustomAuthenticationProviderExamples
{
    public class Program
    {
        public static void Main()
        {
            SqlAuthenticationProvider authProvider = new ActiveDirectoryAuthenticationProvider(CustomDeviceFlowCallback);
            SqlAuthenticationProvider.SetProvider(SqlAuthenticationMethod.ActiveDirectoryDeviceCodeFlow, authProvider);
            using (SqlConnection sqlConnection = new SqlConnection("Server=<myserver>.database.windows.net;Authentication=Active Directory Device Code Flow;Database=<db>;"))
            {
                sqlConnection.Open();
                Console.WriteLine("Connected successfully!");
            }
        }

        private static Task CustomDeviceFlowCallback(DeviceCodeResult result)
        {
            // Provide custom logic to process result information and read device code.
            Console.WriteLine(result.Message);
            return Task.FromResult(0);
        }
    }
}

カスタマイズされた ActiveDirectoryAuthenticationProvider クラスでは、サポートされている Microsoft Entra 認証モードが使用されている場合に、ユーザー定義のアプリケーションクライアント ID を SqlClient に渡すことができます。サポートされている Microsoft Entra 認証モードには Active Directory Password、Active Directory Integrated、Active Directory Interactive、Active Directory Service Principal、Active Directory Device Code Flow があります。

アプリケーションクライアント ID は、SqlAuthenticationProviderConfigurationSection または SqlClientAuthenticationProviderConfigurationSection を使用して構成することもできます。構成プロパティ applicationClientId は、.NET Framework 4.6 以降と .NET Core 2.1 以降に適用されます。

次のコードスニペットは、Active Directory Interactive 認証が使用されている場合に、カスタマイズされた ActiveDirectoryAuthenticationProvider クラスをユーザー定義のアプリケーションクライアント ID と共に使用する例です。

using System;
using Microsoft.Data.SqlClient;

namespace CustomAuthenticationProviderExamples
{
    public class Program
    {
        public static void Main()
        {
            // Supported for all authentication modes supported by ActiveDirectoryAuthenticationProvider
            ActiveDirectoryAuthenticationProvider provider = new ActiveDirectoryAuthenticationProvider("<application_client_id>");
            if (provider.IsSupported(SqlAuthenticationMethod.ActiveDirectoryInteractive))
            {
                SqlAuthenticationProvider.SetProvider(SqlAuthenticationMethod.ActiveDirectoryInteractive, provider);
            }
            
            using (SqlConnection sqlConnection = new SqlConnection("Server=<myserver>.database.windows.net;Authentication=Active Directory Interactive;Database=<db>;"))
            {
                sqlConnection.Open();
                Console.WriteLine("Connected successfully!");
            }
        }
    }
}

次の例は、configuration セクションを使用してアプリケーションクライアント ID を設定する方法を示しています。

<configuration>
  <configSections>
    <section name="SqlClientAuthenticationProviders"
             type="Microsoft.Data.SqlClient.SqlClientAuthenticationProviderConfigurationSection, Microsoft.Data.SqlClient" />
  </configSections>
  <SqlClientAuthenticationProviders applicationClientId ="<GUID>" />
</configuration>

<!--or-->

<configuration>
  <configSections>
    <section name="SqlAuthenticationProviders"
             type="Microsoft.Data.SqlClient.SqlAuthenticationProviderConfigurationSection, Microsoft.Data.SqlClient" />
  </configSections>
  <SqlAuthenticationProviders applicationClientId ="<GUID>" />
</configuration>

カスタム SQL 認証プロバイダーのサポート

柔軟性の向上により、クライアントアプリケーションでは、ActiveDirectoryAuthenticationProvider クラスを使用する代わりに、Microsoft Entra 認証用に独自のプロバイダーを使用することもできます。カスタム認証プロバイダーは、オーバーライドされたメソッドを含む SqlAuthenticationProvider のサブクラスである必要があります。さらに、既存の 1 つ以上の Active Directory* 認証方法をオーバーライドして、カスタムプロバイダーを登録する必要があります。

次の例は、Active Directory Device Code Flow 認証用に新しい認証プロバイダーを使用する方法を示しています。

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!");
            }
        }
    }
}

Active Directory Interactive 認証エクスペリエンスの改善に加え、Microsoft.Data.SqlClient 2.1.0 以降では、クライアントアプリケーションで対話型認証とデバイスコードフロー認証をカスタマイズするための次の API が提供されます。

public class ActiveDirectoryAuthenticationProvider
{
    // For .NET Framework targeted applications only
    // Sets a reference to the current System.Windows.Forms.IWin32Window that triggers the browser to be shown. 
    // Used to center the browser pop-up onto this window.
    public void SetIWin32WindowFunc(Func<IWin32Window> iWin32WindowFunc);

    // For .NET Standard targeted applications only
    // Sets a reference to the ViewController (if using Xamarin.iOS), Activity (if using Xamarin.Android) IWin32Window, or IntPtr (if using .NET Framework). 
    // Used for invoking the browser for Active Directory Interactive authentication.
    public void SetParentActivityOrWindowFunc(Func<object> parentActivityOrWindowFunc);

    // For .NET Framework, .NET Core, and .NET Standard targeted applications
    // Sets a callback method that's invoked with a custom web UI instance that will let the user sign in with Azure AD, present consent if needed, and get back the authorization code. 
    // Applicable when working with Active Directory Interactive authentication.
    public void SetAcquireAuthorizationCodeAsyncCallback(Func<Uri, Uri, CancellationToken, Task<Uri>> acquireAuthorizationCodeAsyncCallback);

    // For .NET Framework, .NET Core, and .NET Standard targeted applications
    // Clears cached user tokens from the token provider.
    public static void ClearUserTokenCache();
}

Microsoft Entra 認証と SqlClient を使用して Azure SQL に接続する

概要

Microsoft Entra 認証の設定

パスワード認証の使用

統合認証の使用

対話型認証の使用

サービスプリンシパル認証の使用

デバイスコードフロー認証の使用

マネージド ID 認証の使用

デフォルトの認証方法の使用

ワークロード ID 認証の使用

Microsoft Entra 認証のカスタマイズ

カスタム SQL 認証プロバイダーのサポート

関連項目

フィードバック

フィードバック

その他のリソース

Microsoft Entra 認証と SqlClient を使用して Azure SQL に接続する

概要

Microsoft Entra 認証の設定

パスワード認証の使用

統合認証の使用

対話型認証の使用

サービス プリンシパル認証の使用

デバイス コード フロー認証の使用

マネージド ID 認証の使用

デフォルトの認証方法の使用

ワークロード ID 認証の使用

Microsoft Entra 認証のカスタマイズ

カスタム SQL 認証プロバイダーのサポート

関連項目

フィードバック

フィードバック

その他のリソース

サービスプリンシパル認証の使用

デバイスコードフロー認証の使用