[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M73ESXQBWP15DGRV97GJRS51":3,"skill-same:01M73ESXQBWP15DGRV97GJRS51":51},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":29,"commitSha":30,"skillDirectory":31,"forksCount":32,"repositoryHtmlUrl":33,"repositoryHomepageUrl":6,"ownerHtmlUrl":34,"ownerBlogUrl":35,"ownerDescription":6,"updatedAt":36,"install":37,"resources":50},"01M73ESXQBWP15DGRV97GJRS51","azure-identity-py",null,"Azure Identity SDK for Python authentication with Microsoft Entra ID. Use for DefaultAzureCredential, managed identity, service principals, and token caching.\nTriggers: \"azure-identity\", \"DefaultAzureCredential\", \"authentication\", \"managed identity\", \"service principal\", \"credential\".","qhjqhj00\u002Fresearch-skills-pool","qhjqhj00","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F29684092?v=4","01M72AE0ZGXVM5C57N512DGQG8","Tommy Chien","01M72AE107ESJMHT7QC5SXX144",3,"MIT","https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool\u002Fblob\u002Fmaster\u002Fskills_collected\u002Fmicrosoft--skills--.github__plugins__azure-sdk-python__skills__azure-identity-py\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: azure-identity-py\ndescription: |\n  Azure Identity SDK for Python authentication with Microsoft Entra ID. Use for DefaultAzureCredential, managed identity, service principals, and token caching.\n  Triggers: \"azure-identity\", \"DefaultAzureCredential\", \"authentication\", \"managed identity\", \"service principal\", \"credential\".\nlicense: MIT\nmetadata:\n  author: Microsoft\n  version: \"1.0.0\"\n  package: azure-identity\n---\n\n# Azure Identity library for Python\n\nAuthentication library for Azure SDK clients using Microsoft Entra ID.\n\nUse this skill when:\n- An app needs to authenticate to Azure services from Python\n- You need `DefaultAzureCredential` for local dev + Azure deployment\n- You need `ManagedIdentityCredential` for Azure-hosted workloads\n- You need service principal auth with secret or certificate\n- You need direct token acquisition with `get_token()`\n- You need to troubleshoot credential chain failures\n\n## Installation\n\n```bash\npip install azure-identity\n```\n\nFor VS Code or broker-based desktop auth:\n\n```bash\npip install azure-identity-broker\n```\n\n## Python Version\n\n`azure-identity` supports Python 3.9+.\n\n## Environment Variables\n\n```bash\n# Service principal with client secret\nAZURE_TENANT_ID=\u003Cyour-tenant-id>\nAZURE_CLIENT_ID=\u003Cyour-client-id>\nAZURE_CLIENT_SECRET=\u003Cyour-client-secret>\n\n# Service principal with certificate\nAZURE_TENANT_ID=\u003Cyour-tenant-id>\nAZURE_CLIENT_ID=\u003Cyour-client-id>\nAZURE_CLIENT_CERTIFICATE_PATH=\u002Fpath\u002Fto\u002Fcert.pem\nAZURE_CLIENT_CERTIFICATE_PASSWORD=\u003Coptional-password>\n\n# Authority (sovereign clouds)\nAZURE_AUTHORITY_HOST=login.microsoftonline.com  # Default; or login.chinacloudapi.cn, login.microsoftonline.us\n\n# User-assigned managed identity\nAZURE_CLIENT_ID=\u003Cmanaged-identity-client-id>\n\n# Credential selection (new)\nAZURE_TOKEN_CREDENTIALS=dev|prod|\u003Ccredential-name>  # Optional, restricts DAC chain\n```\n\n## DefaultAzureCredential\n\nThe recommended credential for most scenarios. Tries multiple authentication methods in order:\n\n```python\nfrom azure.identity import DefaultAzureCredential\nfrom azure.storage.blob import BlobServiceClient\n\n# Works in local dev AND production without code changes\ncredential = DefaultAzureCredential()\n\nclient = BlobServiceClient(\n    account_url=\"https:\u002F\u002F\u003Caccount>.blob.core.windows.net\",\n    credential=credential\n)\n```\n\n### Credential Chain Order\n\nSee [DefaultAzureCredential overview](https:\u002F\u002Faka.ms\u002Fazsdk\u002Fpython\u002Fidentity\u002Fcredential-chains#defaultazurecredential-overview) for the current credential chain order and defaults.\n\n### Customizing DefaultAzureCredential\n\n```python\n# Exclude credentials you don't need\ncredential = DefaultAzureCredential(\n    exclude_environment_credential=True,\n    exclude_shared_token_cache_credential=True,\n    managed_identity_client_id=\"\u003Cuser-assigned-mi-client-id>\"  # For user-assigned MI (also accepts object ID or resource ID)\n)\n\n# Enable interactive browser (disabled by default)\ncredential = DefaultAzureCredential(\n    exclude_interactive_browser_credential=False\n)\n\n# Set subprocess timeout for CLI-based credentials (default: 10s)\ncredential = DefaultAzureCredential(process_timeout=30)\n\n# Require AZURE_TOKEN_CREDENTIALS env var to be set\ncredential = DefaultAzureCredential(require_envvar=True)\n```\n\n### Exclude Parameters\n\n| Parameter | Default | Effect |\n|-----------|---------|--------|\n| `exclude_environment_credential` | False | Skip env-var-based auth |\n| `exclude_workload_identity_credential` | False | Skip Kubernetes workload identity |\n| `exclude_managed_identity_credential` | False | Skip managed identity |\n| `exclude_shared_token_cache_credential` | False | Skip shared token cache |\n| `exclude_visual_studio_code_credential` | False | Skip VS Code credential |\n| `exclude_cli_credential` | False | Skip Azure CLI |\n| `exclude_powershell_credential` | False | Skip Azure PowerShell |\n| `exclude_developer_cli_credential` | False | Skip Azure Developer CLI |\n| `exclude_interactive_browser_credential` | **True** | Skip interactive browser |\n| `exclude_broker_credential` | False | Skip WAM broker |\n\n## get_bearer_token_provider\n\nHelper that wraps a credential into a callable returning a bearer token string. Essential for OpenAI SDK and other non-Azure-SDK clients:\n\n```python\nfrom azure.identity import DefaultAzureCredential, get_bearer_token_provider\n\ncredential = DefaultAzureCredential()\ntoken_provider = get_bearer_token_provider(\n    credential, \"https:\u002F\u002Fcognitiveservices.azure.com\u002F.default\"\n)\n\n# Use with OpenAI SDK\nfrom openai import AzureOpenAI\n\nclient = AzureOpenAI(\n    azure_endpoint=\"https:\u002F\u002F\u003Cresource>.openai.azure.com\u002F\",\n    azure_ad_token_provider=token_provider,\n    api_version=\"2024-10-21\",\n)\n```\n\n## Credential Types\n\n### Credential Chains\n\n| Credential | Use Case |\n|------------|----------|\n| `DefaultAzureCredential` | Most scenarios — auto-detects environment |\n| `ChainedTokenCredential` | Custom credential chain with explicit ordering |\n\n### Azure-Hosted Applications\n\n| Credential | Use Case |\n|------------|----------|\n| `EnvironmentCredential` | Auth via AZURE_CLIENT_SECRET \u002F AZURE_CLIENT_CERTIFICATE_PATH env vars |\n| `ManagedIdentityCredential` | Azure VMs, App Service, Functions, AKS, Arc, Service Fabric |\n| `WorkloadIdentityCredential` | Kubernetes with Microsoft Entra Workload ID |\n\n### Service Principals\n\n| Credential | Use Case |\n|------------|----------|\n| `ClientSecretCredential` | Service principal with client secret |\n| `CertificateCredential` | Service principal with PEM\u002FPKCS12 certificate |\n| `ClientAssertionCredential` | Service principal with signed JWT assertion |\n| `AzurePipelinesCredential` | Azure Pipelines with workload identity federation |\n| `OnBehalfOfCredential` | Middle-tier on-behalf-of flow (delegated user identity) |\n\n### User Authentication\n\n| Credential | Use Case |\n|------------|----------|\n| `InteractiveBrowserCredential` | Interactive browser OAuth sign-in |\n| `DeviceCodeCredential` | Headless\u002FSSH device code flow |\n| `AuthorizationCodeCredential` | Previously obtained authorization code |\n\n### Developer Tools\n\n| Credential | Use Case |\n|------------|----------|\n| `AzureCliCredential` | `az login` |\n| `AzureDeveloperCliCredential` | `azd auth login` |\n| `AzurePowerShellCredential` | `Connect-AzAccount` |\n| `VisualStudioCodeCredential` | VS Code Azure Resources extension |\n\n## Specific Credential Examples\n\n### ManagedIdentityCredential\n\nFor Azure-hosted resources (VMs, App Service, Functions, AKS):\n\n```python\nfrom azure.identity import ManagedIdentityCredential\n\n# System-assigned managed identity\ncredential = ManagedIdentityCredential()\n\n# User-assigned managed identity (client_id, object_id, or resource_id)\ncredential = ManagedIdentityCredential(\n    client_id=\"\u003Cuser-assigned-mi-client-id>\"\n)\n# Also valid:\n# credential = ManagedIdentityCredential(object_id=\"\u003Cobject-id>\")\n# credential = ManagedIdentityCredential(resource_id=\"\u003Cresource-id>\")\n```\n\n### ClientSecretCredential\n\n```python\nimport os\nfrom azure.identity import ClientSecretCredential\n\ncredential = ClientSecretCredential(\n    tenant_id=os.environ[\"AZURE_TENANT_ID\"],\n    client_id=os.environ[\"AZURE_CLIENT_ID\"],\n    client_secret=os.environ[\"AZURE_CLIENT_SECRET\"],\n)\n```\n\n### CertificateCredential\n\n> **Note:** The class is `CertificateCredential`, NOT `ClientCertificateCredential`.\n\n```python\nfrom azure.identity import CertificateCredential\n\n# From file path\ncredential = CertificateCredential(\n    tenant_id=\"\u003Ctenant-id>\",\n    client_id=\"\u003Cclient-id>\",\n    certificate_path=\"\u002Fpath\u002Fto\u002Fcert.pem\",\n)\n\n# From bytes with password\ncredential = CertificateCredential(\n    tenant_id=\"\u003Ctenant-id>\",\n    client_id=\"\u003Cclient-id>\",\n    certificate_data=cert_bytes,\n    password=\"\u003Ccert-password>\",\n    send_certificate_chain=True,  # Required for SNI auth\n)\n```\n\n### AzureCliCredential\n\n```python\nfrom azure.identity import AzureCliCredential\n\ncredential = AzureCliCredential()\n# With tenant restriction\ncredential = AzureCliCredential(tenant_id=\"\u003Ctenant-id>\")\n```\n\n### ChainedTokenCredential\n\nCustom credential chain:\n\n```python\nfrom azure.identity import (\n    ChainedTokenCredential,\n    ManagedIdentityCredential,\n    AzureCliCredential,\n)\n\n# Try managed identity first, fall back to CLI\ncredential = ChainedTokenCredential(\n    ManagedIdentityCredential(client_id=\"\u003Cuser-assigned-mi-client-id>\"),\n    AzureCliCredential(),\n)\n```\n\n### WorkloadIdentityCredential\n\nFor Azure Kubernetes Service with workload identity:\n\n```python\nfrom azure.identity import WorkloadIdentityCredential\n\n# Reads from AZURE_TENANT_ID, AZURE_CLIENT_ID, AZURE_FEDERATED_TOKEN_FILE\ncredential = WorkloadIdentityCredential()\n\n# Or explicit configuration\ncredential = WorkloadIdentityCredential(\n    tenant_id=\"\u003Ctenant-id>\",\n    client_id=\"\u003Cclient-id>\",\n    token_file_path=\"\u002Fvar\u002Frun\u002Fsecrets\u002Fazure\u002Ftokens\u002Fazure-identity-token\",\n)\n```\n\n### DeviceCodeCredential\n\nFor headless devices (IoT, SSH, CLI tools):\n\n```python\nfrom azure.identity import DeviceCodeCredential\n\ncredential = DeviceCodeCredential()\n# Prints device code prompt to stdout by default\n\n# With custom prompt callback\ndef prompt_callback(verification_uri, user_code, expires_on):\n    print(f\"Go to {verification_uri} and enter code {user_code}\")\n\ncredential = DeviceCodeCredential(\n    client_id=\"\u003Cclient-id>\",\n    prompt_callback=prompt_callback,\n)\n```\n\n### InteractiveBrowserCredential\n\nFor interactive OAuth browser sign-in:\n\n```python\nfrom azure.identity import InteractiveBrowserCredential\n\ncredential = InteractiveBrowserCredential()\n\n# With specific tenant and client\ncredential = InteractiveBrowserCredential(\n    tenant_id=\"\u003Ctenant-id>\",\n    client_id=\"\u003Cclient-id>\",\n)\n```\n\n### OnBehalfOfCredential\n\nFor middle-tier services propagating user identity:\n\n```python\nfrom azure.identity import OnBehalfOfCredential\n\ncredential = OnBehalfOfCredential(\n    tenant_id=\"\u003Ctenant-id>\",\n    client_id=\"\u003Cclient-id>\",\n    client_secret=\"\u003Cclient-secret>\",\n    user_assertion=\"\u003Caccess-token-from-client>\",\n)\n```\n\n### AzurePipelinesCredential\n\nFor Azure DevOps pipelines with workload identity federation:\n\n```python\nimport os\nfrom azure.identity import AzurePipelinesCredential\n\ncredential = AzurePipelinesCredential(\n    tenant_id=\"\u003Ctenant-id>\",\n    client_id=\"\u003Cclient-id>\",\n    service_connection_id=\"\u003Cservice-connection-id>\",\n    system_access_token=os.environ[\"SYSTEM_ACCESSTOKEN\"],\n)\n```\n\n## Getting Tokens Directly\n\n```python\nfrom azure.identity import DefaultAzureCredential\n\ncredential = DefaultAzureCredential()\n\n# Get token for a specific scope\ntoken = credential.get_token(\"https:\u002F\u002Fmanagement.azure.com\u002F.default\")\nprint(f\"Token expires: {token.expires_on}\")\n\n# For Azure Database for PostgreSQL\ntoken = credential.get_token(\"https:\u002F\u002Fossrdbms-aad.database.windows.net\u002F.default\")\n```\n\n## Async Credentials\n\nAsync credentials are in `azure.identity.aio`. Always close them or use `async with`:\n\n```python\nfrom azure.identity.aio import DefaultAzureCredential\nfrom azure.storage.blob.aio import BlobServiceClient\n\nasync def main():\n    # Preferred: use async context manager for both credential and client\n    async with DefaultAzureCredential() as credential:\n        async with BlobServiceClient(\n            account_url=\"https:\u002F\u002F\u003Caccount>.blob.core.windows.net\",\n            credential=credential,\n        ) as client:\n            # ... async operations\n            pass\n```\n\n> The async `get_bearer_token_provider` is at `azure.identity.aio.get_bearer_token_provider`.\n\n## Sovereign Clouds\n\nUse `AzureAuthorityHosts` or the `AZURE_AUTHORITY_HOST` env var:\n\n```python\nfrom azure.identity import DefaultAzureCredential, AzureAuthorityHosts\n\n# Azure Government\ncredential = DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_GOVERNMENT)\n\n# Azure China\ncredential = DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_CHINA)\n```\n\n| Constant | Authority |\n|----------|-----------|\n| `AzureAuthorityHosts.AZURE_PUBLIC_CLOUD` | `login.microsoftonline.com` (default) |\n| `AzureAuthorityHosts.AZURE_GOVERNMENT` | `login.microsoftonline.us` |\n| `AzureAuthorityHosts.AZURE_CHINA` | `login.chinacloudapi.cn` |\n\n## Persistent Token Caching\n\nOpt-in disk-based caching with `TokenCachePersistenceOptions`:\n\n```python\nfrom azure.identity import DefaultAzureCredential, TokenCachePersistenceOptions\n\ncredential = DefaultAzureCredential(\n    cache_persistence_options=TokenCachePersistenceOptions()\n)\n\n# Allow unencrypted fallback (NOT recommended for production)\ncredential = DefaultAzureCredential(\n    cache_persistence_options=TokenCachePersistenceOptions(allow_unencrypted_storage=True)\n)\n```\n\nStorage: Windows (DPAPI), macOS (Keychain), Linux (Keyring).\n\n## Multi-Tenant Support\n\nAllow token acquisition for additional tenants beyond the configured one:\n\n```python\nfrom azure.identity import ClientSecretCredential\n\ncredential = ClientSecretCredential(\n    tenant_id=\"\u003Chome-tenant>\",\n    client_id=\"\u003Cclient-id>\",\n    client_secret=\"\u003Csecret>\",\n    additionally_allowed_tenants=[\"\u003Cother-tenant>\", \"*\"],  # \"*\" allows any tenant\n)\n```\n\n## Error Handling\n\n```python\nfrom azure.identity import DefaultAzureCredential, CredentialUnavailableError\nfrom azure.core.exceptions import ClientAuthenticationError\n\ncredential = DefaultAzureCredential()\ntry:\n    token = credential.get_token(\"https:\u002F\u002Fmanagement.azure.com\u002F.default\")\nexcept CredentialUnavailableError:\n    # No credential in the chain could attempt authentication\n    pass\nexcept ClientAuthenticationError as e:\n    # Authentication was attempted but failed\n    # e.message contains details from each credential in the chain\n    pass\n```\n\n## Logging\n\nEnable authentication logging for debugging:\n\n```python\nimport logging\n\n# Enable verbose Azure Identity logging\nlogging.basicConfig(level=logging.DEBUG)\nlogger = logging.getLogger(\"azure.identity\")\nlogger.setLevel(logging.DEBUG)\n```\n\n```bash\n# Or via environment variable\nAZURE_LOG_LEVEL=debug\n```\n\n## Credential Selection Matrix\n\n| Environment | Recommended Credential |\n|-------------|------------------------|\n| Local Development | `DefaultAzureCredential` (uses Azure CLI) |\n| Azure App Service | `DefaultAzureCredential` (uses Managed Identity) |\n| Azure Functions | `DefaultAzureCredential` (uses Managed Identity) |\n| Azure Kubernetes Service | `WorkloadIdentityCredential` |\n| Azure VMs | `DefaultAzureCredential` (uses Managed Identity) |\n| CI\u002FCD Pipeline | `EnvironmentCredential` or `AzurePipelinesCredential` |\n| Desktop App | `InteractiveBrowserCredential` |\n| CLI \u002F Headless Tool | `DeviceCodeCredential` |\n| Middle-tier Service | `OnBehalfOfCredential` |\n\n## Best Practices\n\n1. **Use `DefaultAzureCredential`** for code that runs locally and in Azure\n2. **Never hardcode credentials** — use environment variables or managed identity\n3. **Prefer managed identity** in production Azure deployments\n4. **Use `get_bearer_token_provider`** for non-Azure-SDK clients (OpenAI, REST APIs)\n5. **Use `ChainedTokenCredential`** when you need a custom credential order\n6. **Close async credentials** — use `async with credential:` context manager\n7. **Set `AZURE_CLIENT_ID`** for user-assigned managed identities (object ID and resource ID are also valid identifiers)\n8. **Exclude unused credentials** to speed up `DefaultAzureCredential` authentication\n9. **Use `CertificateCredential`** (not `ClientCertificateCredential` — that name doesn't exist)\n10. **Enable `cache_persistence_options`** for long-running services to reduce token requests\n11. **Reuse credential instances** — same credential can be shared across multiple clients\n\n## Reference Links\n\n| Resource | URL |\n|----------|-----|\n| PyPI Package | https:\u002F\u002Fpypi.org\u002Fproject\u002Fazure-identity\u002F |\n| API Reference | https:\u002F\u002Flearn.microsoft.com\u002Fpython\u002Fapi\u002Fazure-identity |\n| GitHub Source | https:\u002F\u002Fgithub.com\u002FAzure\u002Fazure-sdk-for-python\u002Ftree\u002Fmain\u002Fsdk\u002Fidentity\u002Fazure-identity |\n| Credential Chains | https:\u002F\u002Faka.ms\u002Fazsdk\u002Fpython\u002Fidentity\u002Fcredential-chains |\n","# Azure Identity library for Python\n\nAuthentication library for Azure SDK clients using Microsoft Entra ID.\n\nUse this skill when:\n- An app needs to authenticate to Azure services from Python\n- You need `DefaultAzureCredential` for local dev + Azure deployment\n- You need `ManagedIdentityCredential` for Azure-hosted workloads\n- You need service principal auth with secret or certificate\n- You need direct token acquisition with `get_token()`\n- You need to troubleshoot credential chain failures\n\n## Installation\n\n```bash\npip install azure-identity\n```\n\nFor VS Code or broker-based desktop auth:\n\n```bash\npip install azure-identity-broker\n```\n\n## Python Version\n\n`azure-identity` supports Python 3.9+.\n\n## Environment Variables\n\n```bash\n# Service principal with client secret\nAZURE_TENANT_ID=\u003Cyour-tenant-id>\nAZURE_CLIENT_ID=\u003Cyour-client-id>\nAZURE_CLIENT_SECRET=\u003Cyour-client-secret>\n\n# Service principal with certificate\nAZURE_TENANT_ID=\u003Cyour-tenant-id>\nAZURE_CLIENT_ID=\u003Cyour-client-id>\nAZURE_CLIENT_CERTIFICATE_PATH=\u002Fpath\u002Fto\u002Fcert.pem\nAZURE_CLIENT_CERTIFICATE_PASSWORD=\u003Coptional-password>\n\n# Authority (sovereign clouds)\nAZURE_AUTHORITY_HOST=login.microsoftonline.com  # Default; or login.chinacloudapi.cn, login.microsoftonline.us\n\n# User-assigned managed identity\nAZURE_CLIENT_ID=\u003Cmanaged-identity-client-id>\n\n# Credential selection (new)\nAZURE_TOKEN_CREDENTIALS=dev|prod|\u003Ccredential-name>  # Optional, restricts DAC chain\n```\n\n## DefaultAzureCredential\n\nThe recommended credential for most scenarios. Tries multiple authentication methods in order:\n\n```python\nfrom azure.identity import DefaultAzureCredential\nfrom azure.storage.blob import BlobServiceClient\n\n# Works in local dev AND production without code changes\ncredential = DefaultAzureCredential()\n\nclient = BlobServiceClient(\n    account_url=\"https:\u002F\u002F\u003Caccount>.blob.core.windows.net\",\n    credential=credential\n)\n```\n\n### Credential Chain Order\n\nSee [DefaultAzureCredential overview](https:\u002F\u002Faka.ms\u002Fazsdk\u002Fpython\u002Fidentity\u002Fcredential-chains#defaultazurecredential-overview) for the current credential chain order and defaults.\n\n### Customizing DefaultAzureCredential\n\n```python\n# Exclude credentials you don't need\ncredential = DefaultAzureCredential(\n    exclude_environment_credential=True,\n    exclude_shared_token_cache_credential=True,\n    managed_identity_client_id=\"\u003Cuser-assigned-mi-client-id>\"  # For user-assigned MI (also accepts object ID or resource ID)\n)\n\n# Enable interactive browser (disabled by default)\ncredential = DefaultAzureCredential(\n    exclude_interactive_browser_credential=False\n)\n\n# Set subprocess timeout for CLI-based credentials (default: 10s)\ncredential = DefaultAzureCredential(process_timeout=30)\n\n# Require AZURE_TOKEN_CREDENTIALS env var to be set\ncredential = DefaultAzureCredential(require_envvar=True)\n```\n\n### Exclude Parameters\n\n| Parameter | Default | Effect |\n|-----------|---------|--------|\n| `exclude_environment_credential` | False | Skip env-var-based auth |\n| `exclude_workload_identity_credential` | False | Skip Kubernetes workload identity |\n| `exclude_managed_identity_credential` | False | Skip managed identity |\n| `exclude_shared_token_cache_credential` | False | Skip shared token cache |\n| `exclude_visual_studio_code_credential` | False | Skip VS Code credential |\n| `exclude_cli_credential` | False | Skip Azure CLI |\n| `exclude_powershell_credential` | False | Skip Azure PowerShell |\n| `exclude_developer_cli_credential` | False | Skip Azure Developer CLI |\n| `exclude_interactive_browser_credential` | **True** | Skip interactive browser |\n| `exclude_broker_credential` | False | Skip WAM broker |\n\n## get_bearer_token_provider\n\nHelper that wraps a credential into a callable returning a bearer token string. Essential for OpenAI SDK and other non-Azure-SDK clients:\n\n```python\nfrom azure.identity import DefaultAzureCredential, get_bearer_token_provider\n\ncredential = DefaultAzureCredential()\ntoken_provider = get_bearer_token_provider(\n    credential, \"https:\u002F\u002Fcognitiveservices.azure.com\u002F.default\"\n)\n\n# Use with OpenAI SDK\nfrom openai import AzureOpenAI\n\nclient = AzureOpenAI(\n    azure_endpoint=\"https:\u002F\u002F\u003Cresource>.openai.azure.com\u002F\",\n    azure_ad_token_provider=token_provider,\n    api_version=\"2024-10-21\",\n)\n```\n\n## Credential Types\n\n### Credential Chains\n\n| Credential | Use Case |\n|------------|----------|\n| `DefaultAzureCredential` | Most scenarios — auto-detects environment |\n| `ChainedTokenCredential` | Custom credential chain with explicit ordering |\n\n### Azure-Hosted Applications\n\n| Credential | Use Case |\n|------------|----------|\n| `EnvironmentCredential` | Auth via AZURE_CLIENT_SECRET \u002F AZURE_CLIENT_CERTIFICATE_PATH env vars |\n| `ManagedIdentityCredential` | Azure VMs, App Service, Functions, AKS, Arc, Service Fabric |\n| `WorkloadIdentityCredential` | Kubernetes with Microsoft Entra Workload ID |\n\n### Service Principals\n\n| Credential | Use Case |\n|------------|----------|\n| `ClientSecretCredential` | Service principal with client secret |\n| `CertificateCredential` | Service principal with PEM\u002FPKCS12 certificate |\n| `ClientAssertionCredential` | Service principal with signed JWT assertion |\n| `AzurePipelinesCredential` | Azure Pipelines with workload identity federation |\n| `OnBehalfOfCredential` | Middle-tier on-behalf-of flow (delegated user identity) |\n\n### User Authentication\n\n| Credential | Use Case |\n|------------|----------|\n| `InteractiveBrowserCredential` | Interactive browser OAuth sign-in |\n| `DeviceCodeCredential` | Headless\u002FSSH device code flow |\n| `AuthorizationCodeCredential` | Previously obtained authorization code |\n\n### Developer Tools\n\n| Credential | Use Case |\n|------------|----------|\n| `AzureCliCredential` | `az login` |\n| `AzureDeveloperCliCredential` | `azd auth login` |\n| `AzurePowerShellCredential` | `Connect-AzAccount` |\n| `VisualStudioCodeCredential` | VS Code Azure Resources extension |\n\n## Specific Credential Examples\n\n### ManagedIdentityCredential\n\nFor Azure-hosted resources (VMs, App Service, Functions, AKS):\n\n```python\nfrom azure.identity import ManagedIdentityCredential\n\n# System-assigned managed identity\ncredential = ManagedIdentityCredential()\n\n# User-assigned managed identity (client_id, object_id, or resource_id)\ncredential = ManagedIdentityCredential(\n    client_id=\"\u003Cuser-assigned-mi-client-id>\"\n)\n# Also valid:\n# credential = ManagedIdentityCredential(object_id=\"\u003Cobject-id>\")\n# credential = ManagedIdentityCredential(resource_id=\"\u003Cresource-id>\")\n```\n\n### ClientSecretCredential\n\n```python\nimport os\nfrom azure.identity import ClientSecretCredential\n\ncredential = ClientSecretCredential(\n    tenant_id=os.environ[\"AZURE_TENANT_ID\"],\n    client_id=os.environ[\"AZURE_CLIENT_ID\"],\n    client_secret=os.environ[\"AZURE_CLIENT_SECRET\"],\n)\n```\n\n### CertificateCredential\n\n> **Note:** The class is `CertificateCredential`, NOT `ClientCertificateCredential`.\n\n```python\nfrom azure.identity import CertificateCredential\n\n# From file path\ncredential = CertificateCredential(\n    tenant_id=\"\u003Ctenant-id>\",\n    client_id=\"\u003Cclient-id>\",\n    certificate_path=\"\u002Fpath\u002Fto\u002Fcert.pem\",\n)\n\n# From bytes with password\ncredential = CertificateCredential(\n    tenant_id=\"\u003Ctenant-id>\",\n    client_id=\"\u003Cclient-id>\",\n    certificate_data=cert_bytes,\n    password=\"\u003Ccert-password>\",\n    send_certificate_chain=True,  # Required for SNI auth\n)\n```\n\n### AzureCliCredential\n\n```python\nfrom azure.identity import AzureCliCredential\n\ncredential = AzureCliCredential()\n# With tenant restriction\ncredential = AzureCliCredential(tenant_id=\"\u003Ctenant-id>\")\n```\n\n### ChainedTokenCredential\n\nCustom credential chain:\n\n```python\nfrom azure.identity import (\n    ChainedTokenCredential,\n    ManagedIdentityCredential,\n    AzureCliCredential,\n)\n\n# Try managed identity first, fall back to CLI\ncredential = ChainedTokenCredential(\n    ManagedIdentityCredential(client_id=\"\u003Cuser-assigned-mi-client-id>\"),\n    AzureCliCredential(),\n)\n```\n\n### WorkloadIdentityCredential\n\nFor Azure Kubernetes Service with workload identity:\n\n```python\nfrom azure.identity import WorkloadIdentityCredential\n\n# Reads from AZURE_TENANT_ID, AZURE_CLIENT_ID, AZURE_FEDERATED_TOKEN_FILE\ncredential = WorkloadIdentityCredential()\n\n# Or explicit configuration\ncredential = WorkloadIdentityCredential(\n    tenant_id=\"\u003Ctenant-id>\",\n    client_id=\"\u003Cclient-id>\",\n    token_file_path=\"\u002Fvar\u002Frun\u002Fsecrets\u002Fazure\u002Ftokens\u002Fazure-identity-token\",\n)\n```\n\n### DeviceCodeCredential\n\nFor headless devices (IoT, SSH, CLI tools):\n\n```python\nfrom azure.identity import DeviceCodeCredential\n\ncredential = DeviceCodeCredential()\n# Prints device code prompt to stdout by default\n\n# With custom prompt callback\ndef prompt_callback(verification_uri, user_code, expires_on):\n    print(f\"Go to {verification_uri} and enter code {user_code}\")\n\ncredential = DeviceCodeCredential(\n    client_id=\"\u003Cclient-id>\",\n    prompt_callback=prompt_callback,\n)\n```\n\n### InteractiveBrowserCredential\n\nFor interactive OAuth browser sign-in:\n\n```python\nfrom azure.identity import InteractiveBrowserCredential\n\ncredential = InteractiveBrowserCredential()\n\n# With specific tenant and client\ncredential = InteractiveBrowserCredential(\n    tenant_id=\"\u003Ctenant-id>\",\n    client_id=\"\u003Cclient-id>\",\n)\n```\n\n### OnBehalfOfCredential\n\nFor middle-tier services propagating user identity:\n\n```python\nfrom azure.identity import OnBehalfOfCredential\n\ncredential = OnBehalfOfCredential(\n    tenant_id=\"\u003Ctenant-id>\",\n    client_id=\"\u003Cclient-id>\",\n    client_secret=\"\u003Cclient-secret>\",\n    user_assertion=\"\u003Caccess-token-from-client>\",\n)\n```\n\n### AzurePipelinesCredential\n\nFor Azure DevOps pipelines with workload identity federation:\n\n```python\nimport os\nfrom azure.identity import AzurePipelinesCredential\n\ncredential = AzurePipelinesCredential(\n    tenant_id=\"\u003Ctenant-id>\",\n    client_id=\"\u003Cclient-id>\",\n    service_connection_id=\"\u003Cservice-connection-id>\",\n    system_access_token=os.environ[\"SYSTEM_ACCESSTOKEN\"],\n)\n```\n\n## Getting Tokens Directly\n\n```python\nfrom azure.identity import DefaultAzureCredential\n\ncredential = DefaultAzureCredential()\n\n# Get token for a specific scope\ntoken = credential.get_token(\"https:\u002F\u002Fmanagement.azure.com\u002F.default\")\nprint(f\"Token expires: {token.expires_on}\")\n\n# For Azure Database for PostgreSQL\ntoken = credential.get_token(\"https:\u002F\u002Fossrdbms-aad.database.windows.net\u002F.default\")\n```\n\n## Async Credentials\n\nAsync credentials are in `azure.identity.aio`. Always close them or use `async with`:\n\n```python\nfrom azure.identity.aio import DefaultAzureCredential\nfrom azure.storage.blob.aio import BlobServiceClient\n\nasync def main():\n    # Preferred: use async context manager for both credential and client\n    async with DefaultAzureCredential() as credential:\n        async with BlobServiceClient(\n            account_url=\"https:\u002F\u002F\u003Caccount>.blob.core.windows.net\",\n            credential=credential,\n        ) as client:\n            # ... async operations\n            pass\n```\n\n> The async `get_bearer_token_provider` is at `azure.identity.aio.get_bearer_token_provider`.\n\n## Sovereign Clouds\n\nUse `AzureAuthorityHosts` or the `AZURE_AUTHORITY_HOST` env var:\n\n```python\nfrom azure.identity import DefaultAzureCredential, AzureAuthorityHosts\n\n# Azure Government\ncredential = DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_GOVERNMENT)\n\n# Azure China\ncredential = DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_CHINA)\n```\n\n| Constant | Authority |\n|----------|-----------|\n| `AzureAuthorityHosts.AZURE_PUBLIC_CLOUD` | `login.microsoftonline.com` (default) |\n| `AzureAuthorityHosts.AZURE_GOVERNMENT` | `login.microsoftonline.us` |\n| `AzureAuthorityHosts.AZURE_CHINA` | `login.chinacloudapi.cn` |\n\n## Persistent Token Caching\n\nOpt-in disk-based caching with `TokenCachePersistenceOptions`:\n\n```python\nfrom azure.identity import DefaultAzureCredential, TokenCachePersistenceOptions\n\ncredential = DefaultAzureCredential(\n    cache_persistence_options=TokenCachePersistenceOptions()\n)\n\n# Allow unencrypted fallback (NOT recommended for production)\ncredential = DefaultAzureCredential(\n    cache_persistence_options=TokenCachePersistenceOptions(allow_unencrypted_storage=True)\n)\n```\n\nStorage: Windows (DPAPI), macOS (Keychain), Linux (Keyring).\n\n## Multi-Tenant Support\n\nAllow token acquisition for additional tenants beyond the configured one:\n\n```python\nfrom azure.identity import ClientSecretCredential\n\ncredential = ClientSecretCredential(\n    tenant_id=\"\u003Chome-tenant>\",\n    client_id=\"\u003Cclient-id>\",\n    client_secret=\"\u003Csecret>\",\n    additionally_allowed_tenants=[\"\u003Cother-tenant>\", \"*\"],  # \"*\" allows any tenant\n)\n```\n\n## Error Handling\n\n```python\nfrom azure.identity import DefaultAzureCredential, CredentialUnavailableError\nfrom azure.core.exceptions import ClientAuthenticationError\n\ncredential = DefaultAzureCredential()\ntry:\n    token = credential.get_token(\"https:\u002F\u002Fmanagement.azure.com\u002F.default\")\nexcept CredentialUnavailableError:\n    # No credential in the chain could attempt authentication\n    pass\nexcept ClientAuthenticationError as e:\n    # Authentication was attempted but failed\n    # e.message contains details from each credential in the chain\n    pass\n```\n\n## Logging\n\nEnable authentication logging for debugging:\n\n```python\nimport logging\n\n# Enable verbose Azure Identity logging\nlogging.basicConfig(level=logging.DEBUG)\nlogger = logging.getLogger(\"azure.identity\")\nlogger.setLevel(logging.DEBUG)\n```\n\n```bash\n# Or via environment variable\nAZURE_LOG_LEVEL=debug\n```\n\n## Credential Selection Matrix\n\n| Environment | Recommended Credential |\n|-------------|------------------------|\n| Local Development | `DefaultAzureCredential` (uses Azure CLI) |\n| Azure App Service | `DefaultAzureCredential` (uses Managed Identity) |\n| Azure Functions | `DefaultAzureCredential` (uses Managed Identity) |\n| Azure Kubernetes Service | `WorkloadIdentityCredential` |\n| Azure VMs | `DefaultAzureCredential` (uses Managed Identity) |\n| CI\u002FCD Pipeline | `EnvironmentCredential` or `AzurePipelinesCredential` |\n| Desktop App | `InteractiveBrowserCredential` |\n| CLI \u002F Headless Tool | `DeviceCodeCredential` |\n| Middle-tier Service | `OnBehalfOfCredential` |\n\n## Best Practices\n\n1. **Use `DefaultAzureCredential`** for code that runs locally and in Azure\n2. **Never hardcode credentials** — use environment variables or managed identity\n3. **Prefer managed identity** in production Azure deployments\n4. **Use `get_bearer_token_provider`** for non-Azure-SDK clients (OpenAI, REST APIs)\n5. **Use `ChainedTokenCredential`** when you need a custom credential order\n6. **Close async credentials** — use `async with credential:` context manager\n7. **Set `AZURE_CLIENT_ID`** for user-assigned managed identities (object ID and resource ID are also valid identifiers)\n8. **Exclude unused credentials** to speed up `DefaultAzureCredential` authentication\n9. **Use `CertificateCredential`** (not `ClientCertificateCredential` — that name doesn't exist)\n10. **Enable `cache_persistence_options`** for long-running services to reduce token requests\n11. **Reuse credential instances** — same credential can be shared across multiple clients\n\n## Reference Links\n\n| Resource | URL |\n|----------|-----|\n| PyPI Package | https:\u002F\u002Fpypi.org\u002Fproject\u002Fazure-identity\u002F |\n| API Reference | https:\u002F\u002Flearn.microsoft.com\u002Fpython\u002Fapi\u002Fazure-identity |\n| GitHub Source | https:\u002F\u002Fgithub.com\u002FAzure\u002Fazure-sdk-for-python\u002Ftree\u002Fmain\u002Fsdk\u002Fidentity\u002Fazure-identity |\n| Credential Chains | https:\u002F\u002Faka.ms\u002Fazsdk\u002Fpython\u002Fidentity\u002Fcredential-chains |\n",{"name":5,"license":15,"metadata":24,"description":28},{"author":25,"package":26,"version":27},"Microsoft","azure-identity","1.0.0","Azure Identity SDK for Python authentication with Microsoft Entra ID. Use for DefaultAzureCredential, managed identity, service principals, and token caching.\nTriggers: \"azure-identity\", \"DefaultAzureCredential\", \"authentication\", \"managed identity\", \"service principal\", \"credential\".\n","master","c247302c836de6438d746b45670990eb71691166","skills_collected\u002Fmicrosoft--skills--.github__plugins__azure-sdk-python__skills__azure-identity-py",1,"https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool","https:\u002F\u002Fgithub.com\u002Fqhjqhj00","chien.io","2026-05-11 15:07:59",{"source":8,"skillName":5,"commands":38,"prompt":48,"zipAvailable":49},[39,42,45],{"tool":40,"command":41},"npx","npx skills add qhjqhj00\u002Fresearch-skills-pool --skill azure-identity-py",{"tool":43,"command":44},"bunx","bunx skills add qhjqhj00\u002Fresearch-skills-pool --skill azure-identity-py",{"tool":46,"command":47},"pnpm","pnpm dlx skills add qhjqhj00\u002Fresearch-skills-pool --skill azure-identity-py","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool\u002Fblob\u002Fmaster\u002Fskills_collected\u002Fmicrosoft--skills--.github__plugins__azure-sdk-python__skills__azure-identity-py\u002FSKILL.md",true,[],[52,59,66,73,80,87],{"skillNo":53,"name":54,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":19},"01M73JJB6EQPFPPVQK2Y9N67Q0","transformer-lens-interpretability","Provides guidance for mechanistic interpretability research using TransformerLens to inspect and manipulate transformer internals via HookPoints and activation caching. Use when reverse-engineering model algorithms, studying attention patterns, or performing activation patching experiments.","https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool\u002Fblob\u002Fmaster\u002Ftop100-runs\u002F130-transformer-lens\u002FSKILL.md",[],[],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M73JHTANRRWEE9HP98TPEHAY","wiki-vitepress","Packages generated wiki Markdown into a VitePress static site with dark theme, dark-mode Mermaid diagrams with click-to-zoom, and production build output. Use when the user wants to create a browsable website from generated wiki pages.","https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool\u002Fblob\u002Fmaster\u002Ftop100-runs\u002F126-wiki-vitepress\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M73JHJBMVFW46F1Y8K3SBF43","phoenix-observability","Open-source AI observability platform for LLM tracing, evaluation, and monitoring. Use when debugging LLM applications with detailed traces, running evaluations on datasets, or monitoring production AI systems with real-time insights.","https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool\u002Fblob\u002Fmaster\u002Ftop100-runs\u002F124-phoenix\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M73JHFPA3A2806PMP42ZN86Q","frontend-ui-dark-ts","Build dark-themed React applications using Tailwind CSS with custom theming, glassmorphism effects, and Framer Motion animations. Use when creating dashboards, admin panels, or data-rich interfaces with a refined dark aesthetic.","https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool\u002Fblob\u002Fmaster\u002Ftop100-runs\u002F123-frontend-ui-dark-ts\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M73JFVBVK57NRJS49TT2VDCT","tensorboard","Visualize training metrics, debug models with histograms, compare experiments, visualize model graphs, and profile performance with TensorBoard - Google's ML visualization toolkit","https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool\u002Fblob\u002Fmaster\u002Ftop100-runs\u002F113-tensorboard\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":91,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M73JFF6PK6ZCN41C89J7HS2B","markdown-mermaid-writing","Comprehensive markdown and Mermaid diagram writing skill. Use when creating any scientific document, report, analysis, or visualization. Establishes text-based diagrams as the default documentation standard with full style guides (markdown + mermaid), 24 diagram type references, and 9 document templates.","Apache-2.0","https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool\u002Fblob\u002Fmaster\u002Ftop100-runs\u002F110-markdown-mermaid-writing\u002FSKILL.md",[],[]]