Freigeben über

Erste Schritte mit Azure Key Vault Geheimnissen in JavaScript

In diesem Artikel erfahren Sie, wie Sie mithilfe der Azure Key Vault geheimen Clientbibliothek für JavaScript eine Verbindung mit Azure Key Vault herstellen. Sobald die Verbindung hergestellt ist, kann Ihr Code mit Geheimnissen und geheimen Eigenschaften im Tresor arbeiten.

API-Referenz | Package (npm) | Library Quellcode | Beispiele | Feedback geben

Voraussetzungen

Einrichten des Projekts

  1. Öffnen Sie eine Eingabeaufforderung und wechseln Sie in ihren Projektordner. Ändern Sie <project-directory> in den Ordnernamen:

    cd <project-directory>

  2. Wenn Sie noch keine package.json-Datei in Ihrem Verzeichnis haben, initialisieren Sie das Projekt, um die Datei zu erstellen:

    npm init -y

  3. Installieren Sie die Azure Key Vault geheimen Clientbibliothek für JavaScript:

    npm install @azure/keyvault-secrets

  4. Wenn Sie kennwortlose Verbindungen mit Microsoft Entra ID verwenden möchten, installieren Sie die Azure Identity-Clientbibliothek für JavaScript:

    npm install @azure/identity

Autorisieren des Zugriffs und Herstellen einer Verbindung mit Key Vault

Microsoft Entra ID bietet die sicherste Verbindung, indem die Verbindungsidentität verwaltet wird (managed Identity). Mit dieser kennwortlosen Funktionalität können Sie eine Anwendung entwickeln, die keine geheimen Schlüssel (Schlüssel oder Verbindungszeichenfolgen) benötigt, die im Code gespeichert sind.

Bevor Sie sich bei Azure programmatisch authentifizieren, um die Secrets im Azure Key Vault zu verwenden, stellen Sie sicher, die Umgebung einzurichten.

Diagramm Azure SDK für den JavaScript-Anmeldeinformationsfluss.

Ein Entwickler sollte Azure CLI installieren und sich interaktiv mit dem Anmeldebefehl az login anmelden, um sich bei Azure anzumelden, bevor Sie die DefaultAzureCredential im Code verwenden.

az login

Erstellen Ihrer Anwendung

Während Sie Ihre Anwendung erstellen, interagiert Ihr Code mit zwei Arten von Ressourcen:

  • KeyVaultSecret, das Folgendes umfasst:
    • Geheimer Name, ein Zeichenfolgenwert.
    • Geheimniswert, bei dem es sich um eine Zeichenfolge des Geheimnisses handelt. Sie stellen die Serialisierung und Deserialisierung des Geheimniswerts nach Bedarf in und aus einer Zeichenfolge bereit.
    • Geheime Eigenschaften.
  • SecretProperties, die die Metadaten des geheimen Schlüssels enthalten, z. B. name, Version, Tags, Ablaufdaten und ob er aktiviert ist.

Wenn Sie den Wert des KeyVaultSecret benötigen, verwenden Sie Methoden, die den KeyVaultSecret zurückgeben:

Der Rest der Methoden gibt das SecretProperties-Objekt oder eine andere Form der Eigenschaften zurück, z. B.:

Erstellen eines SecretClient-Objekts

Das SecretClient-Objekt ist das oberste Objekt im SDK. Mit diesem Client können Sie die geheimen Schlüssel bearbeiten.

Nachdem Ihre Azure Key Vault Zugriffsrollen und Ihre lokale Umgebung eingerichtet sind, erstellen Sie eine JavaScript-Datei, die das Paket @azure/identity einbezieht. Erstellen Sie Anmeldeinformationen, z. B. DefaultAzureCredential, um kennwortlose Verbindungen mit Ihrem Tresor zu implementieren. Verwenden Sie diese Anmeldeinformationen, um sich bei einem SecretClient-Objekt zu authentifizieren.

// Include required dependencies
import { DefaultAzureCredential } from '@azure/identity';  
import { SecretClient } from '@azure/keyvault-secrets';  

// Authenticate to Azure
const credential = new DefaultAzureCredential(); 

// Create SecretClient
const vaultName = '<vault-name>';  
const url = `https://${vaultName}.vault.azure.net`;  
const client = new SecretClient(url, credential);  

// Get secret
const secret = await client.getSecret("MySecretName");

Siehe auch

Nächste Schritte

  • Last updated on