Autentisera .NET-appar till Azure-tjänster under lokal utveckling med hjälp av asynkron autentisering

Windows tillhandahåller en autentiseringskoordinator med namnet Web Account Manager (WAM). WAM gör det möjligt för identitetsprovidrar som Microsoft Entra-ID att ansluta internt till operativsystemet och tillhandahålla säkra inloggningstjänster till appar. Med asynkron autentisering kan appen utföra alla åtgärder som tillåts av autentiseringsuppgifterna för interaktiv inloggning.

Personliga Microsoft-konton och arbets- eller skolkonton stöds. I Windows-versioner som stöds ersätts det webbläsarbaserade standardgränssnittet med en smidigare autentiseringsupplevelse, ungefär som för inbyggda Windows-appar.

macOS innehåller inte inbyggt en inbyggd autentiseringskoordinator. Asynkron Azure.Identity.Broker autentisering stöds via biblioteket, som använder plattformsspecifika mekanismer och kan integreras med appar som Microsoft-företagsportalen när enheter hanteras. Mer information finns i Microsoft Enterprise SSO-plugin-programmet för Apple-enheter.

Linux använder enkel inloggning med Microsoft för Linux som autentiseringskoordinator.

Azure Identity-biblioteket stöder asynkron autentisering med hjälp av InteractiveBrowserCredential. Om du till exempel vill använda InteractiveBrowserCredential i en MAUI-app för att autentisera till Azure Key Vault med följer du dessa SecretClientsteg:

Azure Identity-biblioteket tillhandahåller interaktiv asynkron autentisering med hjälp av InteractiveBrowserCredential. Om du till exempel vill använda InteractiveBrowserCredential i en konsolapp för att autentisera till Azure Key Vault med följer du dessa SecretClientsteg:

1. Installera paketen Azure.Identity och Azure.Identity.Broker .

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

2. Hämta en referens till det överordnade fönstret där dialogrutan för kontoväljare ska visas.

3. Skapa en instans av InteractiveBrowserCredential att använda InteractiveBrowserCredentialBrokerOptions.

// 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. Installera paketen Azure.Identity och Azure.Identity.Broker .

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

   Anmärkning

   macOS-stöd finns i Azure.Identity.Broker version 1.3.0 och senare.

2. Hämta en referens till det överordnade fönstret där dialogrutan för kontoväljare ska visas.

3. Skapa en instans av InteractiveBrowserCredential att använda InteractiveBrowserCredentialBrokerOptions.

// 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. Installera paketen Azure.Identity och Azure.Identity.Broker .

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

   Anmärkning

   Linux-stöd finns i Azure.Identity.Broker version 1.3.0 och senare.

2. Hämta en referens till det överordnade fönstret där dialogrutan för kontoväljare ska visas.

3. Skapa en instans av InteractiveBrowserCredential att använda InteractiveBrowserCredentialBrokerOptions.

/// <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;
}

Följande skärmbild visar den alternativa interaktiva, asynkrona autentiseringsupplevelsen:

Följande skärmbild visar den alternativa interaktiva, asynkrona autentiseringsupplevelsen:

Följande video visar den alternativa interaktiva, asynkrona autentiseringsupplevelsen: