.NET-apps verifiëren bij Azure-services tijdens lokale ontwikkeling met behulp van brokered-verificatie

Windows biedt een verificatiebroker met de naam Web Account Manager (WAM). MET WAM kunnen id-providers zoals Microsoft Entra ID systeemeigen worden aangesloten op het besturingssysteem en veilige aanmeldingsservices bieden aan apps. Met brokered-verificatie kan de app worden ingeschakeld voor alle bewerkingen die zijn toegestaan door de interactieve aanmeldingsreferenties.

Persoonlijke Microsoft-accounts en werk- of schoolaccounts worden ondersteund. In ondersteunde Windows-versies wordt de standaardgebruikersinterface op basis van een browser vervangen door een soepelere verificatie-ervaring, vergelijkbaar met ingebouwde Windows-apps.

macOS bevat geen ingebouwde verificatiebroker. Brokered-verificatie wordt ondersteund via de Azure.Identity.Broker bibliotheek, die platformspecifieke mechanismen gebruikt en kan worden geïntegreerd met apps zoals Microsoft-bedrijfsportal wanneer apparaten worden beheerd. Zie microsoft Enterprise SSO-invoegtoepassing voor Apple-apparaten voor meer informatie.

Linux gebruikt eenmalige aanmelding van Microsoft voor Linux als verificatiebroker.

De Azure Identity-bibliotheek ondersteunt brokered verificatie met behulp van InteractiveBrowserCredential. Als u bijvoorbeeld wilt gebruiken InteractiveBrowserCredential in een TENANT-app voor verificatie bij Azure Key Vault met de SecretClientvolgende stappen:

De Azure Identity-bibliotheek biedt interactieve brokered verificatie met behulp van InteractiveBrowserCredential. Als u bijvoorbeeld wilt gebruiken InteractiveBrowserCredential in een console-app voor verificatie bij Azure Key Vault met de SecretClientvolgende stappen:

1. Installeer de Azure.Identity - en Azure.Identity.Broker-pakketten .

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

2. Haal een verwijzing op naar het bovenliggende venster waarop het dialoogvenster accountkiezer moet worden weergegeven.

3. Maak een exemplaar van InteractiveBrowserCredential het gebruik 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. Installeer de Azure.Identity - en Azure.Identity.Broker-pakketten .

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

   Opmerking

   macOS-ondersteuning bestaat in Azure.Identity.Broker versie 1.3.0 en hoger.

2. Haal een verwijzing op naar het bovenliggende venster waarop het dialoogvenster accountkiezer moet worden weergegeven.

3. Maak een exemplaar van InteractiveBrowserCredential het gebruik 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. Installeer de Azure.Identity - en Azure.Identity.Broker-pakketten .

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

   Opmerking

   Linux-ondersteuning bestaat in Azure.Identity.Broker versies 1.3.0 en hoger.

2. Haal een verwijzing op naar het bovenliggende venster waarop het dialoogvenster accountkiezer moet worden weergegeven.

3. Maak een exemplaar van InteractiveBrowserCredential het gebruik 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;
}

In de volgende schermopname ziet u de alternatieve interactieve, brokered authentication-ervaring:

In de volgende schermopname ziet u de alternatieve interactieve, brokered authentication-ervaring:

In de volgende video ziet u de alternatieve interactieve, brokered verificatie-ervaring: