跳转到主要内容
1签 (OneSign)

访问权限与资源 ID

本页内容

为接入程序选择合适的认证方式,只授予完成业务需要的动作和自有应用范围。本指南同时解释 API 应用与业务应用,以及常见资源 ID。

选择认证方式

方式适用场景接入说明
长期 AccessKey(AKP)自己的服务端、定时任务和后端集成按 CS1 签名调用,只能使用已经授予的能力。
临时 AccessKey(AKT)向另一个服务交付一个应用的限时只读查询同时使用 ID、Secret 和安全令牌,详见临时凭据。
OAuth Bearer第三方网页、Vue 和移动端由用户选择应用并同意权限,详见OAuth 接入。

网站登录 Cookie 不能代替 API 凭据。沙箱 AKS 仅用于模拟环境;公开下载页面是否允许访问,按发布者的下载设置执行。

辨认应用与资源 ID

API 应用代表接入程序,业务应用代表要管理的企业签名或分发应用。请保存接口返回的完整 ID,不使用列表中的截短显示值。

ID从哪里取得用来做什么
API 应用 ID开发者中心管理这套程序的授权、凭据、预算和通知。
应用 ID(A 开头)应用列表或应用创建响应指定要管理的业务应用。
版本 ID(V 开头)上传成功、版本列表或签名任务结果指定签名输入、下载或发布版本。
上传任务 ID(U 开头)创建上传任务响应确认分片、提交校验及恢复原上传。
签名任务 ID(J 开头)提交签名响应查询该任务状态及准确产物。
报价 ID / 订单 ID报价和付款回执分别查询报价或处理原订单,不能互换。
revision / cursor对应读取接口原样带回,用于并发检查或继续分页。

具体前缀与格式见接口字段约束。原包和签名包有各自的版本 ID,下载签名结果使用该任务返回的 signed_version.id。

相同前缀也可能用于不同业务。例如密钥核销回执与 Webhook 事件都可能使用 E 开头的标识;它们由不同接口返回,不能互换。请同时保存资源类型、业务应用与完整 ID,按照取得该 ID 的接口说明使用。

按任务配置权限

  1. 选择实际需要的业务,例如只查询应用、上传新版本或确认付款。
  2. 在开发者中心为 API 应用勾选相应动作,限定到自己的应用范围。创建新应用时,范围需要覆盖未来创建的自有应用。
  3. 按功能要求配置来源 IP、有效期和预算,并完成对应业务接入申请。

读取权限不包含写入权限。比如 billing:ReadOrders 只用于查订单,不能付款;列出证书不包含选择证书权限。所有权限仍受当前用户本人业务能力约束。

验证授权结果

调用 查询当前身份与权限核对当前账号、动作和资源范围,再查询一个已授权应用。没有权限或应用不属于当前账号时,接口可能返回 403 或 404,不应通过更换 ID 反复尝试。