Azure Core Authentication-Clientbibliothek für JavaScript– Version 1.7.2

Das @azure/core-auth-Paket bietet Kernschnittstellen und Hilfsmethoden für die Authentifizierung bei Azure-Diensten unter Verwendung von Azure Active Directory und anderen im Azure SDK üblichen Authentifizierungsschemas. Da es sich um eine „Kernbibliothek“ handelt, sollte sie nicht als Abhängigkeit zu Benutzercode hinzugefügt werden müssen, sondern nur zu anderen Azure SDK-Bibliotheken.

Erste Schritte

Installation

Installieren Sie diese Bibliothek mithilfe von npm wie folgt

npm install @azure/core-auth

Wichtige Konzepte

Die TokenCredential-Schnittstelle stellt eine Anmeldeinformation dar, die ein Authentifizierungstoken bereitstellen kann. Das @azure/identity-Paket enthält verschiedene Anmeldeinformationen, die die TokenCredential-Schnittstelle implementieren.

AzureKeyCredential ist eine statische schlüsselbasierte Anmeldeinformation, die die Schlüsselrotation über die update-Methode unterstützt. Wählen Sie diese Option, wenn ein einzelner Geheimniswert für die Authentifizierung benötigt wird, z. B. bei der Verwendung eines Schlüssels für gemeinsamen Zugriff.

AzureNamedKeyCredential ist eine statische namens-/schlüsselbasierte Anmeldeinformation, die die Namens- und Schlüsselrotation über die update-Methode unterstützt. Verwenden Sie diese Option, wenn sowohl ein Geheimniswert als auch eine Bezeichnung benötigt werden, z. B. bei der Verwendung eines Schlüssels für gemeinsamen Zugriff und eines Namens für den Schlüssel für gemeinsamen Zugriff.

AzureSASCredential ist eine statische signaturbasierte Anmeldeinformation, die die Aktualisierung des Signaturwerts über die update-Methode unterstützt. Verwenden Sie diese Option, wenn Sie eine Signatur für gemeinsamen Zugriff verwenden.

Beispiele

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);

Nächste Schritte

Sie können die Tests lokal entwickeln und ausführen, indem Sie rushx test ausführen. Erkunden Sie den Ordner test, um die erweiterte Nutzung und das Verhalten der öffentlichen Klassen kennenzulernen.

Problembehandlung

Wenn bei Nutzung dieser Bibliothek Probleme auftreten, können Sie uns gerne ein Problem melden.

Mitwirken

Wenn Sie an dieser Bibliothek mitwirken möchten, lesen Sie die Anleitung für Mitwirkende, um mehr darüber zu erfahren, wie Sie den Code erstellen und testen können.