Netwrix 1Secure 提供跨数据和身份的统一可见性——免费试用14天,享有完全访问权限。开始免费试用

资源中心博客

API密钥管理指南

API密钥管理指南

Sep 25, 2026

未管理的长期密钥削弱了可见性、审计准备、运营连续性和网络弹性,使API密钥管理在非人类身份中至关重要。有效的方案维护清单和所有权,执行最小权限和安全存储,并自动化每个密钥生命周期中的轮换、监控和撤销。

根据The NHI & Secrets Risk Report H1 2025,企业环境中非人类身份(NHI)数量是人类用户的144倍,较一年前的92:1增长了56%。API密钥管理应考虑这一规模,因为服务账户、自动化管道和第三方集成都携带凭据。这些凭据中很大一部分是API密钥,静态字符串通常默认不会过期,滑入源代码,并且逃避访问审查。

人工账户会执行入职-调动-离职流程和定期认证。开发人员通常在开发者控制台创建API密钥,并将其粘贴到配置文件中。密钥会一直保留,直到出现故障或不当离职暴露漏洞。

有效的凭证治理涵盖机器凭证的生成、存储、轮换、监控和吊销。将这些控制措施应用于每个非人类身份,消除长期密钥风险,增强安全态势、运营可见性和网络弹性。

什么是API密钥管理?

API密钥管理是从生成到撤销管理机器凭证的学科,涵盖存储、分发、轮换和监控。API密钥本身是一个静态的不透明字符串,应用程序通常在API请求的超文本传输协议(HTTP)头中传输该字符串,以识别调用的应用程序、服务、脚本或管道。它作为持有者凭证使用,因为仅凭持有即可使用。

Request for Comments (RFC) 6750 定义了OAuth 2.0承载令牌的相同属性:任何持有该令牌的人都可以使用它,而无需证明拥有加密密钥材料。正是这种承载者属性导致标准API密钥无法认证主体。它仅证明拥有字符串值,而非身份。

为什么API密钥成为日益增长的攻击面

开发人员在2025年向公共GitHub仓库提交了 28,649,024个新的硬编码密钥,根据GitGuardian的《2026年秘密扩散状态》报告。该总数较去年增长了34%,是报告记录的最大单年增幅。多种结构性因素推动了这种扩散。许多API密钥默认不会过期,因此长期密钥暴露可能持续多年,并且在HTTP头中有效的相同明文字符串值,在配置文件、持续集成和持续交付(CI/CD)变量或聊天消息中同样有效。

权限过度的NHI获得的权限范围通常超过其任务所需,这些权限往往比任务本身存在时间更长。每一个新的云服务、管道和第三方集成都增加了安全团队必须管理的资产清单。根据Netwrix 2026 Data and Identity Security Report,75%的基于事件的数据泄露始于身份被泄露或权限配置错误。

一个历史案例展示了生命周期控制薄弱的运营影响。2023年11月,一名威胁行为者通过暴露的有效凭据访问了Cloudflare自托管的Atlassian环境。

攻击者使用了2023年10月Okta泄露中暴露的一个访问令牌和三个服务账户凭据,Cloudflare随后从未更换这些凭据。Cloudflare称其为“错误地认为未被使用”。修复工作需要在Cloudflare全球网络范围内广泛更换生产凭据并重新映像机器。

该攻击者在整个事件中均使用有效凭据进行身份验证,且Netwrix 2025 Cybersecurity Trends Report 发现27%的组织估计攻击损失达到50,001美元或以上,强调了通过生命周期控制减少可避免的响应和修复工作的财务合理性。持续的清单管理、所有权和轮换减少了恢复负担并提升了网络弹性。

Netwrix Privilege Secure 用即时特权会话替换常驻管理员账户,自动撤销。下载免费试用

API 密钥生命周期

Open Worldwide Application Security Project (OWASP) 秘密指南 将有效的密钥管理组织为五个阶段:生成、存储和分发、轮换、监控和审计,以及撤销。

生成

每个密钥都应来自加密安全的随机源,并从创建时起带有范围限制。对于作为National Institute of Standards and Technology (NIST) SP 800-63B-4 查找密钥或直接类似凭证的密钥,使用112位的最小安全强度作为熵基准;NIST要求查找密钥必须来自具有该最小强度的批准随机比特生成器,专门应用于查找密钥和直接类似凭证。

在发行时应用密钥限制,指定密钥可以调用哪些API以及哪些应用程序可以使用它。为每个密钥分配其任务所需的最低权限,并同时创建所有权记录。关于哪些密钥应进行认证,OWASP API 指南明确指出API密钥应认证API客户端,而非终端用户。

两种相关的凭证类型不同于API密钥。 OAuth 2.0标准是一种授权框架,定义了授权流程颁发的访问令牌。客户端认证要求、权限范围和有效期取决于授权类型和提供者配置;在微软的客户端凭证流程中,典型的令牌有效期通常约为一小时。

使用相互传输层安全(mTLS)和X.509的基于证书的凭证改为使用持有证明。客户端证明对保留在客户端的私钥的控制,因此根据 RFC 8705,只有持有与证书对应的私钥的一方才能使用相关令牌。

存储和分发

将密钥移出源代码,并在运行时从专用的秘密存储中检索。源代码中硬编码的凭据很危险;解决方法是使用秘密管理器,CI/CD管道和应用程序可以安全地检索秘密。

留在应用程序源代码树之外的环境变量是基础;集中式秘密管理器具备访问控制和审计日志是标准。仅通过超文本传输安全协议(HTTPS)分发密钥,且绝不将其放入 URL 中,因为查询字符串会出现在 Web 服务器日志中。

旋转

手动轮换流程会引入错误并使过期凭据保持激活,这就是自动化重要的原因。对于长期使用的Google Cloud服务账户密钥,云服务提供商指南建议至少每90天轮换一次。互联网安全中心(CIS)针对亚马逊网络服务(AWS)的基准同样要求每90天或更短时间轮换AWS Identity and Access Management(IAM)访问密钥。每90天或更短。

为实现零停机时间轮换,请使用dual-credential rotation。保持两套有效凭据,将应用切换到新凭据,然后弃用旧凭据。在怀疑泄露、所有权变更或项目结束后,触发event-driven rotation。跳过此阶段的代价会不断增加。GitGuardian发现,64%它四年前检测到的秘密在重新测试时仍然有效且可被利用。

监控与审计

为每个凭据创建key-use logs,并检查这些日志中已静默的密钥。CIS Controls v8要求至少保留90天的审计日志,CIS云基准要求团队在45天不活动后禁用凭据。休眠是一个有用的信号。

审核 service principal 凭据的创建和使用,监控异常的应用使用情况,例如休眠应用突然再次激活。在日志输出中屏蔽秘密值;秘密绝不应以明文形式出现在日志中。

撤销

一旦发现密钥泄露,即视为已被泄露,并在需要之前构建撤销路径。遵循安全的轮换顺序。为同一服务账户生成替换密钥,将工作负载迁移至新密钥,迁移后验证功能,然后删除旧密钥。

仅从代码中删除密钥不会使凭据失效;请遵循存储库清理指南,先撤销权限,然后清理存储库、配置和日志。最后进行影响范围审查,检查密钥的使用历史。密钥暴露期间访问了什么,攻击者是否利用它创建了新的密钥、角色或策略?

API密钥管理方法中应关注的内容

有效的治理计划将vault部署与运营控制相结合,因此应根据运营标准评估方法。

  • 集中式清单和发现: 该方法应在云提供商、CI/CD管道、代码库、配置文件和Software as a Service (SaaS)平台中查找密钥,并记录每个密钥的所有者。非人工凭据的实用注册表应捕获身份、所属团队、业务目的、访问的系统、权限范围以及过期或审查日期。
  • 最小权限范围和即时发放: 寻找按密钥、按工作负载划分范围的功能,以及按需发放短期凭证并在使用后自动撤销的能力。
  • 无停机时间的自动轮换: 支持计划和事件驱动的轮换,支持双重凭据,确保应用在切换期间保持可用。
  • 审计就绪日志: 每次检索、轮换、撤销和管理操作都应创建带有可归属身份和时间戳的审计就绪记录,以导出到您的安全信息和事件管理(SIEM)系统。该记录提供审计证据和事件响应人员所需的取证线索。
  • 与身份治理的集成: Identity Governance and Administration (IGA)、Privileged Access Management (PAM) 和 Cloud Infrastructure Entitlement Management (CIEM) 应协同工作,在所有环境中一致地管理身份和权限。一个与您的 IGA program 共享库存和所有权数据的保险库可以将密钥包含在认证流程中。IGA buyer's guide 概述了评估Identity Management工具的更多治理功能。

API 密钥管理在非人类身份治理中的作用

许多治理计划在所有权方面失败。 Silverfort's Insecurity in the Shadows 2025 发现40%的非人类身份拥有未知所有者,只有5.7%的安全领导报告对其NHI有完全可见性。

Gartner对335名IAM领导者进行的调查显示,发表于Gartner Identifies the Top Cybersecurity Trends for 2025,发现IAM团队仅负责组织44%的机器身份;其余由开发、平台和业务团队负责。明确的身份所有权为审查、轮换和退役创造了责任。

合规框架已经预期这一规范。 Payment Card Industry Data Security Standard (PCI DSS) 最小权限要求涵盖应用程序和系统账户(Req. 7.2.5)。组织必须根据其目标风险分析中定义的频率定期审查这些账户的访问权限。PCI DSS Req. 7.2.5.1 于2025年3月31日生效。PCI DSS还规定了针对脚本、配置文件和源代码的硬编码密码控制(Req. 8.6.2)。

该安全规则将访问控制范围限定于具有访问权限的人员或软件程序,因此涉及受保护健康信息(PHI)的机器凭据明确包含在内。Health Insurance Portability and Accountability Act (HIPAA)

对于 Sarbanes-Oxley Act (SOX),完整的访问群体支持可靠的控制测试。SOX访问治理应在访问列表中包括服务账户和集成密钥。在各个框架中,一致的审计证据包括发现报告、所有权记录、轮换日志、退役记录以及带有签名的带日期审查。

分析师的共识也已趋于一致。秘密保管支持治理,但治理超越了秘密保管。组织越来越期望IGA平台通过灵活的生命周期策略、持续的调和和明确的所有权模型,持续一致地管理人类和NHI。

实际上,每个API密钥都需要与人类账户相同的生命周期管理。这意味着要为其创建所有者和记录的用途,定期认证,并在任务结束时进行下线。下线仍然是最大的漏洞;开放式全球应用安全项目(OWASP)的NHI十大风险中包括了不当下线这一常见失败模式,并报告称51%的组织没有正式的流程来下线或撤销长期存在的API密钥。由于团队不断创建和放弃密钥,治理模型需要持续的对账,以在人员变动时保持可见性和安全态势。

管理大型API密钥库存的最佳实践

可扩展的程序将生命周期策略转化为可重复的技术和治理控制:

  • 最小权限策略模板: 为常见工作负载定义批准的API、资源和操作范围,应用默认拒绝执行,并检测偏离这些模板的情况。
  • 从静态密钥迁移: 如果平台支持workload identity federation、managed identities或临时会话凭据,请改用它们。 National Cyber Security Centre (NCSC) 指南 建议避免使用可能在被泄露时授予无限访问权限的长期访问密钥。
  • 轮换编排: 连接凭据发放、应用切换、验证和退役,使团队能够按照NCSC的指导自动化凭据轮换。
  • Vault-to-discovery 对账: GitGuardian 发现 2024年使用 secrets managers 的代码库中仍有5.1%泄露了秘密;将存储的凭据与代码库、流水线、云和SaaS清单进行比较,以发现差距。
  • 事件响应紧急开关: 保持在几分钟内撤销任何密钥的能力,并具备预先测试的替换路径。 SANS互联网风暴中心(SANS ISC)观察到 威胁行为者在24小时内从验证被盗秘密转向在受损云环境中进行主动发现操作。
  • 指定所有者审核: CIS Safeguard 5.5 要求提供包含部门所有者、审核日期和目的的服务账户清单,至少每季度审核一次;将API密钥纳入同一审核。

Netwrix如何帮助您管理API密钥和机器凭据

API 密钥是更大规模非人类身份治理挑战中的一种凭证类型,大多数组织对该群体缺乏完整的可见性。Netwrix 支持作为其以身份为中心的安全方法一部分的相邻 PAM 和 IGA 控制,适用于运行以 Microsoft 为主的混合环境的中型市场组织。

对于特权访问工作流,Netwrix Privilege Secure 采用零常驻权限模型,创建任务范围的 临时账户,仅用于单次会话,结束后即销毁。 Eastern Carver County Schools 消除了网络交换机、VMware 和安全摄像头上的常驻特权访问,保护了9300名学生的数据,用即时访问替代,并在几天内完成了部署,而非几个月。Netwrix Identity Manager 支持访问认证和这些凭据所属身份的自动离职管理。 across network switches, VMware, and security cameras protecting 9,300 students' data, replacing it with just-in-time access and completing the rollout in days instead of months. Netwrix Identity Manager supports access certification and automated offboarding for the identities those credentials belong to.

超过14,000名客户,包括约25%的财富500强企业,依赖Netwrix共同管理身份和数据安全。

请求演示,了解 Netwrix Privilege Secure 如何通过任务范围的凭据自动过期来消除持续的特权访问。

关于API密钥管理的常见问题

分享到

了解更多

关于作者

Asset Not Found

Netwrix Team