Rövid útmutató: Azure Key Vault titkos ügyfélkódtár JavaScripthez

Ismerkedés a JavaScripthez készült Azure Key Vault titkos ügyfélkódtárával. Az Azure Key Vault egy felhőalapú szolgáltatás, amely biztonságos tárat biztosít a titkos kódokhoz. Biztonságosan tárolhatja kulcsait, jelszavait, tanúsítványait és egyéb titkos adatait. Az Azure-kulcstartók létrehozhatók és kezelhetők az Azure Portal segítségével is. Ebben a rövid útmutatóban megtudhatja, hogyan hozhat létre, kérdezhet le és törölhet titkos kulcsokat egy Azure-kulcstartóból a JavaScript-ügyfélkódtár használatával.

Key Vault ügyfélkódtár erőforrásai:

API-referenciadokumentáció | Könyvtár forráskódja | csomag (npm)

További információ a Key Vaultról és a titkos kódokról:

Előfeltételek

Azure-előfizetés – hozzon létre egyet ingyenesen.
Aktuális Node.js LTS.
Azure CLI

Előfeltételek

Azure-előfizetés – hozzon létre egyet ingyenesen.
Aktuális Node.js LTS.
TypeScript 5+
Azure parancssori felület (CLI).

Ez a rövid útmutató feltételezi, hogy az Azure CLI-t futtatja.

Futtassa a következő parancsot: login.
```
az login
```
Ha a parancssori felület meg tudja nyitni az alapértelmezett böngészőt, az meg fogja tenni, és betölt egy Azure-bejelentkezési lapot.

Ellenkező esetben nyisson meg egy böngészőlapot, https://aka.ms/devicelogin és adja meg a terminálban megjelenő engedélyezési kódot.
A böngészőben jelentkezzen be fiókja hitelesítő adataival.

az group create A parancs használatával hozzon létre egy erőforráscsoportot:
```
az group create --name "myResourceGroup" --location "EastUS"
```
Tetszés szerint módosíthatja az "EastUS" értékét az Önhöz közelebbi helyre.
A kulcstartó létrehozásához használható az keyvault create :
```
az keyvault create --name "<vault-name>" --resource-group "myResourceGroup" --enable-rbac-authorization true --enable-purge-protection true
```
Cserélje le <vault-name> az Azure egészében egyedi névre. A személyes vagy céges nevét általában más számokkal és azonosítókkal együtt használja.

New-AzResourceGroup A parancs használatával hozzon létre egy erőforráscsoportot:
```
New-AzResourceGroup -Name "myResourceGroup" -Location "EastUS"
```
Tetszés szerint módosíthatja az "EastUS" értékét az Önhöz közelebbi helyre.
A kulcstartó létrehozásához használható New-AzKeyVault :
```
New-AzKeyVault -Name "<vault-name>" -ResourceGroupName "myResourceGroup" -Location "EastUS" -EnableRbacAuthorization $true -EnablePurgeProtection
```
Cserélje le <vault-name> az Azure egészében egyedi névre. A személyes vagy céges nevét általában más számokkal és azonosítókkal együtt használja.

Hozzáférés biztosítása a kulcstárolóhoz

Ha szerepkör-alapú hozzáférés-vezérléssel (RBAC) szeretne engedélyeket szerezni a kulcstartó tárolóhoz, rendeljen hozzá egy szerepkört a "Felhasználói főnév" (UPN) használatával az Azure CLI az role assignment create paranccsal.

az role assignment create --role "Key Vault Secrets Officer" --assignee "<upn>" --scope "/subscriptions/<subscription-id>/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/<vault-name>"

Cserélje le <upn>-t, <subscription-id>-t és <vault-name>-t a tényleges értékekre. Ha más erőforráscsoportnevet használt, cserélje le a "myResourceGroup" nevet is. Az UPN általában egy e-mail-cím (pl. username@domain.com) formátumban lesz.

Új Node.js alkalmazás létrehozása

Hozzon létre egy Node.js alkalmazást, amely a kulcstárat használja.

Egy terminálban hozzon létre egy mappát, key-vault-node-app és váltson az adott mappára:
```
mkdir key-vault-node-app && cd key-vault-node-app
```
Inicializálja a Node.js projektet:
```
npm init -y
```

Key Vault-csomagok telepítése

A terminál használatával telepítse az Azure Key Vault titkok ügyfélkönyvtárat, @azure/keyvault-secrets a Node.js-hez.
```
npm install @azure/keyvault-secrets
```
Telepítse az Azure Identity ügyfélkönyvtárát, a @azure/identity csomagot a Key Vaultban való hitelesítéshez.
```
npm install @azure/identity
```

Környezeti változók beállítása

Ez az alkalmazás a Key Vault végpontot használja környezeti változóként.KEY_VAULT_URL

set KEY_VAULT_URL=<key-vault-endpoint>

Windows PowerShell

$Env:KEY_VAULT_URL="<key-vault-endpoint>"

export KEY_VAULT_URL=<key-vault-endpoint>

Ügyfél hitelesítése és létrehozása

A legtöbb Azure-szolgáltatáshoz irányuló alkalmazáskéréseket engedélyezni kell. Az Azure Identity ügyfélkódtár által biztosított DefaultAzureCredential metódus használata ajánlott módszer az Azure-szolgáltatások jelszó nélküli kapcsolatainak implementálásához a kódban. DefaultAzureCredential több hitelesítési módszert támogat, és meghatározza, hogy melyik metódust kell használni futásidőben. Ez a megközelítés lehetővé teszi, hogy az alkalmazás különböző hitelesítési módszereket használjon különböző környezetekben (helyi és éles környezetben) környezetspecifikus kód implementálása nélkül.

Ebben a rövid útmutatóban DefaultAzureCredential az Azure CLI-be bejelentkezett helyi fejlesztő felhasználó hitelesítő adataival hitelesíti a Key Vaultot. Az alkalmazás Azure-ban való üzembe helyezésekor ugyanaz DefaultAzureCredential a kód automatikusan felderítheti és használhat egy App Service-hez, virtuális géphez vagy más szolgáltatáshoz hozzárendelt felügyelt identitást. További információ: a Felügyelt identitás áttekintése.

Ebben a kódban a kulcstár végpontját használja a kulcstár-kliens létrehozásához. A végpont formátuma így néz ki, https://<vault-name>.vault.azure.net de a szuverén felhők esetében változhat. A Key Vaultba való hitelesítésről további információt a fejlesztői útmutatóban talál.

Mintakód

Az alábbi kódminták bemutatják, hogyan hozhat létre ügyfelet, állíthat be egy titkos kulcsot, lekérhet egy titkos kulcsot, és törölheti a titkos kulcsokat.

Ez a kód a következő Key Vault titkososztályokat és metódusokat használja:

Az alkalmazás-keretrendszer beállítása

Hozzon létre új szövegfájlt, és illessze be a következő kódot a index.js fájlba.

const { SecretClient } = require("@azure/keyvault-secrets");
const { DefaultAzureCredential } = require("@azure/identity");

async function main() {
  // DefaultAzureCredential automatically uses managed identity in Azure environments.
  // For local development, it uses credentials from Azure CLI, Azure PowerShell, or environment variables.
  // See: https://learn.microsoft.com/javascript/api/@azure/identity/defaultazurecredential
  const credential = new DefaultAzureCredential();

  const keyVaultUrl = process.env["KEY_VAULT_URL"];
  if(!keyVaultUrl) throw new Error("KEY_VAULT_URL is empty");

  const client = new SecretClient(keyVaultUrl, credential);

  // Create a secret
  // The secret can be a string of any kind. For example,
  // a multiline text block such as an RSA private key with newline characters,
  // or a stringified JSON object, like `JSON.stringify({ mySecret: 'MySecretValue'})`.
  const uniqueString = new Date().getTime();
  const secretName = `secret${uniqueString}`;
  const result = await client.setSecret(secretName, "MySecretValue");
  console.log("result: ", result);

  // Read the secret we created
  const secret = await client.getSecret(secretName);
  console.log("secret: ", secret);

  // Update the secret with different attributes
  const updatedSecret = await client.updateSecretProperties(secretName, result.properties.version, {
    enabled: false
  });
  console.log("updated secret: ", updatedSecret);

  // Delete the secret immediately without ability to restore or purge.
  await client.beginDeleteSecret(secretName);
}

main().catch((error) => {
  console.error("An error occurred:", error);
  process.exit(1);
});

A mintaalkalmazás futtatása

Futtassa az alkalmazást:
```
node index.js
```

A létrehozási és lekérési metódusok egy teljes JSON-objektumot adnak vissza a titkos kódhoz:

{
    "value": "MySecretValue",
    "name": "secret1637692472606",
    "properties": {
        "createdOn": "2021-11-23T18:34:33.000Z",
        "updatedOn": "2021-11-23T18:34:33.000Z",
        "enabled": true,
        "recoverableDays": 90,
        "recoveryLevel": "Recoverable+Purgeable",
        "id": "https://<vault-name>.vault.azure.net/secrets/secret1637692472606/e13f3558b4ca4363a8e402e11e7b193c",
        "vaultUrl": "https://<vault-name>.vault.azure.net",
        "version": "e13f3558b4ca4363a8e402e11e7b193c",
        "name": "secret1637692472606"
    }
}

A frissítési módszer a tulajdonságok nevét/értékeit adja vissza:

"createdOn": "2021-11-23T18:34:33.000Z",
"updatedOn": "2021-11-23T18:34:33.000Z",
"enabled": true,
"recoverableDays": 90,
"recoveryLevel": "Recoverable+Purgeable",
"id": "https://<vault-name>.vault.azure.net/secrets/secret1637692472606/e13f3558b4ca4363a8e402e11e7b193c",
"vaultUrl": "https://<vault-name>.vault.azure.net",
"version": "e13f3558b4ca4363a8e402e11e7b193c",
"name": "secret1637692472606"

Hozzon létre új szövegfájlt, és illessze be a következő kódot a index.ts fájlba.

import {
  SecretClient,
  KeyVaultSecret,
  SecretProperties,
} from "@azure/keyvault-secrets";
import { DefaultAzureCredential } from "@azure/identity";
import "dotenv/config";

// Passwordless credential
const credential = new DefaultAzureCredential();

// Get Key Vault name from environment variables
// such as `https://${keyVaultName}.vault.azure.net`
const keyVaultUrl = process.env.KEY_VAULT_URL;
if (!keyVaultUrl) throw new Error("KEY_VAULT_URL is empty");

function printSecret(secret: KeyVaultSecret): void {
  const { name, value, properties } = secret;
  const { enabled, expiresOn, createdOn } = properties;
  console.log("Secret: ", { name, value, enabled, expiresOn, createdOn });
}
function printSecretProperties(secret: SecretProperties): void {
  const { name, enabled, expiresOn, createdOn } = secret;
  console.log("Secret: ", { name, enabled, expiresOn, createdOn });
}

async function main(): Promise<void> {
  // Create a new SecretClient
  const client = new SecretClient(keyVaultUrl, credential);

  // Create a unique secret name
  const uniqueString = new Date().getTime().toString();
  const secretName = `secret${uniqueString}`;

  // Create a secret
  const createSecretResult = await client.setSecret(
    secretName,
    "MySecretValue"
  );
  printSecret(createSecretResult);

  // Get the secret by name
  const getSecretResult = await client.getSecret(secretName);
  printSecret(getSecretResult);

  // Update properties
  const updatedSecret = await client.updateSecretProperties(
    secretName,
    getSecretResult.properties.version,
    {
      enabled: false,
    }
  );
  printSecretProperties(updatedSecret);

  // Delete secret (without immediate purge)
  const deletePoller = await client.beginDeleteSecret(secretName);
  await deletePoller.pollUntilDone();
}

main().catch((error) => {
  console.error("An error occurred:", error);
  process.exit(1);
});

A mintaalkalmazás futtatása

A TypeScript-alkalmazás létrehozása:
```
tsc
```
Futtassa az alkalmazást:
```
node index.js
```

A létrehozási és lekérési metódusok egy teljes JSON-objektumot adnak vissza a titkos kódhoz:

{
    "value": "MySecretValue",
    "name": "secret1637692472606",
    "properties": {
        "createdOn": "2021-11-23T18:34:33.000Z",
        "updatedOn": "2021-11-23T18:34:33.000Z",
        "enabled": true,
        "recoverableDays": 90,
        "recoveryLevel": "Recoverable+Purgeable",
        "id": "https://<vault-name>.vault.azure.net/secrets/secret1637692472606/e13f3558b4ca4363a8e402e11e7b193c",
        "vaultUrl": "https://<vault-name>.vault.azure.net",
        "version": "e13f3558b4ca4363a8e402e11e7b193c",
        "name": "secret1637692472606"
    }
}

A frissítési módszer a tulajdonságok nevét/értékeit adja vissza:

"createdOn": "2021-11-23T18:34:33.000Z",
"updatedOn": "2021-11-23T18:34:33.000Z",
"enabled": true,
"recoverableDays": 90,
"recoveryLevel": "Recoverable+Purgeable",
"id": "https://<vault-name>.vault.azure.net/secrets/secret1637692472606/e13f3558b4ca4363a8e402e11e7b193c",
"vaultUrl": "https://<vault-name>.vault.azure.net",
"version": "e13f3558b4ca4363a8e402e11e7b193c",
"name": "secret1637692472606"

Integráció az alkalmazáskonfigurációval

Az Azure SDK egy segédmetódust, a parseKeyVaultSecretIdentifier metódust biztosít a megadott Key Vault titkos azonosítójának elemzéséhez. Erre akkor van szükség, ha a Key Vault alkalmazáskonfigurációs hivatkozásait használja. Az App Config tárolja a Key Vault titkos kulcsazonosítóját. Az azonosító elemzéséhez a parseKeyVaultSecretIdentifier metódusra van szüksége a titkos kódnév lekéréséhez. Miután megkapta a titkos kód nevét, a rövid útmutatóban szereplő kód használatával lekérheti az aktuális titkos értéket.

Következő lépések

Ebben a rövid útmutatóban létrehozott egy kulcstartót, tárolt egy titkos kulcsot, és lekérte a titkos kulcsot. Ha többet szeretne megtudni a Key Vaultról és az alkalmazásokba való integrálásáról, folytassa az alábbi cikkekkel.

Az Azure Key Vault áttekintése
Az Azure Key Vault titkos kulcsainak áttekintése
Hogyan tegyük a kulcstárhoz való hozzáférést biztonságossá
Titkos kódokra vonatkozó ajánlott biztonsági eljárások áttekintése
Tekintse meg az Azure Key Vault fejlesztői útmutatóját
Tekintse át a Key Vault biztonsági áttekintését

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2026-03-27

Rövid útmutató: Azure Key Vault titkos ügyfélkódtár JavaScripthez

Előfeltételek

Előfeltételek

Bejelentkezés az Azure-ba

Erőforráscsoport és kulcstár létrehozása

Hozzáférés biztosítása a kulcstárolóhoz

Új Node.js alkalmazás létrehozása

Key Vault-csomagok telepítése

Környezeti változók beállítása

Ügyfél hitelesítése és létrehozása

Mintakód

Az alkalmazás-keretrendszer beállítása

A mintaalkalmazás futtatása

A mintaalkalmazás futtatása

Integráció az alkalmazáskonfigurációval

Következő lépések

Visszajelzés

További források