Partager via


Bibliothèque de client Azure Core Authentication pour JavaScript - version 1.7.2

Le package @azure/core-auth fournit les interfaces et méthodes d’assistance principales qui servent à l’authentification auprès des services Azure avec Azure Active Directory et d’autres schémas d’authentification courants dans le SDK Azure. En tant que bibliothèque « principale », elle n’a pas besoin d’être ajoutée comme dépendance à du code utilisateur, mais uniquement à d’autres bibliothèques du SDK Azure.

Prise en main

Installation

Installez cette bibliothèque avec npm comme suit :

npm install @azure/core-auth

Concepts clés

L’interface TokenCredential représente des informations d’identification capables de fournir un jeton d’authentification. Le package @azure/identity contient différentes informations d’identification qui implémentent l’interface TokenCredential.

Les AzureKeyCredential contiennent des informations d’identification statiques basées sur des clés qui prennent en charge la rotation des clés via la méthode update. Utilisez-les lorsqu’une seule valeur de secret est nécessaire pour l’authentification, par exemple avec une clé d’accès partagé.

Les AzureNamedKeyCredential contiennent des informations d’identification statiques basées sur une combinaison nom/clé qui prennent en charge la rotation des noms et des clés via la méthode update. Utilisez-les quand un secret et une étiquette sont nécessaires tous les deux, par exemple, dans le cas de l’utilisation d’une clé d’accès partagé et d’un nom de clé d’accès partagé.

Les AzureSASCredential contiennent des informations d’identification statiques basées sur une signature qui prennent en charge la mise à jour de la valeur de signature via la méthode update. Utilisez-les si vous avez une signature d’accès partagé.

Exemples

AzureKeyCredential

const { AzureKeyCredential } = require("@azure/core-auth");

const credential = new AzureKeyCredential("secret value");
// prints: "secret value"
console.log(credential.key);
credential.update("other secret value");
// prints: "other secret value"
console.log(credential.key);

AzureNamedKeyCredential

const { AzureNamedKeyCredential } = require("@azure/core-auth");

const credential = new AzureNamedKeyCredential("ManagedPolicy", "secret value");
// prints: "ManagedPolicy, secret value"
console.log(`${credential.name}, ${credential.key}`);
credential.update("OtherManagedPolicy", "other secret value");
// prints: "OtherManagedPolicy, other secret value"
console.log(`${credential.name}, ${credential.key}`);

AzureSASCredential

const { AzureSASCredential } = require("@azure/core-auth");

const credential = new AzureSASCredential("signature1");
// prints: "signature1"
console.log(credential.signature);
credential.update("signature2");
// prints: "signature2"
console.log(credential.signature);

Étapes suivantes

Vous pouvez générer et exécuter les tests localement en exécutant rushx test. Explorez le dossier test pour voir l’utilisation et le comportement avancés des classes publiques.

Résolution des problèmes

Si vous rencontrez des problèmes lors de l’utilisation de cette bibliothèque, n’hésitez pas à signaler un problème.

Contribution

Si vous souhaitez contribuer à cette bibliothèque, lisez le guide de contribution pour en savoir plus sur la génération et le test du code.

Impressions