IConfidentialClientApplication Interfaz

Definición

Espacio de nombres:: Microsoft.Identity.Client

Ensamblado:: Microsoft.Identity.Client.dll

Paquete:: Microsoft.Identity.Client v4.84.2

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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

public interface IConfidentialClientApplication : Microsoft.Identity.Client.IByUserFederatedIdentityCredential, Microsoft.Identity.Client.IClientApplicationBase

type IConfidentialClientApplication = interface
    interface IClientApplicationBase
    interface IApplicationBase
    interface IByUserFederatedIdentityCredential

Public Interface IConfidentialClientApplication
Implements IByUserFederatedIdentityCredential, IClientApplicationBase

Derivado: Microsoft.Identity.Client.ConfidentialClientApplication

Implementaciones: IApplicationBase IByUserFederatedIdentityCredential IClientApplicationBase

Comentarios

Las aplicaciones cliente confidenciales suelen ser aplicaciones que se ejecutan en servidores (aplicaciones web, API web o incluso aplicaciones de servicio o demonio). Se consideran difíciles de acceder y, por tanto, son capaces de mantener un secreto de aplicación (contener secretos de tiempo de configuración, ya que estos valores serían difíciles de extraer para los usuarios finales). Una aplicación web es el cliente confidencial más común. El identificador de cliente se expone a través del explorador web, pero el secreto solo se pasa en el canal back y nunca se expone directamente. Para obtener más información, consulte Aplicaciones cliente.

Propiedades

Nombre	Description
AppConfig	Detalles sobre la configuración de ClientApplication con fines de depuración. (Heredado de IClientApplicationBase)
AppTokenCache	Caché de tokens de aplicación que contiene tokens de acceso para esta aplicación. Se mantiene y actualiza silenciosamente al llamar a AcquireTokenForClient(IEnumerable<String>)
Authority	Obtiene la dirección URL de la entidad o el servicio de token de seguridad (STS) del que MSAL.NET adquirirán tokens de seguridad. El valor devuelto de esta propiedad es el valor proporcionado por el desarrollador en el constructor de la aplicación o, de lo contrario, el valor del Microsoft.Identity.Client.ApplicationBase.DefaultAuthority miembro estático (es `https://login.microsoftonline.com/common/`decir, ) (Heredado de IClientApplicationBase)
UserTokenCache	Caché de tokens de usuario que contiene tokens de identificador, tokens de acceso y tokens de actualización para cuentas. Se usa y actualiza silenciosamente si es necesario cuando se llama AcquireTokenSilent(IEnumerable<String>, IAccount) a se actualiza mediante cada método de adquisición de token, con la excepción de que solo usa la memoria caché de AcquireTokenForClient(IEnumerable<String>) aplicaciones (consulte AppTokenCache). (Heredado de IClientApplicationBase)

Métodos

Nombre	Description
AcquireTokenByAuthorizationCode(IEnumerable<String>, String)	Adquiere un token de la entidad configurada en la aplicación mediante el código de autorización recibido previamente del proveedor de identidades mediante el flujo de código de autorización de OAuth 2.0. Consulte Flujo de código de autorización. Este flujo se usa normalmente en aplicaciones web (por ejemplo, ASP.NET y ASP.NET Core aplicaciones web) que inician sesión los usuarios y pueden solicitar un código de autorización. Este método no busca en la caché de tokens, pero almacena el resultado en ella. Antes de llamar a este método, use otros métodos como AcquireTokenSilent(IEnumerable<String>, IAccount) para comprobar la caché de tokens.
AcquireTokenByUserFederatedIdentityCredential(IEnumerable<String>, Guid, String)	Adquiere un token en nombre de un usuario mediante una aserción de credenciales de identidad federada. Esto usa el tipo de `user_fic` concesión. El usuario se identifica mediante el identificador de objeto (OID). (Heredado de IByUserFederatedIdentityCredential)
AcquireTokenByUserFederatedIdentityCredential(IEnumerable<String>, String, String)	Adquiere un token en nombre de un usuario mediante una aserción de credenciales de identidad federada. Esto usa el tipo de `user_fic` concesión. El usuario se identifica mediante UPN. (Heredado de IByUserFederatedIdentityCredential)
AcquireTokenForClient(IEnumerable<String>)	Adquiere un token de la entidad configurada en la aplicación para el propio cliente confidencial (no para un usuario) mediante el flujo de credenciales de cliente. Consulte Flujo de credenciales de cliente. Durante esta operación, MSAL buscará primero en la memoria caché un token no expirado antes de adquirir uno nuevo de Microsoft Entra ID.
AcquireTokenOnBehalfOf(IEnumerable<String>, UserAssertion)	Adquiere un token de acceso para esta aplicación (normalmente una API web) de la autoridad configurada en la aplicación, con el fin de acceder a otra API web protegida de bajada en nombre de un usuario mediante el flujo on-Behalf-Of de OAuth 2.0. Durante esta operación, MSAL buscará primero en la memoria caché un token no expirado antes de adquirir uno nuevo de Microsoft Entra ID. Consulte Flujo deBehalf-Of.
AcquireTokenSilent(IEnumerable<String>, IAccount)	Intenta adquirir un token de acceso para desde `account` la caché de tokens de usuario, con parámetros avanzados que controlan la llamada de red. Consulte Adquisición de tokens de forma silenciosa. (Heredado de IClientApplicationBase)
AcquireTokenSilent(IEnumerable<String>, String)	Obsoletos. En las aplicaciones cliente confidenciales, use AcquireTokenSilent(IEnumerable<String>, IAccount) en su lugar.
GetAccountAsync(String)	Obtenga por IAccount su identificador entre las cuentas disponibles en la caché de tokens y del mismo entorno (host de autoridad) que Authority. (Heredado de IClientApplicationBase)
GetAccountsAsync()	Obsoletos. Use GetAccountAsync(String) en aplicaciones web y API web y use un serializador de caché de tokens para mejorar la seguridad y el rendimiento. Consulte https://aka.ms/msal-net-cca-token-cache-serialization.
GetAccountsAsync(String)	Solo para Azure escenarios de AD B2C, obtenga la IAccount recopilación por su identificador entre las cuentas disponibles en la caché de tokens en función del flujo de usuario. (Heredado de IClientApplicationBase)
GetAuthorizationRequestUrl(IEnumerable<String>)	Calcula la dirección URL de la solicitud de autorización que permite al usuario iniciar sesión y dar su consentimiento a la aplicación que accede a ámbitos específicos en el nombre del usuario. La dirección URL tiene como destino el punto de conexión /authorize de la autoridad configurada en la aplicación.
RemoveAsync(IAccount)	Quita todos los tokens de la memoria caché de la cuenta especificada. (Heredado de IClientApplicationBase)

Métodos de extensión

Nombre	Description
GetCertificate(IConfidentialClientApplication)	Devuelve el certificado usado para crear este ConfidentialClientApplication, si existe.

Se aplica a

Comentarios

¿Le ha resultado útil esta página?