密钥只显示一次:团队如何保管、轮换和撤销 API 密钥
在 SimAggregator 控制台里创建 API 密钥时,密钥字符串只会在屏幕上显示一次。如果没复制就关掉了窗口,这串字符就再也没人能看到,包括我们在内:平台只保存密钥的指纹,不保存字符串本身。丢失的密钥无法找回,只能替换:创建一个新的,再撤销旧的。所以最好趁密钥还没泄露,就提前把轮换和撤销的流程定下来。
每个环境、每个服务单独用一个密钥
密钥以你的账户身份发起操作,花的是账户余额:谁拿到了这串字符,谁就能用你的钱购买号码。如果所有地方共用一个“万能”密钥,一旦泄露,很难查清是从哪里漏出去的,而撤销它又会让所有集成同时中断。
控制台里可以创建多个密钥,并分别命名。我们建议按“环境 + 服务”的方式命名:prod-bot、staging-bot、ci-tests。看名字就知道撤销后哪些东西会停止工作,发现异常调用时该找谁。API 限额是每分钟 600 次请求,按单个密钥计算,所以在 CI 里跑测试不会占用生产服务的请求额度。
CI 这里有个细节:在 CI 中调用 getNumber,会用同一个余额购买真实号码。这类订单至少要等一分钟才能取消。没收到验证码就取消的订单,会拉低近 7 天内收到验证码的订单比例,而账户的同时订单上限是按账户信誉计算的,CI 和生产环境的机器人共用这个上限。做冒烟测试时,一般用 getBalance 和 getPrices 就够了。
密钥字符串存放在哪里
密钥一创建好,就把它存进凭据管理服务,或者存成 CI 的受保护变量,并确保它在日志里会被遮蔽。不要放进代码仓库,不要写进“临时”提交的 .env,也不要发到工作群或工单里。负责开发集成的工程师通常用不到生产密钥的字符串:服务启动时会自己从存储中读取。
API 与 sms-activate 兼容,只接受 GET 请求,所以密钥是放在查询字符串里传递的。请确认 HTTP 客户端、代理和访问日志不会记录完整的请求地址。日志保存时间长,能看到的人也多,密钥一旦进了日志,就应当视为已泄露。
轮换:先创建新密钥,再撤销旧密钥
轮换在控制台里就是两个操作:创建新密钥,撤销旧密钥。按这个顺序来,在服务切换到新密钥之前,旧密钥一直可用,请求不会失败。
- 创建一个新密钥,名称里保留相同的用途,例如
prod-bot-2。 - 在凭据管理服务中用它替换旧值。
- 重启服务,让它加载新密钥。
- 在控制台中确认:新密钥出现了“最近使用时间”,旧密钥的这一时间不再变化。
- 撤销旧密钥。
出现以下情况时,需要做计划外轮换:
- 见过密钥的人离开了团队;
- 密钥出现在日志、截图、聊天记录或代码仓库里;
- 你们换了托管服务商或 CI 平台。
例行轮换,请和你们其他凭据的更换周期保持一致。
按“最近使用时间”做审计
每次发版前,或者复核访问权限时,都打开密钥列表看一看。长时间没被使用的密钥,多半是已关停项目留下的,把它撤销。如果 staging-bot 这个密钥还在被调用,而 staging 机器人一周前就已经停了,那就立即撤销,再去查请求是从哪里来的。名字看不懂的密钥,与其猜它属于谁,不如直接撤销。如果真有人需要它,负责人会从自己的服务上发现问题,然后创建一个名字清楚的新密钥。
保护好账户本身
API 密钥安不安全,归根结底要看账户安不安全:谁登录了控制台,谁就能给自己创建新密钥、花掉余额。所以请开启双因素认证:在“登录”页面可以设置身份验证器应用生成的 TOTP 验证码,修改密码也在这个页面。如果怀疑有外人登录过账户,请退出其他设备上的会话、修改密码,并轮换所有密钥。团队里有能访问控制台的人离开时,也按同样的步骤处理。
第一步,先在“登录”页面开启 2FA。然后在控制台里为 prod、staging 和 CI 分别创建命名清晰的独立密钥,存进凭据管理服务。如果之前有共用的密钥,就把它撤销。