App Store / Google Play · 清单验收 · 不承诺过审Telegram @hagee66

上架通

GOEE LISTING LEDGER

№ ZHgoee.cc
账号归你 · 邀请协作


2026-03-02

证书与签名交接:代上架不碰密钥的正确姿势

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。

配套阅读 AAB 上传、iOS 版本号。

核心做法

资产清单:先盘点再邀请外包

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。

下一步

返回 指南库 · 安全与合规 以官方当前文档为准 · 不承诺过审。