Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. 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 aplicações que se integram com a plataforma de identidades da Microsoft. Cada pacote visa um cenário específico, por isso instala apenas o que a sua aplicação precisa. Este artigo descreve os pacotes disponíveis e ajuda-o a escolher o ideal.
Pacotes principais
Estes pacotes fornecem a funcionalidade fundamental para autenticação e gestão de tokens.
| Package | Descrição |
|---|---|
| Microsoft.Identity.Web | O pacote principal para aplicações web e APIs web ASP.NET Core. Permite iniciar sessão, validação de tokens e chamar APIs a jusante. |
| Microsoft.Identity.Web.UI | Fornece componentes de interface de utilizador para aplicações web ASP.NET Core, incluindo controladores de início de sessão e término de sessão e vistas. |
| Microsoft. Identity.Web.TokenAcquisition | API de nível superior para aquisição de tokens em aplicações clientes confidenciais (ASP.NET Core e .NET SDK). Gere automaticamente a gestão dos tokens. |
| Microsoft. Identity.Web.TokenCache | Serializadores de cache de token para aplicações cliente confidenciais MSAL.NET. Suporta cache em memória, distribuída e baseada em sessões. |
Pacotes de gestão de credenciais
Estes pacotes lidam com diferentes tipos de credenciais de autenticação.
| Package | Descrição |
|---|---|
| Microsoft. Identity.Web.Certificate | Capacidades de gestão de certificados para MSAL.NET, incluindo carregamento de certificados do Azure Key Vault e lojas locais. |
| Microsoft.Identity.Web.Certificateless | Cenários de autenticação sem certificado, como identidades gerenciadas e federação de identidades para cargas de trabalho. |
API downstream e pacotes de integração
Estes pacotes ajudam-no a chamar APIs protegidas e a integrar-se com os serviços do Azure.
| Package | Descrição |
|---|---|
| Microsoft. Identity.Web.DownstreamApi | Interface de nível superior para chamar APIs protegidas a jusante a partir de aplicações clientes confidenciais com gestão automática de tokens. |
| Microsoft.Identity.Web.Azure | Permite que ASP.NET Core aplicações web e APIs web utilizem SDKs do Azure com a plataforma de identidades da Microsoft ao fornecer implementações TokenCredential. |
| Microsoft.Identity.Web.OWIN | Permite que aplicações web ASP.NET (OWIN/Katana) e APIs web no .NET Framework utilizem a plataforma de identidades da Microsoft. |
Pacotes Microsoft Graph
Estes pacotes fornecem integração com o Microsoft Graph para chamar serviços Microsoft 365.
| Package | Descrição |
|---|---|
| Microsoft. Identity.Web.GraphServiceClient | Integração com Microsoft Graph usando o Graph SDK v5 e versões posteriores. Recomendado para novos projetos. |
| Microsoft. Identity.Web.GraphServiceClientBeta | Integração do Microsoft Graph Beta usando o Graph SDK v5 e versões posteriores. Use este pacote para aceder a funcionalidades de pré-visualização. |
| Microsoft. Identity.Web.MicrosoftGraph | Integração do Microsoft Graph usando o Graph SDK v4. Utilize GraphServiceClient pacotes para novos projetos. |
| Microsoft. Identity.Web.MicrosoftGraphBeta | Integração do Microsoft Graph Beta usando o Graph SDK v4. |
Pacotes avançados de cenários
Estes pacotes suportam cenários de autenticação especializados.
| Package | Descrição |
|---|---|
| Microsoft. Identity.Web.Diagnostics | Suporte de diagnóstico e registo para resolver problemas de autenticação. |
| Microsoft. Identity.Web.OidcFIC | Implementação do fornecedor de credenciais de identidade de federação em nuvem (FIC). Permite cenários de autenticação entre plataformas na nuvem. |
| Microsoft.Identity.Web.AgentIdentidades | Métodos auxiliares para cenários de identidade de agentes, incluindo a construção de agentes autónomos e integrações com copilotos. |
Escolha o pacote certo
Use os seguintes exemplos para instalar os pacotes que correspondem ao seu cenário de aplicação.
Aplicações web que iniciam sessão de utilizadores
Para aplicações web ASP.NET Core que iniciam sessão de utilizadores com Microsoft Entra ID, instale o pacote core e o pacote UI:
dotnet add package Microsoft.Identity.Web
dotnet add package Microsoft.Identity.Web.UI
APIs web protegidas
Para APIs web ASP.NET Core que validam tokens de chamadores autenticados, instale o pacote principal:
dotnet add package Microsoft.Identity.Web
Aplicações e processos em segundo plano
Para aplicações de daemons ou serviços em segundo plano que adquirem tokens sem interação do utilizador, instale o pacote de aquisição de tokens:
dotnet add package Microsoft.Identity.Web.TokenAcquisition
Chamar Microsoft Graph
Para novos projetos, use o pacote Graph SDK v5:
dotnet add package Microsoft.Identity.Web.GraphServiceClient
Se o seu projeto usa o Graph SDK v4, instale o pacote de integração anterior:
dotnet add package Microsoft.Identity.Web.MicrosoftGraph
Usando SDKs do Azure
Para autenticar clientes SDK do Azure com a plataforma de identidades da Microsoft, instale o pacote de integração Azure:
dotnet add package Microsoft.Identity.Web.Azure
Chamar APIs downstream personalizadas
Para chamar as suas próprias APIs protegidas com gestão automática de tokens, instale o pacote de API subsequente:
dotnet add package Microsoft.Identity.Web.DownstreamApi
Cenários de agente e copiloto
Para construir integrações com agentes autónomos ou copilotos, instale o pacote de identidades de agentes:
dotnet add package Microsoft.Identity.Web.AgentIdentities
Aplicações OWIN (Framework .NET)
Para aplicações web ASP.NET e APIs web no .NET Framework (OWIN/Katana), instale o pacote OWIN:
dotnet add package Microsoft.Identity.Web.OWIN