Delen via

Aan de slag met Azure Key Vault geheimen in JavaScript

In dit artikel leest u hoe u verbinding maakt met Azure Key Vault met behulp van de Azure Key Vault Secrets-clientbibliotheek voor JavaScript. Nadat u verbinding hebt gemaakt, kan uw code met geheimen en geheime eigenschappen in de kluis werken.

API-verwijzing | Package (npm) | Library-broncode | Voorbeelden | Feedback geven

Vereiste voorwaarden

Stel uw project in

  1. Open een opdrachtprompt en ga naar de projectmap. Wijzig <project-directory> naar uw mapnaam:

    cd <project-directory>

  2. Als u nog geen bestand in uw map hebt package.json , initialiseert u het project om het bestand te maken:

    npm init -y

  3. Installeer de clientbibliotheek voor Azure Key Vault-secrets in JavaScript:

    npm install @azure/keyvault-secrets

  4. Als u verbindingen zonder wachtwoord wilt gebruiken met Microsoft Entra ID, installeert u de Azure Identity-clientbibliotheek voor JavaScript:

    npm install @azure/identity

Toegang autoriseren en verbinding maken met Key Vault

Microsoft Entra ID biedt de veiligste verbinding door de verbindingsidentiteit (managed identiteit) te beheren. Met deze functionaliteit zonder wachtwoord kunt u een toepassing ontwikkelen waarvoor geen geheimen (sleutels of verbindingsreeksen) zijn vereist die zijn opgeslagen in de code.

Voordat u programmatisch verificatie uitvoert voor Azure voor het gebruik van Azure Key Vault geheimen, moet u ervoor zorgen dat u uw omgeving instelt.

Diagram van Azure SDK voor JavaScript-referentiestroom.

Een ontwikkelaar moet Azure CLI installeren en zich interactief aanmelden met de opdracht az login om u aan te melden bij Azure voordat u de DefaultAzureCredential in code gebruikt.

az login

Uw toepassing bouwen

Wanneer u uw toepassing bouwt, communiceert uw code met twee typen resources:

  • KeyVaultSecret, waaronder:
    • Geheime naam, een tekenreekswaarde.
    • Geheime waarde, een tekenreeks van de geheime gegevens. U faciliteert de serialisatie en deserialisatie van de geheime waarde naar een tekenreeks en weer terug, indien nodig.
    • Geheime eigenschappen.
  • SecretProperties, waaronder de metagegevens van het geheim, zoals de naam, versie, tags, verloopgegevens en of het is ingeschakeld.

Als u de waarde van KeyVaultSecret nodig hebt, gebruikt u methoden die de KeyVaultSecret retourneren:

De rest van de methoden retourneren het Object SecretProperties of een andere vorm van de eigenschappen, zoals:

Een SecretClient-object maken

Het SecretClient-object is het bovenste object in de SDK. Met deze client kunt u de geheimen bewerken.

Zodra uw Azure Key Vault toegangsrollen en uw lokale omgeving zijn ingesteld, maakt u een JavaScript-bestand dat het pakket @azure/identity bevat. Maak een referentie, zoals de DefaultAzureCredential, om wachtwoordloze verbindingen met uw kluis te implementeren. Gebruik deze referentie om te verifiëren met een SecretClient-object .

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

Zie ook

Volgende stappen

  • Last updated on