Skill v1.0.1
currentAutomated scan100/100+4 new
version: "1.0.1" name: azure-keyvault-py description: Azure Key Vault SDK for Python. Use for secrets, keys, and certificates management with secure storage. risk: critical source: community date_added: '2026-02-27'
Azure Key Vault SDK for Python
Secure storage and management for secrets, cryptographic keys, and certificates.
Installation
# Secretspip install azure-keyvault-secrets azure-identity# Keys (cryptographic operations)pip install azure-keyvault-keys azure-identity# Certificatespip install azure-keyvault-certificates azure-identity# Allpip install azure-keyvault-secrets azure-keyvault-keys azure-keyvault-certificates azure-identity
Environment Variables
AZURE_KEYVAULT_URL=https://<vault-name>.vault.azure.net/
Mutation and recovery boundary
Confirm exact vault/object/version and approved effects before writes, deletes or purge. Independent snippets reuse client names; recovery and purge are alternatives, not sequential cleanup steps. Purge can be irreversible and subject to purge protection; certificate secret export can disclose a private key. Use least privilege, protected outputs and a verified dependency/recovery plan.
Secrets
SecretClient Setup
from azure.identity import DefaultAzureCredentialfrom azure.keyvault.secrets import SecretClientcredential = DefaultAzureCredential()vault_url = "https://<vault-name>.vault.azure.net/"client = SecretClient(vault_url=vault_url, credential=credential)
Secret Operations
# Set secretsecret = client.set_secret("database-password", "super-secret-value")print(f"Created: {secret.name}, version: {secret.properties.version}")# Get secretsecret = client.get_secret("database-password")print(f"Retrieved secret: {secret.name}") # Never print secret values.# Get specific versionsecret = client.get_secret("database-password", version="abc123")# List secrets (names only, not values)for secret_properties in client.list_properties_of_secrets():print(f"Secret: {secret_properties.name}")# List versionsfor version in client.list_properties_of_secret_versions("database-password"):print(f"Version: {version.version}, Created: {version.created_on}")# Delete secret (soft delete)poller = client.begin_delete_secret("database-password")deleted_secret = poller.result()# Purge (permanent delete, if soft-delete enabled)client.purge_deleted_secret("database-password")# Recover deleted secretclient.begin_recover_deleted_secret("database-password").result()
Keys
KeyClient Setup
from azure.identity import DefaultAzureCredentialfrom azure.keyvault.keys import KeyClientcredential = DefaultAzureCredential()vault_url = "https://<vault-name>.vault.azure.net/"client = KeyClient(vault_url=vault_url, credential=credential)
Key Operations
from azure.keyvault.keys import KeyType# Create RSA keyrsa_key = client.create_rsa_key("rsa-key", size=2048)# Create EC keyec_key = client.create_ec_key("ec-key", curve="P-256")# Get keykey = client.get_key("rsa-key")print(f"Key type: {key.key_type}")# List keysfor key_properties in client.list_properties_of_keys():print(f"Key: {key_properties.name}")# Delete keypoller = client.begin_delete_key("rsa-key")deleted_key = poller.result()
Cryptographic Operations
from azure.keyvault.keys.crypto import CryptographyClient, EncryptionAlgorithm# Get crypto client for a specific keycrypto_client = CryptographyClient(key, credential=credential)# Or from key IDcrypto_client = CryptographyClient("https://<vault>.vault.azure.net/keys/<key-name>/<version>",credential=credential)# Encryptplaintext = b"Hello, Key Vault!"result = crypto_client.encrypt(EncryptionAlgorithm.rsa_oaep, plaintext)ciphertext = result.ciphertext# Decryptresult = crypto_client.decrypt(EncryptionAlgorithm.rsa_oaep, ciphertext)decrypted = result.plaintext# Signfrom azure.keyvault.keys.crypto import SignatureAlgorithmimport hashlibdigest = hashlib.sha256(b"data to sign").digest()result = crypto_client.sign(SignatureAlgorithm.rs256, digest)signature = result.signature# Verifyresult = crypto_client.verify(SignatureAlgorithm.rs256, digest, signature)print(f"Valid: {result.is_valid}")
Certificates
CertificateClient Setup
from azure.identity import DefaultAzureCredentialfrom azure.keyvault.certificates import CertificateClient, CertificatePolicycredential = DefaultAzureCredential()vault_url = "https://<vault-name>.vault.azure.net/"client = CertificateClient(vault_url=vault_url, credential=credential)
Certificate Operations
# Create self-signed certificatepolicy = CertificatePolicy.get_default()poller = client.begin_create_certificate("my-cert", policy=policy)certificate = poller.result()# Get certificatecertificate = client.get_certificate("my-cert")print(f"Thumbprint: {certificate.properties.x509_thumbprint.hex()}")# Get certificate with private key (as secret)from azure.keyvault.secrets import SecretClientsecret_client = SecretClient(vault_url=vault_url, credential=credential)cert_secret = secret_client.get_secret("my-cert")# cert_secret.value contains PEM or PKCS12# List certificatesfor cert in client.list_properties_of_certificates():print(f"Certificate: {cert.name}")# Delete certificatepoller = client.begin_delete_certificate("my-cert")deleted = poller.result()
Client Types Table
| Client | Package | Purpose | |
|---|---|---|---|
SecretClient | azure-keyvault-secrets | Store/retrieve secrets | |
KeyClient | azure-keyvault-keys | Manage cryptographic keys | |
CryptographyClient | azure-keyvault-keys | Encrypt/decrypt/sign/verify | |
CertificateClient | azure-keyvault-certificates | Manage certificates |
Async Clients
from azure.identity.aio import DefaultAzureCredentialfrom azure.keyvault.secrets.aio import SecretClientasync def get_secret():credential = DefaultAzureCredential()client = SecretClient(vault_url=vault_url, credential=credential)async with client:secret = await client.get_secret("my-secret")# Consume the value only in the authorized application; do not print it.import asyncioasyncio.run(get_secret())
Error Handling
from azure.core.exceptions import ResourceNotFoundError, HttpResponseErrortry:secret = client.get_secret("nonexistent")except ResourceNotFoundError:print("Secret not found")except HttpResponseError as e:if e.status_code == 403:print("Access denied - check RBAC permissions")raise
Best Practices
- Use DefaultAzureCredential for authentication
- Use managed identity in Azure-hosted applications
- Enable soft-delete for recovery (enabled by default)
- Use RBAC over access policies for fine-grained control
- Rotate secrets regularly using versioning
- Use Key Vault references in App Service/Functions config
- Cache secrets appropriately to reduce API calls
- Use async clients for high-throughput scenarios
When to Use
This skill is applicable to execute the workflow or actions described in the overview.
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.