SDK do Azure Key Vault Secrets para Rust

Biblioteca cliente para Azure Key Vault Secrets — armazenamento seguro para senhas, chaves de API e outros segredos.

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_secrets@=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_secrets::SecretClient;

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

Operações Principais

Obter Segredo

let secret = client
    .get_secret("secret-name", None)
    .await?
    .into_model()?;

let secret_value = secret.value.ok_or("Secret has no value")?;
// Pass directly to the authorized consumer; never print the value.

Definir Segredo

use azure_security_keyvault_secrets::models::SetSecretParameters;

let params = SetSecretParameters {
    value: Some("secret-value".into()),
    ..Default::default()
};

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

Atualizar Propriedades do Segredo

use azure_security_keyvault_secrets::models::UpdateSecretPropertiesParameters;
use std::collections::HashMap;

let params = UpdateSecretPropertiesParameters {
    content_type: Some("text/plain".into()),
    tags: Some(HashMap::from([("env".into(), "prod".into())])),
    ..Default::default()
};

client
    .update_secret_properties("secret-name", params.try_into()?, None)
    .await?;

Excluir Segredo

client.delete_secret("secret-name", None).await?;

Listar Segredos

use azure_security_keyvault_secrets::ResourceExt;
use futures::TryStreamExt;

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

Obter Versão Específica

use azure_security_keyvault_secrets::models::SecretClientGetSecretOptions;

let options = SecretClientGetSecretOptions {
    secret_version: Some("version-id".into()),
    ..Default::default()
};

let secret = client
    .get_secret("secret-name", Some(options))
    .await?
    .into_model()?;

Melhores Práticas

1. Use autenticação Entra ID — DeveloperToolsCredential para desenvolvimento, ManagedIdentityCredential para produção
2. Use into_model()? — para desserializar respostas
3. Use o trait ResourceExt — para extrair nomes de IDs
4. Lide com exclusão lógica — segredos excluídos podem ser recuperados dentro do período de retenção
5. Defina o tipo de conteúdo — ajuda a identificar o formato do segredo
6. Use tags — para organizar e filtrar segredos
7. Versionar segredos — novos valores criam novas versões automaticamente

Permissões RBAC

Atribua estas funções do Key Vault:

• Key Vault Secrets User — obter e listar
• Key Vault Secrets Officer — CRUD completo

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

Links de Referência

Quando Usar

Use quando um aplicativo Rust recupera um segredo/versão especificado ou executa criação de segredo autorizada, atualizações de metadados, listagem ou exclusão em um Key Vault identificado.

Limitações

• Os exemplos são fragmentos dentro do código de aplicativo assíncrono, com crates do Azure fixados compatíveis e as dependências necessárias de Tokio/Serde/Futures; verifique a API da versão selecionada antes de usar. Eles foram revisados em relação à origem/referência oficial, não compilados ou executados em uma conta de nuvem aqui.

…