Аутентификация .NET-приложений в службах Azure при локальной разработке с использованием брокерской аутентификации

Windows предоставляет брокер аутентификации под названием Диспетчер веб-учетных записей (WAM). WAM позволяет поставщикам идентификационных данных, таким как Microsoft Entra ID, непосредственно интегрироваться с ОС и предоставлять безопасные службы входа в приложения. Проверка подлинности с помощью брокера позволяет приложению выполнять все операции, разрешенные интерактивными учетными данными для входа.

Поддерживаются личные учетные записи Майкрософт и рабочие или учебные учетные записи. В поддерживаемых версиях Windows пользовательский интерфейс на основе браузера по умолчанию заменяется более плавной проверкой подлинности, аналогично встроенным приложениям Windows.

macOS не включает встроенный брокер проверки подлинности. Библиотека клиентских удостоверений Azure реализует функции авторизации брокером с помощью механизмов, специфичных для платформы, и может интегрироваться с такими приложениями, как Корпоративный портал Майкрософт, при управлении устройствами. Дополнительные сведения см. в разделе плагин единого входа Microsoft Enterprise для устройств Apple.

Linux использует Microsoft единый вход для Linux в качестве брокера аутентификации.

Библиотека удостоверений Azure поддерживает аутентификацию с помощью брокера InteractiveBrowserCredential. Например, чтобы использовать InteractiveBrowserCredential в приложении MAUI для аутентификации в Azure Key Vault с помощью SecretClient, выполните следующие действия.

Библиотека удостоверений Azure предоставляет интерактивную брокерскую аутентификацию с помощью InteractiveBrowserCredential. Например, чтобы использовать InteractiveBrowserCredential в консольном приложении для проверки подлинности в Azure Key Vault с помощью SecretClient, выполните следующие действия:

1. Установите пакеты Azure.Identity и Azure.Identity.Broker .

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

2. Получите ссылку на родительское окно, вверху которого должно отображаться диалоговое окно выбора учетной записи.

3. Создайте экземпляр InteractiveBrowserCredential с помощью 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. Установите пакеты 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. Создайте экземпляр InteractiveBrowserCredential с помощью 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. Установите пакеты 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. Создайте экземпляр InteractiveBrowserCredential с помощью 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;
   }
   

На следующем снимку экрана показан альтернативный интерактивный интерфейс проверки подлинности с брокером:

На следующем снимку экрана показан альтернативный интерактивный интерфейс проверки подлинности с брокером:

В следующем видео показано альтернативное интерактивное взаимодействие с проверкой подлинности с помощью брокера: