企业签名概述
本页内容
通过企业签名 API,将自己的 IPA 上传到平台,开通签名服务,生成签名包并查询安装使用情况。本文帮助您了解整个流程,并选择接下来要阅读的操作指南。
功能与流程
企业签名将您上传的 IPA 处理为使用平台可用证书签名的安装包。一次完整操作包括下列步骤。上传、开通服务和签名各自有独立结果,请在每一步成功后再继续。
- 创建应用并上传 IPA
- 开通或续费签名服务
- 选择参数并提交签名
- 下载结果并查看使用情况
API 仅操作当前用户自己账号下已授权的应用,调用范围同时受用户业务权限与 API 应用授权限制。
选择接入方式
| 您的接入场景 | 建议方式 | 从哪里开始 |
|---|---|---|
| 在自己的服务端集成上传、签名和查询 | 使用服务端 SDK,由 SDK 处理请求签名 | 企业签名快速入门 |
| 需要自行实现 HTTP 客户端 | 按 API 参考构造请求并实现 CS1 签名 | 请求签名和接口参考 |
| 从网页、Vue、iOS 或安卓客户端发起业务 | 通过自己的服务端调用,或使用已获批准的 OAuth 授权 | 终端授权接入 |
长期 AccessKey Secret 应保存在服务端。浏览器和手机应用不能用内置长期 Secret 的方式接入。
核心概念
| 概念 | 说明 |
|---|---|
| API 应用 | 开发者中心登记的接入程序,用来配置权限、凭据和回调。 |
| 企业签名应用 | 您要管理的 iOS 应用,包含安装包版本、服务权益和签名任务。 |
| 原包版本 | 上传的 IPA 通过校验后保存的版本,用作签名输入。 |
| 签名包版本 | 一次签名任务成功后生成的版本,用于下载或发布。 |
| 签名权益 | 应用当前的套餐、服务期限、可用证书和安装量限制。上传成功不代表已开通权益。 |
| 幂等键 | 调用方为一次写入操作保存的唯一值。同一操作重试时复用原值,新操作使用新值。 |
开始前
- 完成API 接入配置,用只读请求确认账号与凭据。
- 准备真实 IPA,并确认账号空间、上传大小和企业签名功能可用。
- 按本次业务配置权限和应用范围。例如,只查询列表无需授予付款或删除权限。
按任务阅读
企业签名快速入门本教程使用 Python SDK 和命令行示例,带您完成一次“上传 IPA → 开通服务 → 提交签名 → 取得签名包版本”的流程。完成后,您可以将同样的步骤接入自己的服务端。阅读指南 →
创建与管理企业签名应用企业签名应用是安装包、签名任务、服务权益和统计数据的归属对象。首次上传需要先创建应用;更新同一个应用时继续使用原应用 ID。阅读指南 →
上传与更新 IPA将本地 IPA 保存为企业签名应用的原包版本。上传包括创建任务、传输文件、提交校验和取得版本 ID;取得原包版本后,才能提交签名任务。阅读指南 →
开通与续费签名服务签名服务决定应用可以使用的套餐、有效期和安装量权益。您可以使用账号余额购买,也可以核销已有开通密钥;开通或续费成功后,再单独提交签名任务。阅读指南 →
选择证书与设置签名参数在提交签名前,查看应用可用的证书,并按需要调整包名、Keychain 和插件处理方式。修改参数用于后续签名,已下载或已安装的旧包不会随配置自动改变。阅读指南 →
提交签名与获取结果为已经上传并开通服务的企业签名应用创建签名任务。签名异步执行;请保存任务 ID,等待任务成功,再取得该任务实际生成的签名包版本。阅读指南 →
管理版本与下载签名包原包和签名包分别有自己的版本 ID。本指南说明如何查找版本、申请下载凭证,以及将应用切换到保留的历史签名版本。阅读指南 →
查看安装统计与设备记录查看企业签名应用的安装设备数、启动次数、单版本统计和安装受限记录。先确认统计口径,再使用数据进行业务分析,避免将下载次数或版本安装量误当作应用总设备数。阅读指南 →
退款、扩容与订单对账企业签名订单符合规则时,可以退回原付款账号的站内余额并撤销该笔订单增加的权益。安装量不足时,可另行购买设备额度。本指南分别说明退款、扩容和对账步骤。阅读指南 →
企业签名常见问题按照出现问题的步骤排查:先确认认证和应用归属,再查看上传、开通、签名或下载结果。请求超时后优先查询原记录,避免重复上传、扣款或提交签名。阅读指南 →
首次接入可使用源码包中的 enterprise_upload.py 上传 IPA,再使用 enterprise_signing.py 提交签名。具体准备和执行方法见快速入门。