证书与签名交接:代上架不碰密钥的正确姿势
iOS 证书/描述文件与 Android 签名密钥归属原则;协作方只拿上传权限不拿私钥。降低账号资产风险。Telegram @hagee66。
官网传送门(可直接点击跳转)
打开本文 · 指南库 · 苹果上架 · 谷歌上架 · 双端上架
Telegram 询价 @hagee66 · 官网 goee.cc
上架事故里,有一种特别难挽回:Distribution 私钥、p12、Play 上传 keystore 或 .jks 在五个人的网盘里漂流。半年后证书过期,没人知道当初谁生成;更严重的是,泄露的签名意味着别人能向商店推 同名包——用户信任与品牌一次击穿。代上架的正道是:客户持有根密钥,协作方持有 Connect/Console 流程权限或只读上传通道,必要时用 CI 中间层,而不是把「签名文件夹」打成 zip 发微信。
上架通(goee.cc)梳理 iOS 与 Android 签名资产台账、推荐交接拓扑、与 ASC 角色、Play 用户 的配合。苹果、Google 对 Play App Signing、证书类型、API 上传的规定会更改,以官方当前文档为准。我们不代收客户私钥,不承诺保管证书。
这篇要解决的问题
签名协作里典型悲剧:
- 外包在本地 Mac 生成 iOS 证书,离职带走,客户无法续签。
- p12 密码写进提审备注(真实发生过)。
- 把 upload key 与 app signing key 混为一谈,轮换 upload key 后 CI 全线挂。
- 代上架要求远程桌面登录客户 Mac「帮忙签名」。
- 测试证书误用于生产包。
- 多环境共用一个 keystore,测试广告 SDK 钥泄漏连累生产。
本文给「谁能拿什么、不该拿什么」的清单,并挂到 代上架交接。
谁应该读
- 客户技术负责人 / 研发经理:签名资产第一责任人。
- CI 平台管理员:管理密钥库、Xcode Cloud、fastlane match 等。
- 代上架项目经理:拒绝接收私钥,改用流程权限。
- 法务与采购:合同写明密钥归属与泄露责任。
- 一人公司开发者:更要分清备份与 2FA。
核心做法
资产清单:先盘点再邀请外包
iOS 常见资产
| 资产 | 谁应持有 | 协作方能否碰 |
|---|---|---|
| Apple Developer Program 付费关系 | Holder | 否 |
| Distribution Certificate 私钥 | 客户安全存储 | 否(除非客户自有 HSM 策略授权) |
| Development 证书 | 研发团队 | 视团队 |
| Provisioning Profiles | 可 CI 自动生成 | 可共享只读导出 |
| App Store Connect API Key (p8) | 客户 CI | 可限权子 Key |
| APNs / 推送证书或 Key | 客户后端 | 通常不给代上架 |
Android 常见资产
| 资产 | 谁应持有 | 协作方能否碰 |
|---|---|---|
| Play App Signing 应用签名密钥 | Google 托管(若启用) | 客户不直接拿,但要知道是否启用 |
| Upload key / keystore | 客户 | 否 |
| Play API 服务账号 JSON | 客户 CI | 限权 |
Firebase google-services.json |
按项目 | 敏感配置单独管理 |
台账模板见下文「可复制模板」。
推荐拓扑三种
拓扑 A:客户 CI 上传,代上架只做 Console
- 研发 pipeline 产出 signed IPA/AAB。
- 代上架 App Manager / Play 发布权限选构建提审。
- 优点:私钥不出客户边界。
- 适合:有成熟 CI 的团队。
拓扑 B:客户本机签名,代上架只读 + 屏幕共享指导
- 签名在客户控制的 Mac 上完成。
- 代上架不登录客户 Apple ID,不拿屏幕长期控制。
- 适合:小团队偶发发版。
拓扑 C:fastlane match / 云 HSM
- 证书在加密 repo 或 HSM,CI 拉取签名。
- 访问 match 的人员名单客户审批。
- 代上架人员默认不在 match 访问组。
禁止拓扑:私钥 zip 交接、顾问个人 Mac 上的 Production 证书。
iOS 实务要点
- 证书临期前 90 天 进入轮换项目;谁有权限创建新 Distribution,写入 runbook。
- 使用 Xcode Automatic 时,也要知道 哪台 Mac 持有 signing identity,别多台互相同步乱套。
- TestFlight 与生产同证书链;调试包不要给消费者侧测试员当「准生产」。
- API Key 可细权限;用于上传的 Key 与用于财务报告的 Key 分离。
提审材料与证书无直接关系,但包必须对应正确 profile,见 App Store 材料。
Android 实务要点
- 确认是否启用 Play App Signing;新应用默认策略以后台为准。
- Upload key 泄露要按官方流程 申请轮换,不是随便新建包名逃避。
- AAB 体积与签名无关但上传失败常误判为签名,见 AAB 文。
- 内部测试轨道也应使用同一 upload 链,避免「测试 keystore 上了生产轨道」。
合同与保密
代上架合同建议含:
- 客户保留全部签名与商店账号最终控制权。
- 协作方不得复制、转发、存储私钥副本。
- 泄露通知时限与责任。
- 结束协作后删除本地任何构建工件。
上架通标准:不索要密码、不收私钥;若客户强塞私钥,应拒绝服务或改拓扑 A。
与权限页的闭环
签名能解决「包是谁发布的」,ASC / Play 用户 能解决「谁能在后台点发布」。两边都最小化:
能签名的人 ⊂ 公司研发
能点生产的人 ⊂ 公司技术负责人或书面授权代上架
代上架 ∉ 能签名的人(默认)
灾难恢复
客户应能 在没有代上架的情况下 发一版热修:
- 每年演练一次:从备份恢复 keystore / 证书,CI 打测试包。
- Holder 与备份 2FA 可恢复。
- 文档位置:密码管理员 + 离线券。
可复制模板
签名资产台账
平台: iOS / Android
Bundle / Package:
证书类型 / Keystore 别名:
到期日:
存放位置(HSM/密码库路径):
有权访问人员:
上次轮换:
Play App Signing: 是/否
Upload Key 指纹(如适用):
CI 上传: 是/否,系统名:
禁止外传: 已签字
代上架交接签名章节
签名方式: 拓扑 A/B/C
私钥是否离开客户环境: 否(必须)
代上架权限: ASC ___ / Play ___
构建交付物: signed artifact 由谁上传
事故联系人:
协作结束: 密钥无新增副本确认签字
常见误区
| 误区 | 后果 | 改法 |
|---|---|---|
| p12 发群 | 泄露 | 密码库 |
| 顾问 Mac 签名 | 失联卡死 | 拓扑 A |
| 混用测试证书 | 拒审或更新失败 | 环境分离 |
| 不备份 keystore | 永久无法更新同名 App | 离线备份 |
| API Key 当私钥 | 权限过大 | 分拆 Key |
| 密码写备注 | 审核也能看到 | 禁止 |
问与答
客户完全没有 CI,代上架能代签名吗?
可短期用拓扑 B 指导客户本机签;不把 Production 私钥留给顾问机器。
fastlane match 密码丢了?
按 match 恢复流程;严重时可新建证书,影响所有已装 Test 用户时需沟通。
Play 丢了 upload keystore 还能更新吗?
走官方重置 upload key 流程,以当前政策为准,周期可能数天。
内部多人开发如何用 Development 证书?
可以,但 Development 不能替代 Distribution 上架。
上架通收密钥吗?
不收。流程与权限咨询 Telegram @hagee66。
下一步
- 苹果权限:ASC 角色
- Play 权限:Play Console 用户
- 总交接:代上架协作清单
- 账号:开发者账号搭建
- AAB:AAB 上传与体积
返回 指南库 · 安全与合规 以官方当前文档为准 · 不承诺过审。