从 p12 证书导出 iOS App 备案要的公钥和 SHA-1 指纹
iOS App 上架前要做工信部的 App 备案,填到一半常卡在两个字段:应用的公钥,和证书的 SHA-1 指纹。备案系统不会告诉这两样从哪来,它们都在给 App 签名的那张发布证书(.p12)里。下面是我常用的两种取法,一种用 openssl 命令,一种在 Appuploader 的信息查看器里拖一下直接复制,Windows 上没有 Mac 钥匙串也能做。
先弄清这两样是什么
证书里存着一对非对称密钥,公钥是能公开的那一半;SHA-1 指纹是对整张证书算出的一段哈希摘要,相当于证书的身份标识,证书内容变一点,指纹就完全不同。备案系统拿公钥和指纹核对你上架 App 的签名身份,确认这个包确实出自你登记的主体,防止别人冒用你的名义分发应用。所以填错证书,等于把别的身份报了上去。
先确认要哪张证书
备案填的公钥和指纹,要和你实际上架的 App 对得上,用的是发布证书(Apple Distribution),不是开发证书。打包时给 ipa 签名的是哪张证书,就取哪张的公钥和指纹。取错成开发证书,或者取了一张没用于这个包的证书,备案信息和线上包对不上,后续核验容易被打回。
p12 文件里装着这张证书和它配套的私钥。手里只有 .cer 没有 p12 的,先补成带私钥的 p12 再往下走。
用 openssl 从 p12 里取
装了 openssl 的(macOS、Linux 自带,Windows 用 Git 附带的那份就行),两三条命令够了。
先把证书从 p12 里剥出来:
openssl pkcs12 -in distribution.p12 -clcerts -nokeys -out cert.pem
输入 p12 密码,得到 cert.pem。从它取 SHA-1 指纹:
openssl x509 -in cert.pem -noout -fingerprint -sha1
输出形如 SHA1 Fingerprint=9C:2F:4A:...,去掉冒号就是备案要填的那串。再取公钥:
openssl x509 -in cert.pem -noout -pubkey
得到 -----BEGIN PUBLIC KEY----- 开头的一段 PEM,整段填进备案的公钥栏。
命令都能跑通,我嫌麻烦的是几个细节:p12 密码记错就报错,Windows 上要先把 openssl 准备好,取出来的指纹带着冒号还得手动清一遍。
在 Appuploader 的查看器里直接复制
命令行嫌麻烦的时候,我一般直接用 Appuploader 的「证书与安装包信息查看」。把 distribution.p12 拖进去,它会把这张证书拆开显示:公钥(含 RSA 位数)、SHA-1 和 SHA-256 指纹、序列号、有效期、Team ID,以及私钥是否和证书匹配。备案要的 SHA-1 和公钥 PEM 旁边就有复制按钮,点一下填过去,不用再处理冒号和格式。
它还能把公钥、私钥导成 PEM 文件。遇到私钥和证书对不上的 p12,这里会直接标出来:这种 p12 拿去签名也会失败,备案前在查看器里先查出来,省得上传后才发现。

顺便核一下 ipa 和描述文件
备案除了证书,有时要确认线上包究竟用哪张证书签的。把打好的 ipa 拖进同一个查看器,能看到它实际使用的签名证书、内嵌的描述文件和包含的设备 UDID;拖 mobileprovision 则能看 Bundle ID、证书、设备清单和有效期。拿这些和你备案填的证书对一下,确认指纹来自同一张。
常见问题
Q:备案填的是 SHA-1 还是 MD5 指纹?
以你用的备案平台要求为准,常见的是 SHA-1。Appuploader 查看器里 SHA-1、SHA-256 都列了;openssl 把参数换成 -md5、-sha256 也能取其他算法。
Q:开发证书的指纹能用吗?
不建议。备案要和实际上架的发布包对应,用打包签名的发布证书(Apple Distribution)那张。
Q:证书重新生成后要重新填吗?
证书换了,公钥和指纹就变了。线上包如果换成新证书签名,备案信息要相应更新,和实际在架版本保持一致。
Q:证书快到期了,指纹会受影响吗?
指纹绑定的是具体这张证书。证书到期换新的,或者吊销重签,公钥和指纹都会跟着变。续期、重签之后记得回头把备案信息同步成新证书的。
Q:没有 Mac 能完成这步吗?
能。openssl 在 Windows、Linux 上都有,Appuploader 本身也是 Windows、Linux、macOS 都能用,取证书公钥和指纹不需要 Mac 和钥匙串。
和 Mac 钥匙串的做法对比
同一件事,三条路各有适用场合。
- Mac 钥匙串:有 Mac 的话钥匙串里能看到证书,但复制公钥、算指纹仍要配合 openssl,步骤比较分散。
- openssl 命令:跨平台、能写进脚本,适合批量或接自动化;代价是装环境、记 p12 密码、手动清格式。
- Appuploader 查看器:拖入即看,SHA-1 和公钥 PEM 一键复制,还顺带校验私钥匹配;适合偶尔取一次、不想开命令行的场景。
备案这步,一个项目做一两次也就够了,怎么快怎么来。
我自己取之前一定先确认一件事这个p12,是不是上架包实际签名用的那个。指纹和线上版本对不上,备案就算提交过去,后续核验也可能被退回来。

浙公网安备 33010602011771号