page_type | languages | products | urlFragment | |||
---|---|---|---|---|---|---|
sample |
|
|
keyvault-certificates-typescript |
These sample programs show how to use the TypeScript client libraries for Azure Key Vault Certificates in some common scenarios.
File Name | Description |
---|---|
backupAndRestore.ts | creates a self-signed certificate, then makes a backup from it, then deletes it and purges it, and finally restores it |
contacts.ts | creates, updates and deletes certificate contacts |
deleteAndRecover.ts | creates a self-signed certificate, then deletes it, then recovers it (soft-delete is required for this sample to run, see: https://docs.microsoft.com/azure/key-vault/key-vault-ovw-soft-delete) |
helloWorld.ts | creates a self-signed certificate, reads it in various ways, updates the tags of the certificate and finally deletes the certificate |
issuers.ts | creates, updates and deletes certificate issuers |
listCertificates.ts | lists previously created certificates in a single chunk and by page, then changes one of them and lists all the versions of that certificate, then deletes them and lists the deleted certificates. |
mergeCertificate.ts | creates a certificate with an Unknown issuer, then signs this certificate using a fake certificate authority and the mergeCertificate API method |
operations.ts | creates, updates and deletes a certificate's operation |
purgeAllCertificates.ts | purges all the certificates of a Key Vault (useful for repeated tests) |
The samples are compatible with Node.js >= 8.0.0.
Before running the samples in Node, they must be compiled to JavaScript using the TypeScript compiler. For more information on TypeScript, see the TypeScript documentation. Install the TypeScript compiler using
npm install -g typescript
You need an Azure subscription and an Azure Key Vault 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 this page for more information.
Samples retrieve credentials to access the Key Vault 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.
To run the samples using the published version of the package:
- Install the dependencies using
npm
:
npm install
- Compile the samples
npm run build
-
Edit the file
sample.env
, adding the correct credentials to access the Azure service and run the samples. Then rename the file fromsample.env
to just.env
. The sample programs will read this file automatically. -
Run whichever samples you like (note that some samples may require additional setup, see the table above):
node dist/helloWorld.js
Alternatively, run a single sample with the correct environment variables set (step 3 is not required if you do this), for example (cross-platform):
npx cross-env KEYVAULT_URI="<key vault URI>" AZURE_TENANT_ID="<AAD tenant id>" AZURE_CLIENT_ID="<AAD client id>" AZURE_CLIENT_SECRET="<AAD client secret>" node dist/helloWorld.js
Take a look at our API Documentation for more information about the APIs that are available in the clients.