Microsoft.Identity.Client Espacio de nombres

Clase base para generadores de solicitudes de token, que intentan adquirir un token basado en los parámetros proporcionados.

Microsoft.Identity.Clientes el espacio de nombres principal del Biblioteca de autenticación de Microsoft (MSAL) para .NET, disponible a través del Microsoft.Identity.Client paquete. Contiene todos los componentes clave que necesita para adquirir un token de los proveedores de autenticación admitidos.

Installation

Uso de la interfaz .NET Command-Line (CLI):

dotnet add package Microsoft.Identity.Client

Uso de la interfaz de la línea de comandos (CLI) de NuGet:

nuget install Microsoft.Identity.Client

Con la consola de Administrador de paquetes:

Install-Package Microsoft.Identity.Client

Uso de Visual Studio:

1. Abra el Explorador de soluciones.
2. Haga clic con el botón derecho en un proyecto dentro de la solución.
3. Haga clic en Administrar paquetes NuGet...
4. Haga clic en la pestaña Examinar y busque Microsoft.Identity.Client.
5. Haga clic en el Microsoft.Identity.Client paquete y haga clic en Instalar.

Documentation

Para empezar, consulte la guía de Biblioteca de autenticación de Microsoft de .NET.

Samples

Consulte Plataforma de identidad de Microsoft ejemplos de código y el Explorador de ejemplos.

Clase base para generadores de parámetros comunes a las operaciones de adquisición de tokens de aplicación cliente confidencial y aplicación cliente pública

Clase base para generadores de solicitudes de token de aplicación cliente confidenciales

Clase base abstracta para generadores de solicitudes de token de aplicación de identidad administrada.

Clase base para generadores de solicitudes de token de aplicación cliente público

Métodos de extensión para IAccount

Identificador de una cuenta en un inquilino específico. Devuelto por IAccount.HomeAccountId

Builder for AcquireTokenByAuthorizationCode

Generador para AcquireTokenByIntegratedWindowsAuth

Generador de parámetros para el AcquireTokenByRefreshToken(IEnumerable<String>, String) método . Vea https://aka.ms/msal-net-migration-adal2-msal2.

Generador de parámetros para la AcquireTokenByUserFederatedIdentityCredential(IEnumerable<String>, String, String) operación.

Generador de parámetros para la AcquireTokenByUsernamePassword(IEnumerable<String>, String, String) operación. Vea https://aka.ms/msal-net-up.

Generador de parámetros para la AcquireTokenByUsernamePassword(IEnumerable<String>, String, String) operación. Vea https://aka.ms/msal-net-up.

Generador para AcquireTokenForClient (usado en flujos de credenciales de cliente, en aplicaciones de demonio). Vea https://aka.ms/msal-net-client-credentials.

Generador de AcquireTokenForManagedIdentity (se usa para obtener el token para identidades administradas). Vea https://aka.ms/msal-net-managed-identity.

Generador para una solicitud de token interactiva. Vea https://aka.ms/msal-net-acquire-token-interactively.

Generador para AcquireTokenOnBehalfOf (flujo de OBO) Consulte https://aka.ms/msal-net-on-behalf-of

Generador de parámetros para la AcquireTokenSilent(IEnumerable<String>, IAccount) operación. Vea https://aka.ms/msal-net-acquiretokensilent.

Generador de parámetros para la AcquireTokenWithDeviceCode(IEnumerable<String>, Func<DeviceCodeResult,Task>) operación. Vea https://aka.ms/msal-net-device-code-flow.

Interfaz que se usa para la creación de aplicaciones cliente. Para obtener más información, consulte https://aka.ms/msal-net-client-applications.

Clase base para objetos de opciones con valores de cadena que se pueden cargar desde un archivo de configuración (por ejemplo, un archivo JSON, como en un escenario de configuración de asp.net) Vea también https://aka.ms/msal-net-application-configuration clases derivadas PublicClientApplicationOptions y ConfidentialClientApplicationOptions

Información sobre la aserción de cliente que se debe generar. Consulte https://aka.ms/msal-net-client-assertion

Encabezados de autenticación analizados para recuperar valores de encabezado de HttpResponseHeaders.

Parámetros devueltos por el encabezado Authentication-Info. Esto permite escenarios como la prueba de posesión, etc. Consulte https://www.rfc-editor.org/rfc/rfc7615

Contiene los resultados de una operación de adquisición de tokens en PublicClientApplication o ConfidentialClientApplication. Para obtener más información, consulte https://aka.ms/msal-net-authenticationresult

Contiene metadatos del resultado de autenticación. Metrics para métricas adicionales de MSAL.

Clase base para generadores de solicitudes de token, que intentan adquirir un token basado en los parámetros proporcionados.

Microsoft.Identity.Clientes el espacio de nombres principal del Biblioteca de autenticación de Microsoft (MSAL) para .NET, disponible a través del Microsoft.Identity.Client paquete. Contiene todos los componentes clave que necesita para adquirir un token de los proveedores de autenticación admitidos.

Installation

Uso de la interfaz .NET Command-Line (CLI):

dotnet add package Microsoft.Identity.Client

Uso de la interfaz de la línea de comandos (CLI) de NuGet:

nuget install Microsoft.Identity.Client

Con la consola de Administrador de paquetes:

Install-Package Microsoft.Identity.Client

Uso de Visual Studio:

1. Abra el Explorador de soluciones.
2. Haga clic con el botón derecho en un proyecto dentro de la solución.
3. Haga clic en Administrar paquetes NuGet...
4. Haga clic en la pestaña Examinar y busque Microsoft.Identity.Client.
5. Haga clic en el Microsoft.Identity.Client paquete y haga clic en Instalar.

Documentation

Para empezar, consulte la guía de Biblioteca de autenticación de Microsoft de .NET.

Samples

Consulte Plataforma de identidad de Microsoft ejemplos de código y el Explorador de ejemplos.

Clase base para objetos de opciones con valores de cadena que se pueden cargar desde un archivo de configuración (por ejemplo, un archivo JSON, como en un escenario de configuración de asp.net) Vea https://aka.ms/msal-net-application-configuration también clases derivadas. ApplicationOptions

La clase especifica las opciones de agente en OperatingSystems Las propiedades comunes son propiedades específicas de la plataforma de miembros directos (si existen) forman parte de las opciones correspondientes.

Opciones para las cachés de tokens de MSAL.

Clase abstracta que contiene propiedades y métodos de API comunes. ConfidentialClientApplication PublicClientApplication extiende esta clase y confidentialClientApplication. Para obtener más información, consulte https://aka.ms/msal-net-client-applications

Contenedor devuelto desde WithClientAssertion.

Clase que se usará para aplicaciones cliente confidenciales (aplicaciones web, API web y aplicaciones de demonio).

Microsoft.Identity.Clientes el espacio de nombres principal del Biblioteca de autenticación de Microsoft (MSAL) para .NET, disponible a través del Microsoft.Identity.Client paquete. Contiene todos los componentes clave que necesita para adquirir un token de los proveedores de autenticación admitidos.

Installation

Uso de la interfaz .NET Command-Line (CLI):

dotnet add package Microsoft.Identity.Client

Uso de la interfaz de la línea de comandos (CLI) de NuGet:

nuget install Microsoft.Identity.Client

Con la consola de Administrador de paquetes:

Install-Package Microsoft.Identity.Client

Uso de Visual Studio:

1. Abra el Explorador de soluciones.
2. Haga clic con el botón derecho en un proyecto dentro de la solución.
3. Haga clic en Administrar paquetes NuGet...
4. Haga clic en la pestaña Examinar y busque Microsoft.Identity.Client.
5. Haga clic en el Microsoft.Identity.Client paquete y haga clic en Instalar.

Documentation

Para empezar, consulte la guía de Biblioteca de autenticación de Microsoft de .NET.

Samples

Consulte Plataforma de identidad de Microsoft ejemplos de código y el Explorador de ejemplos.

Opciones de configuración para una aplicación cliente confidencial (aplicación web, API web o aplicación de demonio). Vea https://aka.ms/msal-net/application-configuration.

Este objeto se devuelve como parte del flujo de código del dispositivo y tiene información destinada a mostrarse al usuario sobre dónde navegar al inicio de sesión y qué código de dispositivo debe escribirse en ese dispositivo. Consulte https://aka.ms/msal-device-code-flow.

Opciones para usar la vista web insertada.

NOTA: Algunos de los métodos de AbstractAcquireTokenParameterBuilder (por ejemplo, cuenta) no tienen sentido aquí. ¿Deseamos crear una base adicional que contenga TODOS los métodos comunes y, a continuación, tener otra cuenta incluida, etc., que solo se usen para AcquireToken?

Esta excepción se produce cuando Intune requiere una directiva de protección de aplicaciones. La aplicación puede usar la información de esta excepción para obtener el identificador de inscripción necesario del SDK de Administración de aplicaciones móviles (MAM). Vea https://aka.ms/msal-net-trueMAM.

Clase que se usará para las aplicaciones de identidad administrada (en recursos de Azure como App Services, Virtual Machines, Azure Arc, Service Fabric y Cloud Shell).

Generador de aplicaciones de identidad administrada.

Métodos de extensión para habilitar la prueba de posesión de mTLS en flujos de identidad administrada.

Métricas de msal.

Esta excepción indica que las notificaciones se han devuelto desde el punto de conexión que se deben resolver. Esto se puede lograr mediante su uso en la siguiente solicitud de autenticación. Consulte Desafíos de acceso condicional y notificaciones. Consulte Control de la autenticación multifactor (MFA), el acceso condicional y el consentimiento incremental.

Esta clase de excepción representa errores que son locales para la biblioteca o el dispositivo. Contrario a MsalServiceException lo que representa los errores que se producen desde el servicio de Azure AD o la red. Si desea obtener información más detallada, consulte https://aka.ms/msal-net-exceptions.

Código de error devuelto como una propiedad en MsalException

Tipo de excepción base que se produce cuando se produce un error durante la adquisición de tokens. Si desea obtener información más detallada, consulte https://aka.ms/msal-net-exceptions.

Esta clase de excepción es para las excepciones generadas a partir de orígenes de identidad administrada. Esta clase está en desuso y se quitará en una versión futura. En su lugar, capture MsalServiceException. Si desea obtener información más detallada, consulte https://aka.ms/msal-net-managed-identity.

Tipo de excepción que se produce cuando el servicio devuelve una respuesta de error u otros errores de red. Si desea obtener información más detallada, consulte https://aka.ms/msal-net-exceptions.

Tipo de excepción que se produce cuando MSAL detecta que una aplicación intenta adquirir un token con demasiada frecuencia, como resultado de:

• Una solicitud anterior produjo una respuesta HTTP que contiene un encabezado Retry-After que no se siguió.
• Una solicitud anterior produjo un HTTP 429 o 5xx, que indica un problema con el servidor.

Las propiedades de esta excepción son idénticas a la excepción original.

Para obtener más información, consulte https://aka.ms/msal-net-throttling

Tipo de excepción que se produce cuando MSAL detecta que una aplicación intenta adquirir un token aunque se haya producido recientemente.MsalUiRequiredException Para mitigar esto, cuando se encuentra un MsalUiRequiredException , la aplicación debe cambiar a adquirir un token de forma interactiva. Para comprender mejor por qué se produjo, MsalUiRequiredException inspeccione la Classification propiedad .

Las propiedades de esta excepción son idénticas a la excepción original.

Para obtener más información, consulte https://aka.ms/msal-net-throttling

Esta clase de excepción es informar a los desarrolladores de que la interacción de la interfaz de usuario es necesaria para que la autenticación se realice correctamente. Se produce al llamar a AcquireTokenSilent(IEnumerable<String>, IAccount) o a una de sus invalidaciones, y cuando el token no existe en la memoria caché, o el usuario necesita proporcionar más contenido o realizar la autenticación multifactor basada en directivas de AD de Azure, etc.. Si desea obtener información más detallada, consulte https://aka.ms/msal-net-exceptions.

Métodos de extensión

Clase abstracta que contiene propiedades y métodos de API comunes. Para obtener más información, consulte https://aka.ms/msal-net-client-applications

Microsoft.Identity.Clientes el espacio de nombres principal del Biblioteca de autenticación de Microsoft (MSAL) para .NET, disponible a través del Microsoft.Identity.Client paquete. Contiene todos los componentes clave que necesita para adquirir un token de los proveedores de autenticación admitidos.

Installation

Uso de la interfaz .NET Command-Line (CLI):

dotnet add package Microsoft.Identity.Client

Uso de la interfaz de la línea de comandos (CLI) de NuGet:

nuget install Microsoft.Identity.Client

Con la consola de Administrador de paquetes:

Install-Package Microsoft.Identity.Client

Uso de Visual Studio:

1. Abra el Explorador de soluciones.
2. Haga clic con el botón derecho en un proyecto dentro de la solución.
3. Haga clic en Administrar paquetes NuGet...
4. Haga clic en la pestaña Examinar y busque Microsoft.Identity.Client.
5. Haga clic en el Microsoft.Identity.Client paquete y haga clic en Instalar.

Documentation

Para empezar, consulte la guía de Biblioteca de autenticación de Microsoft de .NET.

Samples

Consulte Plataforma de identidad de Microsoft ejemplos de código y el Explorador de ejemplos.

Métodos de extensibilidad para IPublicClientApplication

Opciones de configuración para una aplicación cliente pública (aplicación de escritorio o móvil). Vea https://aka.ms/msal-net/application-configuration.

Contiene el resultado de la región cuando se usa la detección de regiones msal, publicada como parte de AuthenticationResultMetadata. AuthenticationResultMetadata para obtener información adicional de metadatos del resultado de autenticación.

Opciones para usar el explorador del sistema operativo predeterminado como un proceso independiente para controlar la autenticación interactiva. MSAL escuchará al explorador del sistema operativo para finalizar la autenticación, pero no puede cerrar el explorador. Sin embargo, puede responder con un mensaje 200 OK o una redirección 302, que se puede configurar aquí. Para obtener más información, consulte https://aka.ms/msal-net-os-browser

Representa una cuenta en un inquilino específico. La misma cuenta puede existir en su inquilino principal y también como invitado en varios otros inquilinos. Los tokens de acceso y los tokens de identificador son específicos del inquilino y este objeto proporciona información de alto nivel sobre todos los tokens de identificador asociados a la cuenta.

Caché de tokens que almacena tokens de acceso y actualización para cuentas Esta clase se usa en los constructores de PublicClientApplication y ConfidentialClientApplication. En el caso de ConfidentialClientApplication, se usan dos instancias, una para la caché de tokens de usuario y otra para la caché de tokens de aplicación (en el caso de las aplicaciones que usan los flujos de credenciales de cliente).

Métodos de extensión para ITokenCache

Contiene parámetros usados por la llamada MSAL que accede a la memoria caché. Consulte también ITokenCacheSerializer qué contiene métodos para personalizar la serialización de caché. Para más información sobre la caché de tokens, consulte https://aka.ms/msal-net-web-token-cache

Implementación sencilla ITelemetryConfig que escribe datos mediante System.Diagnostics.Trace.

Microsoft.Identity.Clientes el espacio de nombres principal del Biblioteca de autenticación de Microsoft (MSAL) para .NET, disponible a través del Microsoft.Identity.Client paquete. Contiene todos los componentes clave que necesita para adquirir un token de los proveedores de autenticación admitidos.

Installation

Uso de la interfaz .NET Command-Line (CLI):

dotnet add package Microsoft.Identity.Client

Uso de la interfaz de la línea de comandos (CLI) de NuGet:

nuget install Microsoft.Identity.Client

Con la consola de Administrador de paquetes:

Install-Package Microsoft.Identity.Client

Uso de Visual Studio:

1. Abra el Explorador de soluciones.
2. Haga clic con el botón derecho en un proyecto dentro de la solución.
3. Haga clic en Administrar paquetes NuGet...
4. Haga clic en la pestaña Examinar y busque Microsoft.Identity.Client.
5. Haga clic en el Microsoft.Identity.Client paquete y haga clic en Instalar.

Documentation

Para empezar, consulte la guía de Biblioteca de autenticación de Microsoft de .NET.

Samples

Consulte Plataforma de identidad de Microsoft ejemplos de código y el Explorador de ejemplos.

Opciones avanzadas para usar el agente de Windows 10. Para obtener más información, consulte https://aka.ms/msal-net-wam

Parámetros devueltos por el encabezado WWW-Authenticate. Esto permite escenarios dinámicos, como desafío de notificaciones, evaluación continua de acceso (CAE) y acceso condicional (CA). Consulte https://aka.ms/msal-net/wwwAuthenticate.

Estructura que contiene miembros estáticos que puede usar para especificar cómo las invalidaciones interactivas de AcquireTokenAsync en IPublicClientApplication deben preguntar al usuario.

La interfaz IAccount representa información sobre una sola cuenta. El mismo usuario puede estar presente en distintos inquilinos, es decir, un usuario puede tener varias cuentas. IAccount Se devuelve un objeto en la AuthenticationResultpropiedad .Account y se puede usar como parámetros de los métodos PublicClientApplication y ConfidentialClientApplication que adquieren tokens como, por ejemplo,AcquireTokenSilent(IEnumerable<String>, IAccount)

Propiedades de configuración usadas para compilar una aplicación cliente pública o confidencial.

Interfaz que se usa para la creación de aplicaciones cliente. Para obtener más información, consulte https://aka.ms/msal-net-client-applications.

Microsoft.Identity.Clientes el espacio de nombres principal del Biblioteca de autenticación de Microsoft (MSAL) para .NET, disponible a través del Microsoft.Identity.Client paquete. Contiene todos los componentes clave que necesita para adquirir un token de los proveedores de autenticación admitidos.

Installation

Uso de la interfaz .NET Command-Line (CLI):

dotnet add package Microsoft.Identity.Client

Uso de la interfaz de la línea de comandos (CLI) de NuGet:

nuget install Microsoft.Identity.Client

Con la consola de Administrador de paquetes:

Install-Package Microsoft.Identity.Client

Uso de Visual Studio:

1. Abra el Explorador de soluciones.
2. Haga clic con el botón derecho en un proyecto dentro de la solución.
3. Haga clic en Administrar paquetes NuGet...
4. Haga clic en la pestaña Examinar y busque Microsoft.Identity.Client.
5. Haga clic en el Microsoft.Identity.Client paquete y haga clic en Instalar.

Documentation

Para empezar, consulte la guía de Biblioteca de autenticación de Microsoft de .NET.

Samples

Consulte Plataforma de identidad de Microsoft ejemplos de código y el Explorador de ejemplos.

Proporciona una interfaz para adquirir tokens mediante el flujo de credenciales de identidad federada de usuario (UserFIC).

Proporciona una interfaz explícita para usar la concesión de contraseña del propietario del recurso en el cliente confidencial.

Interfaz que define propiedades y métodos de API comunes. Tanto como PublicClientApplicationConfidentialClientApplication extiendan esta clase. Para obtener más información, consulte https://aka.ms/msal-net-client-applications

Representa aplicaciones cliente confidenciales: aplicaciones web, API web, aplicaciones de demonio.

Métodos para procesos de ejecución prolongada o en segundo plano en las API web.

Componente que se va a usar con aplicaciones de identidad administrada para Azure recursos.

Factoría responsable de crear HttpClient. Consulte https://learn.microsoft.com/dotnet/api/system.net.http.httpclient?view=net-7.0#instancing para obtener más detalles.

Generador responsable de crear instancias httpClient configuradas para TLS mutua (mTLS). Esta fábrica está diseñada para usarse para proteger la comunicación con Azure AD mediante mTLS. Para obtener más información sobre la creación de instancias de HttpClient, consulte https://learn.microsoft.com/en-us/dotnet/api/system.net.http.httpclient?view=net-8.0#instancing.

Factoría responsable de crear HttpClient con una devolución de llamada de validación de certificados de servidor personalizada. Esto es útil para el escenario de Service Fabric en el que se requiere la validación del certificado de servidor mediante el certificado de servidor. Consulte https://learn.microsoft.com/dotnet/api/system.net.http.httpclient?view=net-7.0#instancing para obtener más información.

Representa aplicaciones cliente públicas: aplicaciones móviles y de escritorio.

Microsoft.Identity.Clientes el espacio de nombres principal del Biblioteca de autenticación de Microsoft (MSAL) para .NET, disponible a través del Microsoft.Identity.Client paquete. Contiene todos los componentes clave que necesita para adquirir un token de los proveedores de autenticación admitidos.

Installation

Uso de la interfaz .NET Command-Line (CLI):

dotnet add package Microsoft.Identity.Client

Uso de la interfaz de la línea de comandos (CLI) de NuGet:

nuget install Microsoft.Identity.Client

Con la consola de Administrador de paquetes:

Install-Package Microsoft.Identity.Client

Uso de Visual Studio:

1. Abra el Explorador de soluciones.
2. Haga clic con el botón derecho en un proyecto dentro de la solución.
3. Haga clic en Administrar paquetes NuGet...
4. Haga clic en la pestaña Examinar y busque Microsoft.Identity.Client.
5. Haga clic en el Microsoft.Identity.Client paquete y haga clic en Instalar.

Documentation

Para empezar, consulte la guía de Biblioteca de autenticación de Microsoft de .NET.

Samples

Consulte Plataforma de identidad de Microsoft ejemplos de código y el Explorador de ejemplos.

Datos que representan una sola instantánea en la serie de eventos que se recopilan

Esta es la interfaz que implementa el acceso público a las operaciones de caché. Con CacheV2, esto solo debe ser necesario si el autor de la llamada conserva la memoria caché en su propio almacén, ya que esto proporcionará la serialización o deserialización y antes y después de las notificaciones usadas en ese escenario. Vea https://aka.ms/aka.ms/msal-net-token-cache-serialization.

Esta interfaz estará disponible en la devolución de llamada de TokenCacheNotificationArgs para habilitar la serialización o deserialización de la memoria caché.

Especifica qué cuentas de Microsoft se pueden usar para el inicio de sesión con una aplicación determinada. Vea https://aka.ms/msal-net-application-configuration.

Microsoft.Identity.Clientes el espacio de nombres principal del Biblioteca de autenticación de Microsoft (MSAL) para .NET, disponible a través del Microsoft.Identity.Client paquete. Contiene todos los componentes clave que necesita para adquirir un token de los proveedores de autenticación admitidos.

Installation

Uso de la interfaz .NET Command-Line (CLI):

dotnet add package Microsoft.Identity.Client

Uso de la interfaz de la línea de comandos (CLI) de NuGet:

nuget install Microsoft.Identity.Client

Con la consola de Administrador de paquetes:

Install-Package Microsoft.Identity.Client

Uso de Visual Studio:

1. Abra el Explorador de soluciones.
2. Haga clic con el botón derecho en un proyecto dentro de la solución.
3. Haga clic en Administrar paquetes NuGet...
4. Haga clic en la pestaña Examinar y busque Microsoft.Identity.Client.
5. Haga clic en el Microsoft.Identity.Client paquete y haga clic en Instalar.

Documentation

Para empezar, consulte la guía de Biblioteca de autenticación de Microsoft de .NET.

Samples

Consulte Plataforma de identidad de Microsoft ejemplos de código y el Explorador de ejemplos.

Sistemas operativos compatibles

Especifica el motivo para capturar el token de acceso del proveedor de identidades al usar AcquireTokenSilent, AcquireTokenForClient o AcquireTokenOnBehalfOf.

Representa el nivel de registro en MSAL. Para obtener más información, consulte Registro de MSAL.

Describe los tipos de audiencias para la telemetría. AudienceType

Especifica el origen de los tokens de acceso e identificador en el resultado de la autenticación.

Detalles sobre la causa de un MsalUiRequiredException, dando una sugerencia sobre lo que el usuario puede esperar cuando pasan por la autenticación interactiva. Consulte Understanding MsalUiRequiredException (Descripción de MsalUiRequiredException ) para obtener más información.

Delegado de devolución de llamada que permite a los desarrolladores de aplicaciones consumir registros y controlarlos de forma personalizada. Esta devolución de llamada se establece mediante WithLogging(LogCallback, Nullable<LogLevel>, Nullable<Boolean>, Nullable<Boolean>). Si PiiLoggingEnabled se establece trueen , al registrar la devolución de llamada, este método recibirá los mensajes dos veces: una vez con el containsPii parámetro equals false y el mensaje sin PII, y una segunda vez con el containsPii parámetro igual a true y el mensaje podría contener PII. En algunos casos (cuando el mensaje no contiene PII), el mensaje será el mismo. Para obtener más información, consulte https://aka.ms/msal-net-logging

Notificación de determinadas interacciones de caché de tokens durante la adquisición de tokens. Este delegado se usa en particular para proporcionar una serialización de caché de tokens personalizada. Vea https://aka.ms/aka.ms/msal-net-token-cache-serialization.