密钥管理是开发者用于生成、存储、分发和停用凭证的一套实践和系统。例如,无服务器函数内的应用程序编程接口(API)密钥或连接池中的数据库密码。密钥管理限制了谁和什么可以读取特定值、可以读取多长时间以及在什么条件下读取。密钥泄露是一个日益严重的问题,2024 年公共 GitHub 提交中新增了 近 2400 万 个硬编码密钥。
在下面,我们将讨论开发者管理的密钥类型、存储和访问的工作原理,以及 Stripe Projects 如何帮助为开发者或团队创建的每个项目配置单独的 API 密钥。
要点
应用程序编程接口(API)密钥、访问令牌、数据库凭证、证书和加密密钥各自都有其自身的风险和生命周期。
限定范围的凭证、定期轮换和审计日志可限制单个暴露密钥可能造成的损害。
调用应用程序编程接口(API)和基础设施的自主工具需要独立的、设定作用域的且可撤销的访问权限,而不是广泛的账户权限。
为什么密钥管理最佳实践很重要?
密钥管理涵盖了您如何生成、存储、分发和停用您的应用程序(app)依赖的凭证。良好的密钥管理通过使凭证的访问权限清晰且易于撤销,来限制受损凭证所造成的损害。糟糕的密钥管理可能会让任何找到单个泄露值的人都能访问生产系统。
开发者需要保护哪些类型的密钥?
密钥有几种常见的类别,每种的功能略有不同。
以下是密钥管理通常涵盖的内容:
应用程序编程接口(API)密钥: 它们会向第三方服务(例如支付服务商或地图 API)验证您应用程序的身份。它们通常不会自动过期,因此泄露的密钥通常会授予完整的账户访问权限,直到有人手动将其撤销。
访问令牌: 开放授权(OAuth)访问令牌和 JavaScript 对象简谱(JSON)Web 令牌带有用户或服务的权限,其生命周期通常比 API 密钥短。它们出现在移动端应用、单点登录流程和服务间调用中。
数据库凭证: PostgreSQL、MySQL 或 MongoDB 等系统的用户名、密码和连接字符串位于配置文件和连接池中。它们通常同时在多个环境中被复制。
证书和私钥: 传输层安全性(TLS)证书和安全外壳(SSH)密钥验证身份并保护服务器之间的连接。过期的或存储不当的证书导致服务中断的频率与导致数据泄露的频率一样高。
加密密钥: 静态或传输中加密数据的密钥由 Amazon Web Services Key Management Service(AWS KMS)或 HashiCorp Vault 的传输引擎等服务管理。丢失一个密钥可能意味着失去对其所保护数据的访问权限。
环境变量: 这些本身不是密钥。它们是许多应用程序用来将密钥提取到正在运行的进程中的交付机制,并且它们很容易将值泄露到日志文件或崩溃报告中。
这些密钥出现在不同的环境中:本地开发机器、持续集成和持续交付(CI/CD)管道、云基础设施以及生产系统。在一个环境中被严格锁定的值,在另一个环境中可能会完全暴露。
密钥管理的工作原理是什么?
密钥管理将硬编码值替换为查找。您的应用程序不是将数据库密码直接写入代码中,而是在运行时向集中式存储请求它,该存储将决定是否释放该密码。
环境变量更简单。容器编排系统允许您在部署时将密钥作为环境变量或挂载文件注入,这可以使它们处于代码库之外,但一旦它们进入运行中的容器内,便不会对其进行加密。配置管理系统介于两者之间:它们在传输过程中和配置存储库内保护密钥,但您仍然要对接收系统在之后如何处理它负责。
集中式凭证管理平台在存储的基础上建立轮换、版本控制和审计跟踪。当您的代码需要密钥时,它会通过服务账户、身份和访问管理(IAM)角色或短期令牌向平台进行身份验证,并获得一个设定了作用域且有时间限制的凭证,而不是静态的凭证。这使得团队可以切断单个服务的访问权限,而无需触及系统中的任何其他凭证。
密钥管理有哪些最佳实践?
良好的密钥管理取决于团队长期坚持的习惯。
几乎所有严谨的框架都包含这些实践:
授予最低权限访问: 仅赋予每个服务或个人他们需要的特定密钥,并将其作用域限制为特定环境和操作。部署到暂存环境的持续集成(CI)管道绝不应该持有与部署到生产环境的管道相同的凭证。
按计划轮换密钥: 长期的 API 密钥和数据库密码应定期轮换,并在任何员工离职或怀疑遭到泄露后立即轮换。自动轮换消除了跳过它的借口。
为令牌设置过期时间: 在几分钟或几小时内过期的短期令牌限制了令牌泄露时的损害窗口期。OAuth 访问令牌通常与寿命较长的刷新令牌配对使用,而不是采用单一的静态值。
记录每个访问请求: 审计日志应记录哪个身份在何时、从何地访问了哪个密钥。这样,您就可以确定凭证在事件中是否受到了破坏,而不是进行猜测。
按环境分离密钥: 开发、暂存和生产环境都应有各自的凭证,并存储在它们独立的保管库或命名空间中。测试数据库的密码绝不应用于生产数据库。
通过保管库共享密钥,而不是通过聊天或电子邮件: 将凭证粘贴到 Slack 或支持服务工单中,会将其置于并非为保护凭证而构建的系统中。相反,许多密钥管理平台支持临时的、可撤销的共享链接。
在每次提交时扫描暴露的凭证: GitHub 密钥扫描、TruffleHog 和 Gitleaks 等扫描程序会在合并之前或之后检查提交和拉取请求中是否有意外的凭证暴露。
从版本历史记录中删除泄露的密钥: 首先撤销暴露的凭证,因为如果旧值仍然有效,从 git 历史记录中将其删除也无济于事。然后,诸如 git filter-repo 或 BFG Repo-Cleaner 之类的工具可以将其从过去的提交中剥离,尽管更早克隆该存储库的任何人仍然会有一份副本。
糟糕的密钥管理有哪些风险?
GitGuardian 对公共 GitHub 提交的年度研究发现,在 2024 年有 15% 的提交作者泄露了密钥。直接的风险是未经授权的访问。泄露的数据库凭证可能会被发现,且自动扫描程序可以在推送后的几分钟内搜索公共存储库。
除了最初的暴露之外,一把被盗但未被注意到的密钥可能会活跃数月之久,因为许多企业都有捕获登录失败的流程,但却没有捕获对技术上有效的凭证进行未经授权使用的流程。以这种方式进入的攻击者根本不需要绕过身份验证;他们已经拥有了它。
糟糕的密钥管理还会产生与犯罪无关的风险。过期的证书会导致服务中断。已轮换但未在各处更新的凭证会在随机时间破坏集成。并且非正式地(通过电子邮件或共享文档)共享密钥的团队可能会无法追踪谁真正拥有访问权限。
密钥管理如何应用于 AI 代理和开发工作流?
AI 编码代理改变了考量方式,因为它们通常需要真实的凭证来完成实际工作,例如 调用 API、查询数据库或部署代码。代理以机器速度执行指令,因此一个作用域设定不佳的凭证可能会在任何人注意到之前对多个系统造成破坏。
这种风险随着代理可以调用的工具数量的增加而增加。连接到 支付 API、云服务商和内部工单系统的代理需要为每一个提供独立的、设定了作用域的凭证,而不是一组涵盖一切的广泛权限。如果没有这种分离,单个受损的代理会话所产生的影响将远超预期。
对于在 Stripe 上进行开发的开发者,Stripe Projects 解决了部分问题。它可以为开发者或团队创建的每个项目配置单独的 API 密钥,作用域限制为该项目的数据和环境。一个代理或应用程序使用的密钥不附带对另一个的访问权限。Stripe Projects 会为第三方基础设施服务处理配置、凭证存储和计费。
您如何选择合适的密钥管理工具?
合适的选择取决于您的基础设施。
几个问题可以快速缩小选择范围:
它能与您的身份提供商集成吗? 一个无法对照您现有的身份和访问管理(IAM)或单点登录(SSO)设置进行身份验证的系统,会增加要管理的第二个身份系统。这通常意味着较弱的访问控制。
它是否支持您所使用服务的自动轮换? 常见数据库和云服务的原生轮换可以省去您自己构建和维护轮换脚本的手动工作。
它能强制执行短期的、设定作用域的凭证吗? 静态的、长期的密钥正是您试图摆脱的模式。只存储值而不发布动态值的系统只解决了一半的问题。
它能生成您实际可以使用的审计日志吗? 如果记录访问的日志没有足够的细节来还原事件,那么在您需要时它们也起不到太大作用。
它如何处理您的 AI 工具需要的密钥? 如果代理或自动化工作流请求凭证,请检查系统是否可以独立于人员访问对其设定作用域和过期时间。
Stripe Projects 如何提供帮助
Stripe Projects 允许开发者及其 AI 代理从命令行界面(CLI)添加服务、生成凭证并管理计费。
Stripe Projects 可帮助您:
从命令行预配第三方服务:使用单一工作流来添加服务、管理凭据以及升级方案,而不需要为每个服务商使用不同的工具和工作流。无需管理平台、配置文件或基础设施代码,即可管理托管、数据库、授权、AI 及其他功能。
自动同步凭据:让环境变量在本地设置、机器、团队成员和代理之间保持可移植性——无需复制粘贴应用程序编程接口 (API) 密钥。
从 CLI 或您的编码代理管理计费:只需设置一次计费详细信息,即可安全地将其与第三方服务共享。从 CLI 升级和降级层级、监控用量以及管理订阅。
了解有关 Stripe Projects 如何帮助简化应用预配的更多信息,或者立即将此命令复制并粘贴到您的终端以开始使用:
brew install stripe/stripe-cli/stripe && stripe plugin install projects && npx skills add https://github.com/stripe/ai --skill stripe-projects -y -g
本文中的内容仅供一般信息和教育目的,不应被解释为法律或税务建议。Stripe 不保证或担保文章中信息的准确性、完整性、充分性或时效性。您应该寻求在您的司法管辖区获得执业许可的合格律师或会计师的建议,以就您的特定情况提供建议。