Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Microsoft. Identity.Web é um conjunto de pacotes NuGet que simplificam a adição de autenticação e autorização a aplicativos que se integram ao plataforma de identidade da Microsoft. Cada pacote tem como destino um cenário específico, de modo que você instale apenas o que seu aplicativo precisa. Este artigo descreve os pacotes disponíveis e ajuda você a escolher o ideal.
Pacotes principais
Esses pacotes fornecem a funcionalidade fundamental para autenticação e gerenciamento de tokens.
| Package | Descrição |
|---|---|
| Microsoft. Identity.Web | O pacote principal para ASP.NET Core aplicativos Web e APIs Web. Habilita a entrada, a validação de token e a chamada de APIs downstream. |
| Microsoft. Identity.Web.UI | Fornece componentes de UI para aplicativos Web ASP.NET Core, incluindo controladores e visões de entrada e saída. |
| Microsoft. Identity.Web.TokenAcquisition | API de nível superior para aquisição de token em aplicativos cliente confidenciais (ASP.NET Core e SDK de .NET). Manipula o gerenciamento de tokens automaticamente. |
| Microsoft. Identity.Web.TokenCache | Serializadores de cache de token para aplicativos cliente confidenciais do MSAL.NET. Oferece suporte ao cache em memória, distribuído e baseado em sessão. |
Pacotes de gerenciamento de credenciais
Esses pacotes lidam com diferentes tipos de credencial de autenticação.
| Package | Descrição |
|---|---|
| Microsoft. Identity.Web.Certificate | Recursos de gerenciamento de certificados para MSAL.NET, incluindo o carregamento de certificados de Azure Key Vault e repositórios locais. |
| Microsoft. Identity.Web.Certificateless | Cenários de autenticação sem certificado, como identidades gerenciadas e federação de identidades de cargas de trabalho. |
Pacotes de integração e API de destino
Esses pacotes ajudam você a chamar APIs protegidas e a integrar-se aos serviços Azure.
| Package | Descrição |
|---|---|
| Microsoft. Identity.Web.DownstreamApi | Interface de nível superior para chamar APIs protegidas downstream de aplicativos cliente confidenciais com gerenciamento automático de token. |
| Microsoft. Identity.Web. Azure | Permite que aplicativos Web e APIs Web ASP.NET Core usem SDKs do Azure com a plataforma de identidade Microsoft, fornecendo implementações TokenCredential. |
| Microsoft. Identity.Web.OWIN | Permite que ASP.NET aplicativos Web (OWIN/Katana) e APIs Web no .NET Framework usem o plataforma de identidade da Microsoft. |
pacotes de Microsoft Graph
Esses pacotes fornecem integração com Microsoft Graph para chamar serviços de Microsoft 365.
| Package | Descrição |
|---|---|
| Microsoft. Identity.Web.GraphServiceClient | Integração do Microsoft Graph usando o SDK do Graph v5 e versões posteriores. Recomendado para novos projetos. |
| Microsoft. Identity.Web.GraphServiceClientBeta | Integração beta do Microsoft Graph usando o SDK do Graph v5 e posteriores. Use este pacote para acessar recursos de visualização. |
| Microsoft. Identity.Web.MicrosoftGraph | Integração do Microsoft Graph com o SDK do Graph v4. Utilize pacotes GraphServiceClient para novos projetos. |
| Microsoft. Identity.Web.MicrosoftGraphBeta | Integração beta do Microsoft Graph usando o Graph SDK v4. |
Pacotes de cenário avançados
Esses pacotes dão suporte a cenários de autenticação especializados.
| Package | Descrição |
|---|---|
| Microsoft. Identity.Web.Diagnostics | Suporte a diagnóstico e registro em log para solucionar problemas de autenticação. |
| Microsoft. Identity.Web.OidcFIC | Implementação do provedor FIC (Cloud Federation Identity Credential). Habilita cenários de autenticação entre nuvens. |
| Microsoft. Identity.Web.AgentIdentities | Métodos auxiliares para cenários de identidade de agente, incluindo a criação de agentes autônomos e integrações de copilotos. |
Escolha o pacote certo
Use os exemplos a seguir para instalar os pacotes que correspondem ao cenário do aplicativo.
Aplicativos Web que inscrevem usuários
Para aplicativos web ASP.NET Core que autenticam usuários com Microsoft Entra ID, instale o pacote principal e o pacote de interface do usuário.
dotnet add package Microsoft.Identity.Web
dotnet add package Microsoft.Identity.Web.UI
APIs Web protegidas
Para ASP.NET Core APIs Web que validam tokens de chamadores autenticados, instale o pacote principal:
dotnet add package Microsoft.Identity.Web
Aplicativos daemon e serviços em segundo plano
Para aplicativos daemon ou serviços em segundo plano que adquirem tokens sem interação do usuário, instale o pacote de aquisição de token:
dotnet add package Microsoft.Identity.Web.TokenAcquisition
Chamando Microsoft Graph
Para novos projetos, use o pacote do SDK do Graph v5:
dotnet add package Microsoft.Identity.Web.GraphServiceClient
Se o projeto usar o SDK do Graph v4, instale o pacote de integração anterior:
dotnet add package Microsoft.Identity.Web.MicrosoftGraph
Usando SDKs do Azure
Para autenticar os clientes do SDK do Azure com a plataforma de identidade da Microsoft, instale o pacote de integração do Azure:
dotnet add package Microsoft.Identity.Web.Azure
Chamando APIs downstream personalizadas
Para chamar suas próprias APIs protegidas com gerenciamento automático de token, instale o pacote de API downstream:
dotnet add package Microsoft.Identity.Web.DownstreamApi
Cenários de agente e copilot
Para criar agentes autônomos ou integrações de copilot, instale o pacote de identidades do agente:
dotnet add package Microsoft.Identity.Web.AgentIdentities
Aplicativos OWIN (.NET Framework)
Para ASP.NET aplicativos Web e APIs Web no .NET Framework (OWIN/Katana), instale o pacote OWIN:
dotnet add package Microsoft.Identity.Web.OWIN