Azure Key Vault Keys client library samples for JavaScript (Beta)

These sample programs show how to use the JavaScript client libraries for Azure Key Vault Keys in some common scenarios.

File Name Description
cryptography.js Uses an Azure Key Vault key to sign/verify, encrypt/decrypt, and wrap/unwrap data.
helloWorld.js Creates, reads, lists, and deletes keys.
keyRotation.js Creates and updates a key's automated rotation policy, and rotates a key on-demand.
secureWrapKey.js Wraps a TEE-generated symmetric key with a Key Vault key, then unwraps it. Demonstrates the SECURE WRAP and SECURE UNWRAP operations on Azure Managed HSM. Unlike the regular wrap/unwrap operations, the symmetric key being wrapped is generated inside a Trusted Execution Environment (TEE) and the unwrap operation is gated by attestation through Microsoft Azure Attestation (MAA). These operations are only available on Managed HSM and require an non exportable RSA key with an appropriate release policy. Replace <attestation-target> below with a valid MAA token for your environment.

Prerequisites

The sample programs are compatible with LTS versions of Node.js.

You need an Azure subscription and the following Azure resources to run these sample programs:

To quickly create the needed Key Vault resources in Azure and to receive a connection string for them, you can deploy our sample template by clicking:

If creating the Key Vault manually using the Azure Portal, be aware that the samples require that the soft-delete feature be enabled. Our template above will enable this feature automatically, but it is possible to enable it manually using the Azure CLI. See the documentation for enabling soft-delete in Key Vault for more information.

Samples retrieve credentials to access the service endpoint from environment variables. Alternatively, edit the source code to include the appropriate credentials. See each individual sample for details on which environment variables/credentials it requires to function.

Adapting the samples to run in the browser may require some additional consideration. For details, please see the package README.

Setup

To run the samples using the published version of the package:

  1. Install the dependencies using npm:
npm install
  1. Edit the file sample.env, adding the correct credentials to access the Azure service and run the samples. Then rename the file from sample.env to just .env. The sample programs will read this file automatically.

  2. Run whichever samples you like (note that some samples may require additional setup, see the table above):

node cryptography.js

Alternatively, run a single sample with the required environment variables set (setting up the .env file is not required if you do this), for example (cross-platform):

npx cross-env KEYVAULT_URI="<keyvault uri>" node cryptography.js

Next Steps

Take a look at our API Documentation for more information about the APIs that are available in the clients.