TokenCredential Interface

Paquet:

com.azure.core.credential

Artefact Maven:

com.azure:azure-core:1.46.0

public interface TokenCredential

L’interface d’informations d’identification de jeton sert de composant fondamental pour la gestion et la fourniture des jetons d’accès requis pour l’authentification Azure Active Directory (Azure AD) lors de l’envoi de demandes aux services Azure.

Interface TokenCredential , offres getToken(TokenRequestContext request) et getTokenSync(TokenRequestContext request) méthodes. Ces méthodes sont responsables de la récupération d’un jeton d’accès qui peut être utilisé pour authentifier les demandes adressées aux services Azure. Le paramètre scopes spécifié dans le cadre de TokenRequestContext représente les ressources ou autorisations requises pour le jeton.

L’interface Token Credential est implémentée par différentes classes d’informations d’identification dans la bibliothèque Azure Identity . Ces classes d’informations d’identification gèrent le processus d’authentification et fournissent les jetons d’accès nécessaires en fonction des étendues spécifiées et de toute configuration supplémentaire.

En utilisant l’interface Token Credential, vous pouvez extraire la logique d’authentification de votre code d’application. Cela offre une certaine flexibilité dans le choix des mécanismes d’authentification et simplifie la gestion des jetons d’accès, notamment la mise en cache et l’actualisation des jetons. Il fournit une approche cohérente pour authentifier les demandes sur différents services et bibliothèques Azure.

Voici quelques exemples de classes d’informations d’identification qui implémentent l’interface Token Credential :

• DefaultAzureCredential : représente des informations d’identification qui essaient une série de méthodes d’authentification pour authentifier automatiquement les demandes. Il simplifie le processus en sélectionnant automatiquement un mécanisme d’authentification approprié en fonction de l’environnement, tel que les variables d’environnement, les identités managées et les informations d’identification de l’outil de développement.
• ClientSecretCredential : représente des informations d’identification qui utilisent un ID client, une clé secrète client et un ID de locataire pour l’authentification. Il convient aux scénarios où vous avez une application cliente qui doit s’authentifier auprès des services Azure à l’aide d’une clé secrète client.
• ClientCertificateCredential : représente des informations d’identification qui utilisent un ID client, un certificat client et un ID de locataire pour l’authentification. Ces informations d’identification sont utiles lorsque votre application cliente dispose d’un certificat client disponible pour l’authentification.
• InteractiveBrowserCredential : représente des informations d’identification qui effectuent un flux d’authentification interactif avec l’utilisateur dans un navigateur. Il est utile pour les scénarios où l’utilisateur doit fournir son consentement ou où l’authentification multifacteur est requise.

Vous trouverez d’autres classes d’informations d’identification qui implémentent l’interface TokenCredential dans notre bibliothèque Azure Identity .

Ces classes d’informations d’identification peuvent être utilisées en combinaison avec diverses bibliothèques clientes Azure pour authentifier les demandes et accéder aux services Azure sans avoir à gérer manuellement les jetons d’accès. L’interface d’informations d’identification de jeton fournit un moyen cohérent de gérer l’authentification Azure Active Directory (AAD) entre différents services et kits de développement logiciel (SDK) Azure de manière sécurisée et efficace.

Résumé de la méthode

Modificateur et type	Méthode et description
abstract Mono<AccessToken>	getToken(TokenRequestContext request) Obtenez de façon asynchrone un jeton pour une ressource/audience donnée.
default AccessToken	getTokenSync(TokenRequestContext request) Obtenez de façon synchrone un jeton pour une ressource/audience donnée.

Détails de la méthode

getToken

public abstract Mono getToken(TokenRequestContext request)

Obtenez de façon asynchrone un jeton pour une ressource/audience donnée. Cette méthode est appelée automatiquement par les bibliothèques clientes du Kit de développement logiciel (SDK) Azure. Vous pouvez appeler cette méthode directement, mais vous devez également gérer la mise en cache des jetons et l’actualisation des jetons.

Parameters:

request - détails de la demande de jeton

Returns:

un serveur de publication qui émet un jeton d’accès unique

getTokenSync

public default AccessToken getTokenSync(TokenRequestContext request)

Obtenez de façon synchrone un jeton pour une ressource/audience donnée. Cette méthode est appelée automatiquement par les bibliothèques clientes du Kit de développement logiciel (SDK) Azure. Vous pouvez appeler cette méthode directement, mais vous devez également gérer la mise en cache des jetons et l’actualisation des jetons.

Parameters:

request - détails de la demande de jeton

Returns:

Jeton d’accès