1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | azure-identity-py（正式名称：azure-identity-py-microsoft-skills） | — |
| 作者/维护者 | Microsoft（microsoft/skills 官方仓库；本子技能由 Larry Osterman、Xiang Yan、KarishmaGhiya 等多位工程师共同维护） |
GitHub API |
| 来源链接 | https://github.com/microsoft/skills/tree/main/.github/plugins/azure-sdk-python/skills/azure-identity-py | — |
| 许可证 | MIT（SKILL.md 自身声明，与仓库根 LICENSE 一致） | GitHub API |
| GitHub Stars / Forks | 所属合集仓库 2,818★ / 317 forks（该数字属整个 microsoft/skills 合集，不代表本技能自身热度） | GitHub API |
| 最新版本 | SKILL.md 自带 version: 1.0.0；本子目录最近一次实质提交在 2026-07-15 |
GitHub API（commits） |
| 安装方式 | npx skills add microsoft/skills 交互向导勾选安装；或 microsoft.github.io/skills 技能浏览器一键安装 |
仓库 README |
2. 功能介绍与亮点
azure-identity-py 教 agent 用官方 azure-identity Python 库完成到 Azure 各服务的身份认证，覆盖从本地开发到生产部署的完整凭据链条：DefaultAzureCredential 自动探测环境（本地 CLI/VS Code 到 Azure 托管身份）、ManagedIdentityCredential（系统分配与用户分配）、服务主体认证（密钥或证书）、Kubernetes 工作负载身份、设备码与交互式浏览器登录、以及中间层服务的委托身份（OnBehalfOfCredential）。
正文给出一张按部署环境（本地开发、App Service、Functions、AKS、CI/CD 流水线、桌面应用、无头 CLI 工具）对照推荐凭据类型的选型表，并覆盖主权云（Azure 政府云/中国云）配置、令牌持久化缓存（Windows DPAPI / macOS Keychain / Linux Keyring 加密存储）、以及 get_bearer_token_provider 桥接非 Azure SDK 客户端（如 OpenAI SDK）等进阶场景。全文贯穿两条硬性规则：优先用 DefaultAzureCredential 而非明文连接字符串/账户密钥（避免绕过 Entra 审计与轮换）；每个凭据与客户端都要用上下文管理器包裹以正确释放令牌缓存与连接。
亮点：作为 azure-sdk-python 系列中所有其他子技能（Key Vault、Blob Storage、Cosmos DB 等）在鉴权环节共同依赖的基础库，本技能把“如何正确认证”这一横切关注点独立成篇；技能目录本身不含任何可执行脚本，纯文档与代码示例；2026-02～07 月间由多位具名微软工程师持续迭代，最近一次实质更新在 2026-07-15。
3. 适用场景
固定分类：安全与合规
面向需要在 Python 项目中对接任意 Azure 服务（存储、数据库、AI 服务等）、且希望从一开始就用令牌认证取代硬编码密钥或连接字符串的开发者，尤其适合不熟悉 Entra ID 凭据链、托管身份或多环境（本地/云端/CI）认证差异的初中级用户。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——官方安装命令
npx skills add microsoft/skills在 README 中明确给出，技能安装后放入 agent 对应的技能目录 - Codex：❓ 未验证——已抓取材料未说明
npx skills add是否支持 Codex CLI 的技能目录结构 - OpenClaw：❓ 未验证——未见相关材料
- Hermes Agent：❓ 未验证——未见相关材料
5. 推荐理由
微软官方出品且持续维护的 Azure 身份认证 Python SDK 使用指南，把本地开发到生产部署全链路的凭据选型、令牌缓存与凭据链定制封装成可直接复用的代码范式，并把“优先用令牌认证、避免硬编码密钥”作为贯穿全文的强制规则——这是所有需要连接 Azure 服务的项目都绕不开的第一步，能显著降低初中级开发者在认证环节埋下安全隐患的概率。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 本技能所属 microsoft/skills 为官方仓库，2026-02~07 月间由多位具名微软工程师持续迭代该子目录；所属合集仓库规模（2,818★）不代表本技能自身热度，且未见第三方独立平台的活跃讨论 |
| 可用性 | 9 | pip install azure-identity 一条命令即可安装；SKILL.md 按部署场景给出选型表与十余种凭据类型的完整代码示例，无需额外脚本即可直接对照上手；最近一次实质提交距今约 10 天，无付费第三方依赖 |
| 安全性 | 9 | 技能目录不含任何可执行脚本，纯文档与代码示例；正文明确要求优先使用 DefaultAzureCredential/托管身份而非明文密钥，并给出令牌持久化缓存的操作系统级加密存储方案（DPAPI/Keychain/Keyring）；MIT 许可证明确；官方仓库多位具名工程师维护 |
| 综合 | 8.3 | 三项均值 |
安全检查清单逐项结果：① 技能目录内零脚本、零 shell 命令 ② 代码示例仅在用户主动调用时联网至 Azure/Entra ID 官方认证端点，用途透明 ③ 认证方式默认走 DefaultAzureCredential 令牌链，正文明确建议避免连接字符串/账户密钥，令牌缓存有加密存储方案 ④ 全文关键词扫描无可疑指令或混淆代码 ⑤ 官方仓库、多位具名工程师维护，无造假迹象 ⑥ MIT 许可证明确 ⑦ 最近一次实质提交距今约 10 天，维护活跃。
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与本技能的差异 |
|---|---|---|
| azure-keyvault-py-microsoft-skills | 密钥/证书/加密密钥的存储与生命周期管理 | 是 Key Vault 这一具体服务的操作指南，其认证部分直接复用本技能的 DefaultAzureCredential 模式；本技能覆盖的是所有 Azure 服务通用的认证选型与凭据链定制，范围更底层、更通用 |
| dotenv / python-decouple（业界常见方案） | 从 .env 文件读取环境变量形式的密钥 |
本质仍是明文密钥的本地化管理，密钥一旦泄露即失效且无法审计使用记录；本技能对应的 Entra ID 令牌认证支持自动轮换与访问审计，安全边界更强 |
| AWS SDK 的 boto3 默认凭据链（跨云对照） | AWS 生态同类的多来源凭据自动探测机制 | 设计思路相近（本地开发到云端托管身份自动切换），但本技能额外覆盖主权云配置、令牌持久化的操作系统级加密存储、以及桥接非 Azure SDK 客户端（如 OpenAI SDK）的场景，覆盖面更完整 |
8. 用户评价
该技能目前在第三方平台尚无独立具名用户评价。相关背景：microsoft/skills 仓库的 GitHub Issue #189 中，用户 thevman 反映通过插件市场安装本仓库时因 pluginRoot 路径声明与实际插件路径不一致而报错“Failed to add Marketplace”；这是仓库级的已知安装限制，改用 npx skills add 命令直接安装单个技能可绕开该问题。
9. 安装使用方式
- 推荐方式：
npx skills add microsoft/skills，交互向导会列出全部技能供勾选，选中azure-identity-py后放入当前 agent 对应的技能目录（如 Claude Code 为.claude/skills/） - 技能浏览器方式：访问 microsoft.github.io/skills，在网页版技能浏览器中一键安装
- 手动方式：
git clone https://github.com/microsoft/skills.git cp -r skills/.github/plugins/azure-sdk-python/skills/azure-identity-py your-project/.claude/skills/ - 使用前需自行准备好待认证的 Azure 资源（如已开通的 Storage/Key Vault 等服务）与相应的 Entra ID 权限；安装后无需重启，agent 会依据 SKILL.md 的
description触发条件（如提到“DefaultAzureCredential”、“managed identity”等）自动调用
10. 注意事项
- 生产环境认证建议走
DefaultAzureCredential配合托管身份或显式指定凭据类型（AZURE_TOKEN_CREDENTIALS=prod），而非文档中标注为“遗留方案”的服务主体密钥/证书方式 - 通过插件市场（
/plugin marketplace add）安装本仓库时曾有用户反映路径配置报错（Issue #189），若遇到同类问题可改用npx skills add命令直接安装单个技能 - 跨 Agent 兼容性除 Claude Code 有明确安装说明外，其余三个生态均未验证，实际使用前建议先手动测试触发效果