Developer ID Certification Authority 2026:证书迁移验收清单
先核实 Developer ID 证书的签发机构,再为受影响的签名身份替换 G2 证书,并分别复验 App 与 .pkg;若旧证书签名的 .pkg 仍在分发,应在 2027 年 2 月 1 日前重签。只要现有 Mac App 已带安全时间戳并完成公证,Apple 表示它会继续可用;但未来更新要换用新证书。
适合独立分发 macOS App、需要判断现有签名身份是否受影响的开发者。
也适合维护 .pkg 安装包,或在远程 Mac、自动化任务中执行签名的小团队。
最后更新于 2026 年 10 月 3 日;日期、证书识别方式及交付物影响已对照 Apple 到期公告 与证书替换说明核验。
证书迁移验收的判定指标
不要只看证书显示名称或到期日。Apple 指出,账户页面中到期日为 2027 年 2 月 1 日或更早的 Developer ID 证书“可能”受影响;最终要核对证书签发者,并把账户记录与钥匙串中的证书对应起来。证书名称可能相同,到期日只能用于初筛,不能代替签发机构判断。
| 核验对象 | 应查看的证据 | 判定与动作 |
|---|---|---|
| Developer ID Application、Developer ID Installer | 开发者账户中的证书条目;钥匙串访问中该证书的 Issuer Name / Organizational Unit | 到期日只作初筛;打开你自己的证书检查签发者 |
| 旧 Sub-CA 证书 | 证书颁发机构的组织单位显示为 Apple Certification Authority | 按旧 Sub-CA 身份登记受影响项,安排替换 |
| G2 证书 | 证书颁发机构的组织单位显示为 G2 | 属于当前 G2 Sub-CA;记录证据并确认实际签名任务调用的是它 |
| 钥匙串中的 Developer ID Certification Authority 条目 | 该条目本身是 CA,而不是你的签名证书 | 不要误把 CA 条目的 Apple Certification Authority 字样当成个人签名证书的判定结果 |
核验时应选中 Developer ID Application 或 Developer ID Installer 自身,展开签发者信息,再检查 Organizational Unit。不要只在钥匙串里搜索名称,也不要仅凭一张证书到期较晚就认定它来自 G2;同名证书可以来自不同 Sub-CA。Apple 的证书替换说明以检查本人证书签发者作为确认办法,而不是依据名称推断。
旧 Sub-CA 签发身份的辨认
在钥匙串访问中打开对应的签名证书,查看 Issuer Name 下的 Organizational Unit:显示 Apple Certification Authority 表示由旧 Sub-CA 签发;显示 G2 表示来自当前 Sub-CA。核对对象必须是 Developer ID Application 或 Developer ID Installer 证书本身,而不是钥匙串中名为 Developer ID Certification Authority 的 CA 条目。
如果你仍不能将账户中的条目与本机证书可靠对应,结论应先标为“待确认”,不要仅因证书名称相同或到期时间晚就继续发布。账户列表与本机签名环境可能分离:一份证书已下载,并不代表执行构建的那台 Mac 拥有对应私钥。
交付物影响范围
受影响的 App 与安装包不能按同一套规则处理。Apple 在 2026 年 10 月 1 日的公告明确了旧 Sub-CA 到期后的影响:旧证书会停止工作;旧证书签名的 .pkg 自 2027 年 2 月 1 日起将无法安装,而已经安全时间戳并完成公证的现有 Mac 软件会继续可用。
| 交付物 | Apple 已确认的影响 | 验收动作 |
|---|---|---|
| 已签名、公证且带安全时间戳的现有 Mac App | 继续可用,无需仅因本次 Sub-CA 到期而重签 | 归档现有版本的公证与时间戳证据;不要把它与未来更新混为一谈 |
| 未来发布的 App 更新 | 应改用新证书,并为公证流程包含安全时间戳 | 用新身份重新签署更新版本,复查签名与公证结果 |
| 旧证书签名的 .pkg | 自 2027 年 2 月 1 日起无法安装 | 使用有效的 Developer ID Installer 身份重签,并在截止日前验证最终安装包 |
现有 App 的继续使用条件
如果旧 App 已有安全时间戳并完成公证,Apple 对本次到期的明确结论是它会继续工作,无需只为 Sub-CA 迁移重签;后续更新则应使用新证书,并包含安全时间戳。若旧 App 不满足这些条件,不能直接套用“继续可用”的结论,应先查该版本自己的签名、公证状态和分发情形。
.pkg 安装包的截止日期
Apple 指定的日期是 2027 年 2 月 1 日。旧证书签名的 .pkg 应在此前完成重签与验收;重签不等于只改包名或重新压缩,必须检查最终 .pkg 内实际使用的签名身份。
签名身份覆盖范围
Developer ID Application 与 Developer ID Installer 服务于不同交付物,不能互相替代:前者用于签 Mac App,后者用于签 Installer Package。Apple 的Developer ID 证书说明也将两类证书分开说明;若团队两种产物都发布,就应分别盘点、替换和验收。
| 证书类型 | 典型签名对象 | 迁移时的检查重点 |
|---|---|---|
| Developer ID Application | .app、命令行工具及其他需要 Developer ID 签名的代码 |
更新构建配置中选用的应用签名身份,并检查最终 App |
| Developer ID Installer | .pkg 安装包 |
单独建立新身份;检查包签名并确认安装验证通过 |
| 两种证书均在使用 | App 与包含 App 的安装包 | 分别签名、分别保留命令输出;不能以 App 签名通过推断 .pkg 也已迁移 |
创建替代证书时,在账户的证书创建流程中选择正确类型;如果出现 Developer ID Certificate Intermediary 选项,应选择 G2 Sub-CA。Apple 提醒,选择其他选项可能仍签发来自即将到期机构的证书。Apple 账户页面确认类型与中介选项后,还应回到新证书本身检查签发者;仅完成下载并不足以验收。
本地与远程签名环境
迁移常卡在“证书已经创建,但真正执行构建的身份没有可用私钥”。证书文件包含公钥信息,实际签名还要求执行环境能访问匹配的私钥;GUI 手动归档、SSH 会话与自动任务也可能使用不同用户或不同钥匙串。Apple 关于签名证书与钥匙串搜索范围的技术说明 TN3161解释了这些身份检查边界。
| 执行路径 | 必核对项 | 失败时先做什么 |
|---|---|---|
| 本地图形界面 | 证书在当前用户的钥匙串中;My Certificates 下能看到带私钥的身份;Xcode 选中预期团队与签名身份 | 确认私钥是否匹配,重新打开项目并明确选择新身份 |
| SSH 会话 | SSH 登录的用户、默认钥匙串与 GUI 是否一致;该会话能否列出新身份 | 以同一执行用户检查钥匙串;不要假设 GUI 已导入就代表 SSH 可见 |
| 自动化任务或远程 Mac | 任务实际运行账户、钥匙串解锁状态、构建配置指定身份、日志中的签名主体 | 记录任务身份和证据;如私钥不可用或身份不明,暂停发布结论 |
远程环境尤其要避免把“可以登录机器”误当成“可以签名”。访问方式、钥匙串权限、凭据导入与任务运行身份,都需按具体环境核对;不同远程环境的凭据交付方式未必相同。若团队要先确认远程 Mac 的访问和使用边界,可查看KuzCloud 帮助与使用说明,不要假设服务会代管证书或替开发者签名。
最终产物验收与就绪判定
下面的步骤按“证据—判断—失败动作”执行。签名命令应对最终准备分发的产物运行,而不是只对中间构建目录或旧归档执行。
- [ ] 盘点交付物与当前身份。 列出所有仍在分发的
.app、更新渠道和.pkg;分别记录 Developer ID Application、Developer ID Installer 的证书条目、签发者、到期日和实际构建任务。账户页面到期时间可用于筛查,但签发者证据才决定是否属于旧 Sub-CA。 - [ ] 检查钥匙串中的真实身份。 在目标执行 Mac 上打开证书详情,确认新证书的 Organizational Unit 为 G2,并确认它与对应私钥组成可用签名身份。若看不到私钥、账户与钥匙串证书无法对应,先停在“未就绪”。
- [ ] 创建正确类别的替代证书。 App 使用 Developer ID Application,安装包使用 Developer ID Installer;若两类都发布,就分别申请和测试。创建时选择 G2 Sub-CA,并在证书下载、导入后复核签发者,不能只以账户页面创建成功作为通过条件。
- [ ] 让真实执行任务发现新身份。 在图形界面、SSH 和自动任务各自的运行身份下检查可见签名身份。把
security find-identity -v -p codesigning的输出与构建日志保存到迁移记录中;如果任务选出的仍是旧身份,更新项目签名设置、脚本参数或钥匙串访问配置后再跑一次。 - [ ] 对 App 更新验收签名与时间戳。 对准备发布的最终
.app执行codesign --verify --deep --strict --verbose=2 /path/to/App.app,再用codesign -dvv /path/to/App.app查看签名详情与时间戳。Apple 的常见公证问题排查文档提供了这些签名检查方法,并指出自定义签名流程需留意安全时间戳;若需公证,继续按实际分发流程提交并检查结果。 - [ ] 对 .pkg 单独验收。 对最终安装包执行
pkgutil --check-signature /path/to/Installer.pkg,保存显示签名身份和可信时间戳的输出;随后按发布渠道完成安装测试。Apple 的公证前准备文档覆盖安装包等不同提交对象。 - [ ] 形成可复查的放行记录。 记录旧身份盘点、新 G2 身份证据、实际任务运行账户、最终 App 与 .pkg 的命令输出、公证记录,以及后续证书年度续期责任人。Apple 公告说明 G2 颁发的证书仍需按年更新,因此本次迁移完成并不代表之后无需续期。
迁移就绪只在三项都成立时判定:受影响身份已确认;需要替换的证书已核实为 G2 且私钥可用;最终交付物由预期任务使用新身份签名并完成相应验证。任何一项仍不明确,特别是构建仍调用旧证书或 .pkg 未做最终检查,就应暂停“已迁移”结论。
本次迁移不是要求所有旧 App 一律返工,而是要求把未来更新和安装包分开验收。手头若只有一台本地 Mac,持续占用它做签名可能带来设备维护、多人排队和自动任务与日常工作互相干扰等成本;远程 Mac 也需要妥善管理钥匙串、私钥权限和运行身份,不能把远程访问等同于凭据托管。若只需在独立环境完成一轮证书导入与签名复验,按需使用 Mac 比为临时任务长期维护专用机器更灵活;若签名负载长期稳定,或必须连接特定物理设备,则应先比较自购与远程方案的总成本和接口需求,可参考KuzCloud 的方案与计费信息。需要临时 Mac 环境时,可进一步了解 KuzCloud 远程 Mac 的访问说明,再按自己的证书管理要求决定是否适用。
在 KuzCloud 上完成证书迁移实机验收
租用专属 Mac mini M4,在真实 macOS 环境中构建并检查签名产物,确认 G2 身份已生效。
物理独占并开放完整 root 权限,可按需配置签名工具链,适合独立分发与自动签名任务。