企业签名快速入门
本页内容
本教程使用 Python SDK 和命令行示例,带您完成一次“上传 IPA → 开通服务 → 提交签名 → 取得签名包版本”的流程。完成后,您可以将同样的步骤接入自己的服务端。
前提条件
- 已在开发者中心创建 API 应用和长期 AccessKey,且账号已获准使用本教程涉及的业务功能。
- 已准备 Python 3.10+ 和真实 IPA,账号有足够的上传空间。需要付费开通时,请先确认余额与付款预算。
- 已下载Python SDK 与企业签名示例,将源码包解压到自己的私有工作目录。保留
cloudsign/、enterprise_upload.py和enterprise_signing.py的相对位置。
本教程所需权限
新建与上传需要 enterprise:CreateApps、enterprise:UploadVersions,上传工具还使用 enterprise:ReadApps。签名工具需要 enterprise:ReadApps、enterprise:ReadVersions、enterprise:CreateJobs 和 enterprise:ReadJobs。查询权益、开通、选择证书及下载还需各自权限,见对应操作指南。新应用的授权范围需包含未来创建的自有应用。
步骤一:配置接入环境
在服务端安全配置中设置下列环境变量。凭据从自己的开发者中心取得,不能写入脚本、源码仓库、网页或手机应用。
| 环境变量 | 填写方式 |
|---|---|
CLOUDSIGN_BASE_URL | https://www.onesignios.com。Python SDK 使用,包含 HTTPS 协议,不带路径。 |
CLOUDSIGN_HOST | www.onesignios.com。本教程两个命令行工具使用,仅填网站主机名。 |
CLOUDSIGN_ACCESS_KEY_ID | 自己的长期 AccessKey ID。 |
CLOUDSIGN_ACCESS_KEY_SECRET | 与该 ID 对应的 Secret。 |
先在解压目录中保存并运行下面的只读代码。返回的账号 ID 应与预期一致。其他语言的准备方法见SDK 使用说明。
import os
from cloudsign import Client
client = Client(
os.environ["CLOUDSIGN_BASE_URL"],
os.environ["CLOUDSIGN_ACCESS_KEY_ID"],
os.environ["CLOUDSIGN_ACCESS_KEY_SECRET"],
)
identity = client.get_identity()["data"]
print(identity["owner_id"])步骤二:上传第一个 IPA
在同一目录执行下面的命令。工具读取应用名称和 Bundle ID,创建企业签名应用,然后分片上传并等待校验。请为这次操作使用一个新的状态文件名。
python enterprise_upload.py new app.ipa --state first-upload.json输出的 state=succeeded 且 version_id 非空时,上传成功。保存 app_id 和 version_id,下一步使用它们开通服务与签名。网络中断时保留原文件和状态文件,执行恢复命令:
python enterprise_upload.py resume app.ipa --state first-upload.json更新已有应用时无需再次创建应用,具体方法见上传与更新 IPA。
步骤三:开通签名服务
查询应用当前权益。已经开通并仍然有效时,可以继续签名;尚未开通或需要续费时,选择余额购买或开通密钥。
def read_entitlement(client, app_id):
data = client.get_signing_entitlement(app_id)["data"]
limit = data["installation_limit"]
# unlimited 表示是否不限安装设备数;maximum_devices 是当前上限。
return {
"state": data["state"],
"plan_name": data["plan_name"],
"expires_at": data["sign_expires_at"],
"unlimited": limit["unlimited"],
"maximum_devices": limit["maximum_devices"],
"statistics_state": data["statistics_state"],
}上方定义了 read_entitlement 函数,使用自己的应用 ID 调用。余额购买需先展示报价并确认扣款;密钥开通需确认不支持退款。按开通与续费指南完成后,重新查询当前权益。
步骤四:提交并查询签名
将占位值替换为步骤二返回的完整应用 ID 和原包版本 ID,再执行命令。示例不会自动购买套餐。
python enterprise_signing.py start --app "<应用ID>" --source "<原包版本ID>" --state first-signing.json工具保存签名任务 ID 后等待结果。中断时使用原状态文件恢复,不要再次执行 start 创建重复任务。
python enterprise_signing.py resume --state first-signing.json确认结果与下一步
当 status=succeeded、result_state=available 且返回签名包 version_id 时,本次签名成功。这个版本 ID 与上传得到的原包版本 ID 不同。
继续阅读管理版本与下载签名包获取文件。需要改用其他语言时,各接口页提供 PHP、Java、Go、C、Rust、Python 和 Node.js 示例,调用步骤相同。