创建、轮换与撤销 AccessKey
本页内容
在开发者中心为自己的服务端创建长期 AccessKey,按业务授权,并在更换或泄露后及时撤销。本指南说明从首次创建到日常维护的完整流程。
前提条件
使用自己的平台账号登录开发者中心,完成 API 接入申请。接入获准后,先配置 API 应用,再创建访问密钥。API 应用代表一套接入程序;要管理的 IPA 或 APK 应用是另外的业务资源。
需要网页或手机应用代表用户访问时,先阅读OAuth 与终端接入。长期 Secret 保存在自己的服务端安全配置中。
配置 API 应用
- 进入“管理 API 应用”,创建或选择这套程序对应的 API 应用,填写便于识别的名称与用途。
- 按本次业务勾选动作。例如先用 ReadApps 查询列表;要上传版本时,再授予对应产品的 UploadVersions。不同产品分别授权。
- 选择自己的业务应用范围。仅操作几个应用时,填写这些应用的完整 ID;创建新应用所需的范围和动作见对应创建接口。
- 按需要配置来源 IP 与请求额度。IP 使用程序的实际出口,付款等操作还会检查更严格的来源条件。
账号获准使用某项功能、API 应用勾选动作、目标应用处于授权范围,三者需要同时满足。拒绝规则和已收回的许可仍会生效。完整说明见访问权限与资源 ID。
创建并保存密钥
- 在“访问密钥(AccessKey)”选择“创建 AccessKey”,确认所属 API 应用与有效期,并按页面要求验证操作。
- 创建成功后,将 AccessKey ID 与 Secret 一起保存到自己的受保护配置。Secret 只在创建成功时展示一次,遗失后需创建新密钥。
- 在服务端注入 SDK 所需环境变量。验证时仅检查配置是否存在,不打印 Secret。
同一 API 应用的长期密钥继承该应用当前的权限。修改应用权限会影响其密钥及相关授权,因此建议按程序用途分开管理。
确认首次调用
先按快速入门执行当前身份查询,再查询一个已授权应用。核对账号、动作与资源范围;保存 request_id 供排查。读取正常后,再执行已经确认的写入业务。
列表为空时,确认账号下是否有对应产品的应用,以及列表是否显式选择了正确 module。401 先核对密钥、域名和时钟;403 或 404 再核对功能许可与应用范围。
轮换密钥
- 为同一 API 应用创建新密钥。每个 API 应用最多保留两把有效长期密钥,可用于更换期间的交接。
- 把新 ID 与 Secret 作为一组更新到所有调用程序。确认应用配置已重新加载,并用新密钥完成一次只读查询。
- 检查仍在运行的任务和其他调用方,确认切换完成后再撤销旧密钥。
基于旧父密钥签发的临时凭据或 OAuth 授权也会受撤销影响,需要分别安排重新签发或用户授权。已创建任务的查询与恢复使用原业务 ID;密钥轮换不代表可以重复提交付款、核销或签名。
撤销与排查
在密钥列表选择“撤销”,核对目标 ID 后确认。撤销不可恢复;发生泄露时,应立即撤销并排查相关调用记录,再为需要的程序配置新密钥。
撤销会阻止后续授权请求。已经发出的存储下载链接在剩余有效期内仍可能使用,已受理业务也需查询原记录确认。需要核对资金时,查看原订单和流水。
有效期结束、账号或 API 应用被停用、权限收缩都可能使请求失效。请按接入常见问题逐项核对,避免反复创建密钥掩盖原来的配置问题。