SDK de Identidade do Azure para Rust

Biblioteca de autenticação para clientes do SDK do Azure usando o Microsoft Entra ID (anteriormente Azure AD).

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_identity@=1.0.0 azure_core@=1.1.0

Variáveis de Ambiente

# Service Principal (for production/CI)
export AZURE_TENANT_ID="<your-tenant-id>"
export AZURE_CLIENT_ID="<your-client-id>"
: "${AZURE_CLIENT_SECRET:?Inject through the approved host or CI secret manager}"
export AZURE_CLIENT_SECRET

# User-assigned Managed Identity (optional)
export AZURE_CLIENT_ID="<managed-identity-client-id>"

DeveloperToolsCredential

A credencial recomendada para desenvolvimento local. Tenta as ferramentas de desenvolvedor na ordem (Azure CLI, Azure Developer CLI):

use azure_identity::DeveloperToolsCredential;
use azure_security_keyvault_secrets::SecretClient;

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

Ordem da Cadeia de Credenciais

Tipos de Credenciais

ManagedIdentityCredential

Para recursos hospedados no Azure:

use azure_identity::{ManagedIdentityCredential, ManagedIdentityCredentialOptions, UserAssignedId};

// System-assigned managed identity
let credential = ManagedIdentityCredential::new(None)?;

// User-assigned managed identity
let options = ManagedIdentityCredentialOptions {
    user_assigned_id: Some(UserAssignedId::ClientId("<user-assigned-mi-client-id>".into())),
    ..Default::default()
};
let credential = ManagedIdentityCredential::new(Some(options))?;

ClientSecretCredential

Para principal de serviço com segredo:

use azure_identity::ClientSecretCredential;

let credential = ClientSecretCredential::new(
    "<tenant-id>".into(),
    "<client-id>".into(),
    "<client-secret>".into(),
    None,
)?;

Melhores Práticas

1. Use DeveloperToolsCredential para desenvolvimento local — captura automaticamente o Azure CLI
2. Use ManagedIdentityCredential em produção — sem segredos para gerenciar
3. Clone credenciais — credenciais são encapsuladas em Arc e baratas para clonar
4. Reutilize instâncias de credenciais — a mesma credencial pode ser usada com vários clientes
5. Forneça o runtime assíncrono — adicione Tokio com os recursos necessários para sua aplicação; não assuma que um recurso tokio específico da crate exista

O conjunto de exemplos revisado usa azure_identity 1.0.0 e crates de núcleo/credenciais do Azure compatíveis. Grave 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 ao escolher ou configurar credenciais do Entra ID para clientes do SDK do Azure em Rust: ferramentas de desenvolvedor local, identidade gerenciada/de carga de trabalho ou um principal de serviço revisado.

Limitações

• Os exemplos são fragmentos dentro do código de aplicação assíncrono, com crates do Azure fixadas 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 contra a origem/referência oficial, não compilados ou executados contra uma conta de nuvem aqui.

…