IConfidentialClientApplication Interface

Définition

Espace de noms:: Microsoft.Identity.Client

Assembly:: Microsoft.Identity.Client.dll

Package:: Microsoft.Identity.Client v4.91.0

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Représente les applications clientes confidentielles : applications web, API web, applications démon.

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

Dérivé: Microsoft.Identity.Client.ConfidentialClientApplication

Implémente: IApplicationBase IByUserFederatedIdentityCredential IClientApplicationBase

Remarques

Les applications clientes confidentielles sont généralement des applications qui s’exécutent sur des serveurs (applications web, API web ou même applications de service/démon). Ils sont considérés comme difficiles à accéder et peuvent donc conserver un secret d’application (conserver les secrets de temps de configuration, car ces valeurs seraient difficiles à extraire pour les utilisateurs finaux). Une application web est le client confidentiel le plus courant. L’ID client est exposé via le navigateur web, mais le secret est transmis uniquement dans le canal précédent et n’est jamais directement exposé. Pour plus d’informations, consultez Applications clientes.

Propriétés

Nom	Description
AppConfig	Détails sur la configuration de ClientApplication à des fins de débogage. (Hérité de IClientApplicationBase)
AppTokenCache	Cache de jetons d’application qui contient des jetons d’accès pour cette application. Il est maintenu et mis à jour en mode silencieux lors de l’appel AcquireTokenForClient(IEnumerable<String>)
Authority	Obtient l’URL de l’autorité, ou le service de jeton de sécurité (STS) à partir duquel MSAL.NET acquérez des jetons de sécurité. La valeur de retour de cette propriété est soit la valeur fournie par le développeur dans le constructeur de l’application, soit la valeur du Microsoft.Identity.Client.ApplicationBase.DefaultAuthority membre statique (autrement `https://login.microsoftonline.com/common/`dit) (Hérité de IClientApplicationBase)
UserTokenCache	Cache de jetons utilisateur qui contient des jetons d’ID, des jetons d’accès et des jetons d’actualisation pour les comptes. Il est utilisé et mis à jour en mode silencieux si nécessaire lors de l’appel AcquireTokenSilent(IEnumerable<String>, IAccount) il est mis à jour par chaque méthode d’acquisition de jeton, à l’exception de laquelle utilise uniquement le cache d’application AcquireTokenForClient(IEnumerable<String>) (voir AppTokenCache). (Hérité de IClientApplicationBase)

Méthodes

Nom	Description
AcquireTokenByAuthorizationCode(IEnumerable<String>, String)	Acquiert un jeton de l’autorité configurée dans l’application à l’aide du code d’autorisation précédemment reçu du fournisseur d’identité à l’aide du flux de code d’autorisation OAuth 2.0. Consultez flux de code d’autorisation. Ce flux est généralement utilisé dans les applications web (par exemple, ASP.NET et ASP.NET Core applications web) qui connectent les utilisateurs et peuvent demander un code d’autorisation. Cette méthode ne recherche pas dans le cache de jetons, mais stocke le résultat dans celui-ci. Avant d’appeler cette méthode, utilisez d’autres méthodes telles que AcquireTokenSilent(IEnumerable<String>, IAccount) pour vérifier le cache de jetons.
AcquireTokenByUserFederatedIdentityCredential(IEnumerable<String>, Guid, String)	Acquiert un jeton pour le compte d’un utilisateur à l’aide d’une assertion d’informations d’identification d’identité fédérée. Cela utilise le type d’octroi `user_fic` . L’utilisateur est identifié par l’ID d’objet (OID). (Hérité de IByUserFederatedIdentityCredential)
AcquireTokenByUserFederatedIdentityCredential(IEnumerable<String>, String, String)	Acquiert un jeton pour le compte d’un utilisateur à l’aide d’une assertion d’informations d’identification d’identité fédérée. Cela utilise le type d’octroi `user_fic` . L’utilisateur est identifié par UPN. (Hérité de IByUserFederatedIdentityCredential)
AcquireTokenForClient(IEnumerable<String>)	Acquiert un jeton à partir de l’autorité configurée dans l’application pour le client confidentiel lui-même (et non pour un utilisateur) à l’aide du flux d’informations d’identification du client. Consultez le flux des informations d’identification du client. Pendant cette opération, MSAL recherche d’abord dans le cache un jeton non expiré avant d’en acquérir un nouveau à partir de Microsoft Entra ID.
AcquireTokenOnBehalfOf(IEnumerable<String>, UserAssertion)	Acquiert un jeton d’accès pour cette application (généralement une API web) à partir de l’autorité configurée dans l’application, afin d’accéder à une autre API web protégée en aval pour le compte d’un utilisateur à l’aide du flux OAuth 2.0 Activé-Behalf-Of. Pendant cette opération, MSAL recherche d’abord dans le cache un jeton non expiré avant d’en acquérir un nouveau à partir de Microsoft Entra ID. Voir On-Behalf-Of Flow.
AcquireTokenSilent(IEnumerable<String>, IAccount)	Tente d’acquérir un jeton d’accès pour le `account` cache de jetons utilisateur, avec des paramètres avancés contrôlant l’appel réseau. Consultez Acquérir des jetons en mode silencieux. (Hérité de IClientApplicationBase)
AcquireTokenSilent(IEnumerable<String>, String)	Obsolète. Dans les applications clientes confidentielles, utilisez AcquireTokenSilent(IEnumerable<String>, IAccount) à la place.
GetAccountAsync(String)	Obtenez l’identificateur IAccount par son identificateur parmi les comptes disponibles dans le cache de jetons et du même environnement (hôte d’autorité) que Authority. (Hérité de IClientApplicationBase)
GetAccountsAsync()	Obsolète. Utilisez GetAccountAsync(String) dans les applications web et les API web et utilisez un sérialiseur de cache de jetons pour améliorer la sécurité et les performances. Voir https://aka.ms/msal-net-cca-token-cache-serialization.
GetAccountsAsync(String)	Uniquement pour Azure scénarios AD B2C, récupérez la IAccount collection par son identificateur parmi les comptes disponibles dans le cache de jetons en fonction du flux utilisateur. (Hérité de IClientApplicationBase)
GetAuthorizationRequestUrl(IEnumerable<String>)	Calcule l’URL de la demande d’autorisation permettant à l’utilisateur de se connecter et de donner son consentement à l’application qui accède à des étendues spécifiques dans le nom de l’utilisateur. L’URL cible le point de terminaison /authorize de l’autorité configurée dans l’application.
RemoveAsync(IAccount)	Supprime tous les jetons dans le cache du compte spécifié. (Hérité de IClientApplicationBase)

Méthodes d’extension

Nom	Description
GetCertificate(IConfidentialClientApplication)	Retourne le certificat utilisé pour créer ce ConfidentialClientApplicationcertificat, le cas échéant.

S’applique à

Commentaires

Cette page a-t-elle été utile ?