---
title: "Azure Key Vault Secrets SDK for TypeScript: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/microsoft-azure-keyvault-secrets-ts/
description: "Microsoft's TypeScript guide to @azure/keyvault-secrets for setting, reading, versioning, deleting, recovering and backing up Key Vault secrets; the same file also carries key and cryptography operations."
---

# Azure Key Vault Secrets SDK for TypeScript: review, setup & limitations · Undominated.ai

> Microsoft's TypeScript guide to @azure/keyvault-secrets for setting, reading, versioning, deleting, recovering and backing up Key Vault secrets; the same file also carries key and cryptography operations.

[← Explore all skills](/skills/)

CLOUD DEVELOPMENT / Microsoft

# Azure Key Vault Secrets SDK for TypeScript

Microsoft's TypeScript guide to @azure/keyvault-secrets for setting, reading, versioning, deleting, recovering and backing up Key Vault secrets; the same file also carries key and cryptography operations.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/microsoft/skills/tree/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-typescript/skills/azure-keyvault-secrets-ts)

SOURCE REVIEW

 Reviewed 2026-10-21
 Evidence 6 linked sources
 Publisher Microsoft
 Licence [MIT ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE)
 Revision fc164ba1d7a0
 [Read what was—and wasn’t—checked ↓](#review)

“Manage secrets using Azure Key Vault Secrets SDK for JavaScript (@azure/keyvault-secrets). Use when storing and retrieving application secrets or configuration values.”

 [Microsoft · upstream description ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-typescript/skills/azure-keyvault-secrets-ts/SKILL.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - It walks a secret's lifecycle: set it with enabled, expiresOn, contentType and tags, read the latest or a given version, list names and versions, soft-delete, purge and recover.
- It builds DefaultAzureCredential with requiredEnvVars: ["AZURE_TOKEN_CREDENTIALS"], leaves ManagedIdentityCredential as the commented production alternative, and handles the SecretNotFound error code explicitly.
- Its practice list asks for soft-delete on production vaults and expiration dates on both keys and secrets.

### A good fit for

 - Store an application secret from Node.js with an expiry date, content type and tags
- Read the latest or a pinned version of a Key Vault secret in TypeScript
- Recover a soft-deleted secret, or purge it for good
- Back up a secret and restore it into another vault

### Weigh up before choosing

 - Both install lines Microsoft prints for this skill, `npx skills add microsoft/skills --skill azure-sdk-typescript` and `/plugin install azure-sdk-typescript@skills`, install the whole azure-sdk-typescript plugin rather than the secrets skill alone.
- This file and the azure-keyvault-keys-ts skill differ in eight lines only (frontmatter name, description and package, title, intro line, install comment and command, one import); both teach secrets and keys.
- The install line adds @azure/keyvault-secrets and @azure/identity only, but the samples also use KeyClient and CryptographyClient from @azure/keyvault-keys, and the Authentication block constructs KeyClient without importing it there.
- The Get Secret sample prints the secret value with console.log(secret.value).
- The Delete Secret block soft-deletes, purges (commented "permanent") and then tries to recover the same secret, with no confirmation step.
- Sample secrets and keys expire on new Date("2025-12-31"), which had already passed by the review date, 2026-10-21.
- references/keys.md and references/secrets.md are present but not linked from SKILL.md, and this review did not read them.
- The skill directory was last changed at the pin by commit ee33ce9d on 2026-04-21 (2026-04-22T00:13:36Z UTC).

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - .github/plugins/azure-sdk-typescript/skills/azure-keyvault-secrets-ts/SKILL.md (all 278 lines)
- .github/plugins/azure-sdk-typescript/skills/azure-keyvault-keys-ts/SKILL.md (compared line by line)
- .github/plugins/azure-sdk-typescript/README.md
- .github/plugins/azure-sdk-typescript/.claude-plugin/plugin.json
- README.md
- LICENSE

### Our findings

 - The list samples iterate listPropertiesOfSecrets and listPropertiesOfSecretVersions and print names and versions, not values.
- Backup and restore use backupSecret and restoreSecretBackup, with the comment that a backup can be restored to a different vault.
- Practice 6 says the SDKs are Node.js only; the browser is not supported.
- The error-handling sample treats error.code === "SecretNotFound" as a missing secret and rethrows any other error.
- The frontmatter declares license MIT, author Microsoft, version 1.0.0 and package @azure/keyvault-secrets. It declares no allowed-tools.

### Not established by this review

 - No secret was set, read, deleted, purged, recovered or backed up.
- No npm package was added to a project.
- Neither the azure-sdk-typescript plugin nor azure-keyvault-secrets-ts was installed, and its reference files were not read.
- Not executed: it was not installed or run.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Add a skill to your workflow.

[Upstream setup instructions ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-typescript/README.md)
 - The azure-sdk-typescript plugin README prints `npx skills add microsoft/skills --skill azure-sdk-typescript` under Install. It installs the whole azure-sdk-typescript plugin, whose skill table lists azure-keyvault-secrets-ts; it does not install that skill alone.
- The same README prints `/plugin install azure-sdk-typescript@skills`, which also brings in azure-keyvault-secrets-ts together with every other skill in the plugin. The repository README runs plugin commands inside Copilot CLI after `/plugin marketplace add microsoft/skills`.

### Before you start

 - The skill prints `npm install @azure/keyvault-secrets @azure/identity`; the key and cryptography samples also need @azure/keyvault-keys, which that line leaves out. This review installed nothing.
- A Key Vault given by KEY_VAULT_URL or AZURE_KEYVAULT_NAME, and AZURE_TOKEN_CREDENTIALS for the DefaultAzureCredential sample.
- Node.js, since practice 6 says the SDKs do not run in a browser.
- Copilot CLI, where `/plugin install azure-sdk-typescript@skills` adds this secrets skill with the rest of the plugin.

### Compatibility

Copilot CLI · GitHub Copilot in VS Code

### Implementation

TypeScript

### Reference text; Key Vault secret and key changes happen only in code an operator runs

 - No allowed-tools are declared. The directory holds SKILL.md and two Markdown reference files, and no scripts.
- The samples sign in with DefaultAzureCredential and address the vault as https://${process.env.AZURE_KEYVAULT_NAME}.vault.azure.net.
- Run as written, they write, read, soft-delete, purge and recover secrets, and create, rotate and purge keys in that vault.
- One sample writes a secret value to the console; backup samples hand the secret and key backups to the calling code.

### Cost model

Free to copy under MIT. The file names no price for the Key Vault secret and key calls in its samples, and this review looked none up.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [azure-keyvault-secrets-ts SKILL.md at the pin ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-typescript/skills/azure-keyvault-secrets-ts/SKILL.md) Checked 2026-10-21 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-typescript/skills/azure-keyvault-secrets-ts/SKILL.md Supports: name, upstreamDescription, summary, whySelected, bestFor, limitations, review.findings, install.prerequisites, access.permissions
- [azure-sdk-typescript plugin README ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-typescript/README.md) Checked 2026-10-21 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-typescript/README.md Supports: install.sourceUrl, install.steps, limitations (install scope)
- [azure-sdk-typescript plugin.json ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-typescript/.claude-plugin/plugin.json) Checked 2026-10-21 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-typescript/.claude-plugin/plugin.json Supports: publisher, license (plugin licence field)
- [Repository README ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md) Checked 2026-10-21 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md Supports: compatibility, install.steps (Copilot CLI plugin commands)
- [Repository LICENSE ↗](https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE) Checked 2026-10-21 https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE Supports: license
- [Commit ee33ce9d, the last change to azure-keyvault-secrets-ts at the pin ↗](https://github.com/microsoft/skills/commit/ee33ce9d2b4372b0cfe58375bebbf0bd989e3ac9) Checked 2026-10-21 https://github.com/microsoft/skills/commit/ee33ce9d2b4372b0cfe58375bebbf0bd989e3ac9 Supports: limitations (last commit date)

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Azure Key Vault Keys SDK for TypeScript ↗ Microsoft's TypeScript guide to @azure/keyvault-keys for creating, rotating and deleting Key Vault keys and for encrypt, sign and wrap operations through CryptographyClient; the same file also carries secret operations.](/skills/microsoft-azure-keyvault-keys-ts/)[### Azure Key Vault Secrets library for Rust ↗ Microsoft's Rust guide to azure_security_keyvault_secrets: setting, reading, tagging, deleting and listing Key Vault secrets, with a structured error for a missing secret.](/skills/microsoft-azure-keyvault-secrets-rust/)[### Azure Key Vault Certificates library for Rust ↗ Microsoft's Rust guide to azure_security_keyvault_certificates: creating a self-signed X.509 certificate as a long-running operation, updating, listing and deleting certificates, and signing with a certificate's key through the Key Vault keys crate.](/skills/microsoft-azure-keyvault-certificates-rust/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
