Microsoft.Identity.Web paquetes NuGet

Microsoft. Identity.Web es un conjunto de paquetes NuGet que simplifican la adición de autenticación y autorización a las aplicaciones que se integran con el Plataforma de identidad de Microsoft. Cada paquete tiene como destino un escenario específico, por lo que solo se instala lo que la aplicación necesita. En este artículo se describen los paquetes disponibles y se le ayuda a elegir el adecuado.

Paquetes base

Estos paquetes proporcionan la funcionalidad fundamental para la autenticación y la administración de tokens.

Package Descripción
Microsoft. Identity.Web El paquete principal para ASP.NET Core aplicaciones web y API web. Habilita el inicio de sesión, la validación de tokens y la llamada a las API de bajada.
Microsoft. Identity.Web.UI Proporciona componentes de interfaz de usuario para ASP.NET Core aplicaciones web, incluidos controladores y vistas de inicio de sesión y cierre de sesión.
Microsoft. Identity.Web.TokenAcquisition API de nivel superior para la adquisición de tokens en aplicaciones cliente confidenciales (ASP.NET Core y SDK de .NET). Controla automáticamente la administración de tokens.
Microsoft. Identity.Web.TokenCache Serializadores de caché de tokens para aplicaciones cliente confidenciales de MSAL.NET. Admite el almacenamiento en caché basado en memoria, distribuido y basado en sesión.

Paquetes de administración de credenciales

Estos paquetes controlan diferentes tipos de credenciales de autenticación.

Package Descripción
Microsoft. Identity.Web.Certificate Funcionalidades de administración de certificados para MSAL.NET, incluida la carga de certificados desde almacenes locales y Azure Key Vault.
Microsoft. Identity.Web.Certificateless Escenarios de autenticación sin certificado, como identidades administradas y federación de identidades de carga de trabajo.

API descendente y paquetes de integración

Estos paquetes le ayudan a llamar a las API protegidas e integrarlas con los servicios de Azure.

Package Descripción
Microsoft. Identity.Web.DownstreamApi Interfaz de nivel superior para llamar a las API protegidas de bajada desde aplicaciones cliente confidenciales con administración automática de tokens.
Microsoft. Identity.Web. Azure Permite que aplicaciones web y API web de ASP.NET Core usen SDK de Azure con la plataforma de identidad de Microsoft a través de la provisión de implementaciones de TokenCredential.
Microsoft. Identity.Web.OWIN Habilita las aplicaciones web ASP.NET (OWIN/Katana) y las API web en .NET Framework para usar la Microsoft Identity Platform.

paquetes de Microsoft Graph

Estos paquetes proporcionan integración con Microsoft Graph para llamar a servicios Microsoft 365.

Package Descripción
Microsoft. Identity.Web.GraphServiceClient Integración de Microsoft Graph mediante Graph SDK v5 y posteriores. Se recomienda para los nuevos proyectos.
Microsoft. Identity.Web.GraphServiceClientBeta Integración beta de Microsoft Graph con Graph SDK v5 y versiones posteriores. Use este paquete para acceder a las características en versión preliminar.
Microsoft. Identity.Web.MicrosoftGraph Microsoft Graph integración mediante Graph SDK v4. Usa GraphServiceClient paquetes para proyectos nuevos.
Microsoft. Identity.Web.MicrosoftGraphBeta Integración Beta de Microsoft Graph mediante el Graph SDK v4.

Paquetes de escenario avanzado

Estos paquetes admiten escenarios de autenticación especializados.

Package Descripción
Microsoft. Identity.Web.Diagnostics Soporte de diagnóstico y registro para solucionar problemas de autenticación.
Microsoft. Identity.Web.OidcFIC Implementación del proveedor de credenciales de identidad de federación en la nube (FIC). Habilita escenarios de autenticación entre nubes.
Microsoft. Identity.Web.AgentIdentities Métodos auxiliares para escenarios de identidad del agente, incluida la creación de agentes autónomos e integraciones de copiloto.

Elige el paquete adecuado

Use los ejemplos siguientes para instalar los paquetes que coinciden con el escenario de la aplicación.

Aplicaciones web que inician sesión de usuarios

Para ASP.NET Core aplicaciones web que inician sesión con usuarios con Microsoft Entra ID, instale el paquete principal y el paquete de interfaz de usuario:

dotnet add package Microsoft.Identity.Web
dotnet add package Microsoft.Identity.Web.UI

API web protegidas

Para las APIs web de ASP.NET Core que validan tokens de solicitudes de usuarios autenticados, instale el paquete principal.

dotnet add package Microsoft.Identity.Web

Aplicaciones de demonio y servicios en segundo plano

Para aplicaciones daemon o servicios en segundo plano que adquieren tokens sin la interacción del usuario, instale el paquete de adquisición de tokens.

dotnet add package Microsoft.Identity.Web.TokenAcquisition

Llamar a Microsoft Graph

Para los nuevos proyectos, use el paquete de Graph SDK v5:

dotnet add package Microsoft.Identity.Web.GraphServiceClient

Si el proyecto usa Graph SDK v4, instale el paquete de integración anterior en su lugar:

dotnet add package Microsoft.Identity.Web.MicrosoftGraph

Uso de SDK de Azure

Para autenticar a los clientes del SDK de Azure con la plataforma de identidad de Microsoft, instale el paquete de integración de Azure.

dotnet add package Microsoft.Identity.Web.Azure

Llamadas a APIs descendentes personalizadas

Para llamar a su propia API protegida con administración automática de tokens, instale el paquete de API descendente.

dotnet add package Microsoft.Identity.Web.DownstreamApi

Escenarios de agente y copilot

Para desarrollar agentes autónomos o integraciones de Copilot, instale el paquete de identidades de agente.

dotnet add package Microsoft.Identity.Web.AgentIdentities

Aplicaciones OWIN (.NET Framework)

Para ASP.NET aplicaciones web y API web en .NET Framework (OWIN/Katana), instale el paquete OWIN:

dotnet add package Microsoft.Identity.Web.OWIN

Contenido relacionado

  • Last updated on