Skip to content

Migration guide: azure_identity (from azure_identity ≤0.21.0 / azure_sdk_auth_aad) #4231

@ronniegeraghty

Description

@ronniegeraghty

Part of #4228

Migration guide: azure_identity

Official Crate

  • Name: azure_identity
  • Current version: 0.34.0
  • Service: Microsoft Entra ID (Azure AD) authentication

Unofficial Predecessor(s)

Predecessor Version(s) Relationship crates.io
azure_identity v0.1.0–0.21.0 Era 2 (Jan 2022 – Oct 2024) Same-crate older version — major redesign at v0.22.0 (Feb 2025) crates.io
azure_sdk_auth_aad v0.47.0 Era 1 (MindFlavor, 2017–2019) Different crate — community-era Azure AD auth, 31K downloads crates.io

Migration Guide Should Cover

  • Unified ManagedIdentityCredential (replaces separate system/user-assigned flows)
  • UserAssignedId enum: ClientId, ObjectId, ResourceId variants
  • New AzurePipelinesCredential for Azure DevOps pipelines
  • New AzureDeveloperCliCredential for azd CLI
  • DefaultAzureCredential redesign and configuration
  • Auto-retry and IMDS compliance improvements
  • Entra ID terminology (not "Azure AD") in code/docs
  • Migration path for azure_sdk_auth_aad users (start from scratch)

Acceptance Criteria

  • Migration guide published in repo docs (e.g., docs/migration/azure_identity.md)
  • Code samples for key scenarios: DefaultAzureCredential setup, managed identity (system + user-assigned), service principal, developer CLI credentials
  • FAQ section covering common migration pitfalls
  • Linked from the azure_identity crate README
  • Reviewed by SDK team

Metadata

Metadata

Assignees

No one assigned

    Labels

    Azure.IdentityThe azure_identity crateDocsrustPull requests that update Rust code

    Type

    No type

    Projects

    Status

    Untriaged

    Status

    Untriaged

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions