ブローカー認証を使用したローカル開発中に Azure サービスに対して .NET アプリを認証する

Windows には、 Web アカウント マネージャー (WAM) と呼ばれる認証ブローカーが用意されています。 WAM を使用すると、Microsoft Entra ID などの ID プロバイダーが OS にネイティブにプラグインし、セキュリティで保護されたログイン サービスをアプリに提供できます。 ブローカー認証を使用すると、対話型ログイン資格情報によって許可されるすべての操作に対してアプリが有効になります。

個人の Microsoft アカウントと職場または学校アカウントがサポートされています。 サポートされている Windows バージョンでは、既定のブラウザー ベースの UI は、組み込みの Windows アプリと同様に、よりスムーズな認証エクスペリエンスに置き換えられます。

macOS には、組み込みの認証ブローカーがネイティブに含まれていません。 ブローカー認証は、プラットフォーム固有のメカニズムを使用する Azure.Identity.Broker ライブラリを介してサポートされ、デバイスが管理されるときに Microsoft ポータル サイトなどのアプリと統合される場合があります。 詳細については、 Apple デバイス用の Microsoft Enterprise SSO プラグインに関するページを参照してください。

Linux では、Linux 用の Microsoft シングル サインオン を認証ブローカーとして使用します。

Azure ID ライブラリでは、 InteractiveBrowserCredentialを使用したブローカー認証がサポートされています。 たとえば、MAUI アプリで InteractiveBrowserCredential を使用して、 SecretClientを使用して Azure Key Vault に対する認証を行うには、次の手順に従います。

Azure ID ライブラリは、 InteractiveBrowserCredentialを使用した対話型のブローカー認証を提供します。 たとえば、コンソール アプリで InteractiveBrowserCredential を使用して、 SecretClientを使用して Azure Key Vault に対する認証を行うには、次の手順に従います。

1. Azure.Identity パッケージと Azure.Identity.Broker パッケージをインストールします。

   dotnet add package Azure.Identity
   dotnet add package Azure.Identity.Broker
   

2. アカウント ピッカー ダイアログが表示される親ウィンドウへの参照を取得します。

3. InteractiveBrowserCredentialBrokerOptionsを使用してInteractiveBrowserCredentialのインスタンスを作成します。

// Get the parent window handle for MAUI on Windows
Microsoft.Maui.Controls.Window? parentWindow = this.GetParentWindow();
Microsoft.UI.Xaml.Window? windowHandle = parentWindow?.Handler?.PlatformView as Microsoft.UI.Xaml.Window;
IntPtr hwnd = windowHandle != null ? WinRT.Interop.WindowNative.GetWindowHandle(windowHandle) : IntPtr.Zero;

// Configure InteractiveBrowserCredentialBrokerOptions with parent window reference
InteractiveBrowserCredentialBrokerOptions options = new(hwnd)
{
    UseDefaultBrokerAccount = true,
};

// Create credential that will use WAM broker on Windows
InteractiveBrowserCredential credential = new(options);

SecretClient client = new(new Uri(KeyVaultUrl), credential);
KeyVaultSecret secret = await client.GetSecretAsync(SecretName);

1. Azure.Identity パッケージと Azure.Identity.Broker パッケージをインストールします。

   dotnet add package Azure.Identity
   dotnet add package Azure.Identity.Broker
   

   注

   macOS のサポートは、 Azure.Identity.Broker バージョン 1.3.0 以降に存在します。

2. アカウント ピッカー ダイアログが表示される親ウィンドウへの参照を取得します。

3. InteractiveBrowserCredentialBrokerOptionsを使用してInteractiveBrowserCredentialのインスタンスを作成します。

// Get the parent window handle for MAUI on Mac Catalyst
Microsoft.Maui.Controls.Window? parentWindow = this.GetParentWindow();
UIWindow? uiWindow = parentWindow?.Handler?.PlatformView as UIWindow;
IntPtr hwnd = uiWindow != null ? uiWindow.Handle : IntPtr.Zero;

// Configure InteractiveBrowserCredentialBrokerOptions with parent window reference
InteractiveBrowserCredentialBrokerOptions options = new(hwnd)
{
    UseDefaultBrokerAccount = true,
};

// Create credential that will use the broker on macOS
InteractiveBrowserCredential credential = new(options);

SecretClient client = new(new Uri(KeyVaultUrl), credential);
KeyVaultSecret secret = await client.GetSecretAsync(SecretName);

1. Azure.Identity パッケージと Azure.Identity.Broker パッケージをインストールします。

   dotnet add package Azure.Identity
   dotnet add package Azure.Identity.Broker
   

   注

   Linux サポートは、 Azure.Identity.Broker バージョン 1.3.0 以降に存在します。

2. アカウント ピッカー ダイアログが表示される親ウィンドウへの参照を取得します。

3. InteractiveBrowserCredentialBrokerOptionsを使用してInteractiveBrowserCredentialのインスタンスを作成します。

/// <summary>
/// Get the handle of the console window for Linux
/// </summary>
[DllImport("libX11")]
static extern IntPtr XOpenDisplay(string display);

[DllImport("libX11")]
static extern IntPtr XRootWindow(IntPtr display, int screen);

try
{
    IntPtr parentWindowHandle = XRootWindow(XOpenDisplay(null), 0);
    Func<IntPtr> consoleWindowHandleProvider = () => parentWindowHandle;

    InteractiveBrowserCredentialBrokerOptions options = new(parentWindowHandle)
    {
        UseDefaultBrokerAccount = true,
    };
    
    // Create the InteractiveBrowserCredential using broker support
    InteractiveBrowserCredential credential = new(options);

    Uri vaultUri = new("https://<your-key-vault-name>.vault.azure.net/");
    SecretClient client = new(vaultUri, credential);

    Console.WriteLine("Retrieving secret 'MySecret' from Key Vault...");
    KeyVaultSecret secret = await client.GetSecretAsync("MySecret");

    return 0;
}

次のスクリーンショットは、代替の対話型のブローカー認証エクスペリエンスを示しています。

次のスクリーンショットは、代替の対話型のブローカー認証エクスペリエンスを示しています。

次のビデオでは、代替の対話型の仲介型認証エクスペリエンスを示します。