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

Das @azure/core-auth Paket enthält wichtige Schnittstellen und Hilfsmethoden für die Authentifizierung bei Azure-Diensten mithilfe von Azure Active Directory und anderen Authentifizierungsschemas, die im Azure SDK üblich sind. Als "Kern"-Bibliothek 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 mit npm wie folgt

npm install @azure/core-auth

Wichtige Konzepte

Die TokenCredential Schnittstelle stellt Anmeldeinformationen dar, die ein Authentifizierungstoken bereitstellen können. Das @azure/identity Paket enthält verschiedene Anmeldeinformationen, die die TokenCredential Schnittstelle implementieren.

Bei AzureKeyCredential handelt es sich um statische schlüsselbasierte Anmeldeinformationen, die die Schlüsselrotation über die update Methode unterstützen. Verwenden Sie diese Option, wenn ein einzelner geheimer Wert für die Authentifizierung benötigt wird, z. B. bei der Verwendung eines Shared-Access-Schlüssels.

Bei AzureNamedKeyCredential handelt es sich um statische namens-/schlüsselbasierte Anmeldeinformationen, die die Namens- und Schlüsselrotation über die update Methode unterstützen. Verwenden Sie diese Option, wenn sowohl ein geheimer Wert als auch eine Bezeichnung benötigt werden, z. B. wenn Sie einen Shared-Access-Schlüssel und einen Shared-Access-Schlüsselnamen verwenden.

Bei AzureSASCredential handelt es sich um statische signaturbasierte Anmeldeinformationen, die das Aktualisieren des Signaturwerts über die update Methode unterstützen. Verwenden Sie diese Option, wenn Sie eine Shared Access Signature verwenden.

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"

Nächste Schritte

Sie können die Tests lokal erstellen und ausführen, indem Sie npm run test. Durchsuchen Sie den test Ordner, um die erweiterte Verwendung und das Verhalten der öffentlichen Klassen anzuzeigen.

Problembehandlung

Wenn Sie bei der Verwendung dieser Bibliothek auf Probleme stoßen, können Sie gerne ein Problem melden.

Contributing

Wenn Sie an dieser Bibliothek mitwirken möchten, lesen Sie bitte den mitwirkenden Leitfaden, um mehr über das Erstellen und Testen des Codes zu erfahren.