Autenticar aplicativos .NET nos serviços do Azure durante o desenvolvimento local usando a autenticação intermediada

O Windows fornece um agente de autenticação chamado Web Account Manager (WAM). O WAM permite que provedores de identidade, como o Microsoft Entra ID, se conectem nativamente ao sistema operacional e forneçam serviços de login seguro para aplicativos. A autenticação intermediada habilita o aplicativo para todas as operações permitidas pelas credenciais de login interativas.

Há suporte para contas pessoais da Microsoft e contas corporativas ou de estudante. Nas versões suportadas do Windows, a interface do usuário padrão baseada em navegador é substituída por uma experiência de autenticação mais suave, semelhante aos aplicativos internos do Windows.

O macOS não inclui nativamente um agente de autenticação integrado. A biblioteca cliente Azure Identity implementa funcionalidades de autenticação intermediada através de mecanismos específicos da plataforma e pode integrar-se com aplicações como o Microsoft Company Portal quando os dispositivos são geridos. Para obter mais informações, consulte Plug-in Microsoft Enterprise SSO para dispositivos Apple.

O Linux usa o logon único da Microsoft para Linux como seu agente de autenticação.

A biblioteca de identidade do Azure dá suporte à autenticação intermediada usando InteractiveBrowserCredential. Por exemplo, para usar InteractiveBrowserCredential em um aplicativo MAUI para autenticar no Cofre da Chave do Azure com o SecretClient, siga estas etapas:

A biblioteca de Identidade do Azure fornece autenticação interativa usando InteractiveBrowserCredential. Por exemplo, para usar InteractiveBrowserCredential em um aplicativo de console para autenticar no Azure Key Vault com o SecretClient, siga estas etapas:

1. Instale os pacotes Azure.Identity e Azure.Identity.Broker .

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

2. Obtenha uma referência à janela pai sobre a qual a caixa de diálogo do seletor de contas deve aparecer.

3. Crie uma instância de InteractiveBrowserCredential usando 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. Instale os pacotes Azure.Identity e Azure.Identity.Broker .

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

   Observação

   O suporte para macOS existe nas Azure.Identity.Broker versões 1.3.0 e posteriores.

2. Obtenha uma referência para a janela principal sobre a qual a caixa de diálogo do seletor de contas deve aparecer.

3. Crie uma instância de InteractiveBrowserCredential usando 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. Instale os pacotes Azure.Identity e Azure.Identity.Broker .

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

   Observação

   O suporte Linux existe nas Azure.Identity.Broker versões 1.3.0 e posteriores.

2. Obtenha uma referência para a janela principal sobre a qual a caixa de diálogo do seletor de contas deve aparecer.

3. Crie uma instância de InteractiveBrowserCredential usando 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;
   }
   

A captura de tela a seguir mostra a experiência alternativa de autenticação interativa e intermediada:

A captura de tela a seguir mostra a experiência alternativa de autenticação interativa e intermediada:

O vídeo a seguir mostra a experiência alternativa de autenticação interativa e intermediada: