全部文章

密钥只显示一次:团队如何保管、轮换和撤销 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 客户端、代理和访问日志不会记录完整的请求地址。日志保存时间长,能看到的人也多,密钥一旦进了日志,就应当视为已泄露。

轮换:先创建新密钥,再撤销旧密钥

轮换在控制台里就是两个操作:创建新密钥,撤销旧密钥。按这个顺序来,在服务切换到新密钥之前,旧密钥一直可用,请求不会失败。

  1. 创建一个新密钥,名称里保留相同的用途,例如 prod-bot-2。
  2. 在凭据管理服务中用它替换旧值。
  3. 重启服务,让它加载新密钥。
  4. 在控制台中确认:新密钥出现了“最近使用时间”,旧密钥的这一时间不再变化。
  5. 撤销旧密钥。

出现以下情况时,需要做计划外轮换:

  • 见过密钥的人离开了团队;
  • 密钥出现在日志、截图、聊天记录或代码仓库里;
  • 你们换了托管服务商或 CI 平台。

例行轮换,请和你们其他凭据的更换周期保持一致。

按“最近使用时间”做审计

每次发版前,或者复核访问权限时,都打开密钥列表看一看。长时间没被使用的密钥,多半是已关停项目留下的,把它撤销。如果 staging-bot 这个密钥还在被调用,而 staging 机器人一周前就已经停了,那就立即撤销,再去查请求是从哪里来的。名字看不懂的密钥,与其猜它属于谁,不如直接撤销。如果真有人需要它,负责人会从自己的服务上发现问题,然后创建一个名字清楚的新密钥。

保护好账户本身

API 密钥安不安全,归根结底要看账户安不安全:谁登录了控制台,谁就能给自己创建新密钥、花掉余额。所以请开启双因素认证:在“登录”页面可以设置身份验证器应用生成的 TOTP 验证码,修改密码也在这个页面。如果怀疑有外人登录过账户,请退出其他设备上的会话、修改密码,并轮换所有密钥。团队里有能访问控制台的人离开时,也按同样的步骤处理。

第一步,先在“登录”页面开启 2FA。然后在控制台里为 prod、staging 和 CI 分别创建命名清晰的独立密钥,存进凭据管理服务。如果之前有共用的密钥,就把它撤销。

一分钟拿到第一个号码

注册一分钟,充值两分钟,验证码 20 秒到达。

购买号码
没有订阅费第一小时内可取消退款