Skill v1.0.1
currentAutomated scan100/100+4 new
version: "1.0.1" name: azure-identity-py description: Azure Identity SDK for Python authentication. Use for DefaultAzureCredential, managed identity, service principals, and token caching. risk: critical source: community date_added: '2026-02-27'
Azure Identity SDK for Python
Authentication library for Azure SDK clients using Microsoft Entra ID (formerly Azure AD).
Installation
pip install azure-identity
Environment Variables
# Service Principal (for production/CI)AZURE_TENANT_ID=<your-tenant-id>AZURE_CLIENT_ID=<your-client-id>AZURE_CLIENT_SECRET=<your-client-secret># User-assigned Managed Identity (optional)AZURE_CLIENT_ID=<managed-identity-client-id>
DefaultAzureCredential
Useful for development and flexible environments. Production should select an explicit intended credential (such as workload/managed identity) rather than unexpectedly falling back to another account. The chain below is illustrative and version/configuration-dependent:
from azure.identity import DefaultAzureCredentialfrom azure.storage.blob import BlobServiceClient# Works in local dev AND production without code changescredential = DefaultAzureCredential()client = BlobServiceClient(account_url="https://<account>.blob.core.windows.net",credential=credential)
Credential Chain Order
| Order | Credential | Environment | |
|---|---|---|---|
| 1 | EnvironmentCredential | CI/CD, containers | |
| 2 | WorkloadIdentityCredential | Kubernetes | |
| 3 | ManagedIdentityCredential | Azure VMs, App Service, Functions | |
| 4 | SharedTokenCacheCredential | Windows only | |
| 5 | VisualStudioCodeCredential | VS Code with Azure extension | |
| 6 | AzureCliCredential | az login | |
| 7 | AzurePowerShellCredential | Connect-AzAccount | |
| 8 | AzureDeveloperCliCredential | azd auth login |
Customizing DefaultAzureCredential
# Exclude credentials you don't needcredential = DefaultAzureCredential(exclude_environment_credential=True,exclude_shared_token_cache_credential=True,managed_identity_client_id="<user-assigned-mi-client-id>" # For user-assigned MI)# Enable interactive browser (disabled by default)credential = DefaultAzureCredential(exclude_interactive_browser_credential=False)
Before token acquisition, verify tenant, client/principal, cloud and required audience/scope without printing tokens. Avoid secrets in dotenv examples committed to a repo or pasted into shell history; prefer managed/workload identity where supported. Close credentials/clients in failure paths. Review the current credential-chain guidance for the selected package, including optional broker/developer credentials.
Specific Credential Types
ManagedIdentityCredential
For Azure-hosted resources (VMs, App Service, Functions, AKS):
from azure.identity import ManagedIdentityCredential# System-assigned managed identitycredential = ManagedIdentityCredential()# User-assigned managed identitycredential = ManagedIdentityCredential(client_id="<user-assigned-mi-client-id>")
ClientSecretCredential
For service principal with secret:
import osfrom azure.identity import ClientSecretCredentialcredential = ClientSecretCredential(tenant_id=os.environ["AZURE_TENANT_ID"],client_id=os.environ["AZURE_CLIENT_ID"],client_secret=os.environ["AZURE_CLIENT_SECRET"])
AzureCliCredential
Uses the account from az login:
from azure.identity import AzureCliCredentialcredential = AzureCliCredential()
ChainedTokenCredential
Custom credential chain:
from azure.identity import (ChainedTokenCredential,ManagedIdentityCredential,AzureCliCredential)# Try managed identity first, fall back to CLIcredential = ChainedTokenCredential(ManagedIdentityCredential(client_id="<user-assigned-mi-client-id>"),AzureCliCredential())
Credential Types Table
| Credential | Use Case | Auth Method | |
|---|---|---|---|
DefaultAzureCredential | Most scenarios | Auto-detect | |
ManagedIdentityCredential | Azure-hosted apps | Managed Identity | |
ClientSecretCredential | Service principal | Client secret | |
ClientCertificateCredential | Service principal | Certificate | |
AzureCliCredential | Local development | Azure CLI | |
AzureDeveloperCliCredential | Local development | Azure Developer CLI | |
InteractiveBrowserCredential | User sign-in | Browser OAuth | |
DeviceCodeCredential | Headless/SSH | Device code flow |
Getting Tokens Directly
from azure.identity import DefaultAzureCredentialcredential = DefaultAzureCredential()# Get token for a specific scopetoken = credential.get_token("https://management.azure.com/.default")print(f"Token expires: {token.expires_on}")# For Azure Database for PostgreSQLtoken = credential.get_token("https://ossrdbms-aad.database.windows.net/.default")
Async Client
from azure.identity.aio import DefaultAzureCredentialfrom azure.storage.blob.aio import BlobServiceClientasync def main():credential = DefaultAzureCredential()async with BlobServiceClient(account_url="https://<account>.blob.core.windows.net",credential=credential) as client:# ... async operationspassawait credential.close()
Best Practices
- Use DefaultAzureCredential for code that runs locally and in Azure
- Never hardcode credentials — use environment variables or managed identity
- Prefer managed identity in production Azure deployments
- Use ChainedTokenCredential when you need a custom credential order
- Close async credentials explicitly or use context managers
- Set AZURE_CLIENT_ID for user-assigned managed identities
- Exclude unused credentials to speed up authentication
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.