SDK do Azure Key Vault Keys para Rust

Biblioteca cliente para Chaves do Azure Key Vault — armazenamento e gerenciamento seguros de chaves criptográficas.

Os exemplos abaixo exigem um conjunto de crates compatíveis revisado e a substituição de cada espaço reservado de recurso. Não use dados de produção para gravações de demonstração.

Instalação

cargo add azure_security_keyvault_keys@=1.0.1 azure_identity@=1.0.0 azure_core@=1.1.0

Variáveis de Ambiente

export AZURE_KEYVAULT_URL="https://<vault-name>.vault.azure.net/"

Autenticação

use azure_identity::DeveloperToolsCredential;
use azure_security_keyvault_keys::KeyClient;

let credential = DeveloperToolsCredential::new(None)?;
let client = KeyClient::new(
    "https://<vault-name>.vault.azure.net/",
    credential.clone(),
    None,
)?;

Tipos de Chave

Operações Principais

Obter Chave

let key = client
    .get_key("key-name", None)
    .await?
    .into_model()?;

println!("Key ID: {:?}", key.key.as_ref().map(|k| &k.kid));

Criar Chave

use azure_security_keyvault_keys::models::{CreateKeyParameters, KeyType};

let params = CreateKeyParameters {
    kty: Some(KeyType::Rsa),
    key_size: Some(2048),
    ..Default::default()
};

let key = client
    .create_key("key-name", params.try_into()?, None)
    .await?
    .into_model()?;

Criar Chave EC

use azure_security_keyvault_keys::models::{CreateKeyParameters, KeyType, CurveName};

let params = CreateKeyParameters {
    kty: Some(KeyType::Ec),
    curve: Some(CurveName::P256),
    ..Default::default()
};

let key = client
    .create_key("ec-key", params.try_into()?, None)
    .await?
    .into_model()?;

Excluir Chave

client.delete_key("key-name", None).await?;

Listar Chaves

use azure_security_keyvault_keys::ResourceExt;
use futures::TryStreamExt;

let mut pager = client.list_key_properties(None)?;
while let Some(key) = pager.try_next().await? {
    let name = key.resource_id()?.name;
    println!("Key: {}", name);
}

Backup de Chave

let backup = client.backup_key("key-name", None).await?;
// Store backup.value safely

Restaurar Chave

use azure_security_keyvault_keys::models::RestoreKeyParameters;

let params = RestoreKeyParameters {
    key_bundle_backup: backup_bytes,
};

client.restore_key(params.try_into()?, None).await?;

Operações Criptográficas

O Key Vault pode realizar operações criptográficas sem expor a chave privada:

// For cryptographic operations, use the key's operations
// Available operations depend on key type and permissions:
// - encrypt/decrypt (RSA)
// - sign/verify (RSA, EC)
// - wrapKey/unwrapKey (RSA)

Melhores Práticas

1. Use autenticação do Entra ID — DeveloperToolsCredential para desenvolvimento, ManagedIdentityCredential para produção
2. Use chaves HSM para cargas de trabalho sensíveis — chaves protegidas por hardware
3. Use EC para assinatura — mais eficiente que RSA
4. Use criptografia de envelope — RSA pode encapsular uma chave de dados simétrica; não criptografe dados em massa arbitrários diretamente com RSA
5. Faça backup de chaves — para recuperação de desastres
6. Habilite a exclusão reversível — exigido para cofres de produção
7. Use rotação de chaves — crie novas versões periodicamente

Permissões RBAC

Atribua estas funções do Key Vault:

• Key Vault Crypto User — use chaves para operações criptográficas
• Key Vault Crypto Officer — CRUD completo em chaves

O conjunto de exemplos revisado usa azure_security_keyvault_keys 1.0.1 e crates compatíveis do Azure core/credential. Registre e confirme o Cargo.lock; a revisão de código-fonte/API não é um teste de compilador ou de serviço ativo.

Links de Referência

Quando Usar

Use quando um aplicativo Rust recupera metadados de chave pública ou realiza criação, versionamento, backup, restauração ou operações criptográficas autorizadas do Key Vault.

Limitações

…