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

企业签名快速入门

本页内容

本教程使用 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_URLhttps://www.onesignios.com。Python SDK 使用,包含 HTTPS 协议,不带路径。
CLOUDSIGN_HOSTwww.onesignios.com。本教程两个命令行工具使用,仅填网站主机名。
CLOUDSIGN_ACCESS_KEY_ID自己的长期 AccessKey ID。
CLOUDSIGN_ACCESS_KEY_SECRET与该 ID 对应的 Secret。

先在解压目录中保存并运行下面的只读代码。返回的账号 ID 应与预期一致。其他语言的准备方法见SDK 使用说明。

Python 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。

步骤三:开通签名服务

查询应用当前权益。已经开通并仍然有效时,可以继续签名;尚未开通或需要续费时,选择余额购买或开通密钥。

Python SDK
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 示例,调用步骤相同。

相关接口