Bibliothèque cliente Azure Core Authentication pour JavaScript - version 1.10.1

Le @azure/core-auth package fournit des interfaces de base et des méthodes d’assistance pour l’authentification auprès des services Azure à l’aide d’Azure Active Directory et d’autres schémas d’authentification courants dans le Kit de développement logiciel (SDK) Azure. En tant que bibliothèque « principale », il ne doit pas être nécessaire de l’ajouter en tant que dépendance à un code utilisateur, mais uniquement à d’autres bibliothèques du Kit de développement logiciel (SDK) Azure.

Mise en route

Installation

Installez cette bibliothèque à l’aide de npm comme suit

npm install @azure/core-auth

Concepts clés

L’interface TokenCredential représente un identifiant capable de fournir un jeton d’authentification. Le @azure/identity package contient diverses informations d’identification qui implémentent l’interface TokenCredential .

Il s’agit AzureKeyCredential d’informations d’identification statiques basées sur des clés qui prennent en charge la rotation des clés via la update méthode. Utilisez-le lorsqu’une seule valeur secrète est nécessaire pour l’authentification, par exemple lors de l’utilisation d’une clé d’accès partagée.

Il s’agit AzureNamedKeyCredential d’informations d’identification statiques basées sur un nom/une clé qui prend en charge la rotation des noms et des clés via la update méthode. Utilisez-le lorsqu’une valeur secrète et une étiquette sont nécessaires, par exemple lors de l’utilisation d’une clé d’accès partagée et d’un nom de clé d’accès partagé.

Il s’agit AzureSASCredential d’informations d’identification statiques basées sur la signature qui prend en charge la mise à jour de la valeur de signature via la update méthode. Utilisez-le lors de l’utilisation d’une signature d’accès partagé.

Examples

AzureKeyCredential

import { AzureKeyCredential } from "@azure/core-auth";

const credential = new AzureKeyCredential("secret value");

console.log(credential.key); // prints: "secret value"

credential.update("other secret value");

console.log(credential.key); // prints: "other secret value"

AzureNamedKeyCredential

import { AzureNamedKeyCredential } from "@azure/core-auth";

const credential = new AzureNamedKeyCredential("ManagedPolicy", "secret value");

console.log(`${credential.name}, ${credential.key}`); // prints: "ManagedPolicy, secret value"

credential.update("OtherManagedPolicy", "other secret value");

console.log(`${credential.name}, ${credential.key}`); // prints: "OtherManagedPolicy, other secret value"

AzureSASCredential

import { AzureSASCredential } from "@azure/core-auth";

const credential = new AzureSASCredential("signature1");

console.log(credential.signature); // prints: "signature1"

credential.update("signature2");

console.log(credential.signature); // prints: "signature2"

Étapes suivantes

Vous pouvez générer et exécuter les tests localement en exécutant npm run test. Explorez le test dossier 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 à le signaler.

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.