一、先纠正一个常见误解
很多教程把这一步写成"从手机 App 里提取 TOTP 种子"。这个方向是错的:
- SimplySign 手机 App 的种子存在安全区,正常途径取不出来;
- 尝试 dump 密钥库、抓包解数据库,属于绕过厂商安全设计——不稳定,也不合规,换版本就失效;
- 真正可行的做法是:种子每次下发时都在你面前出现过一次,只是很少人当场接住。
结论一句话:在 resetseed 激活页生成二维码的那一刻,把内容读出来存档。
二、链路全貌
证书签发完成(SimplySign 虚拟卡已挂载) │ ┌────────────────┴────────────────┐ │ Asseco 发出两封邮件(24h 有效) │ │ ① 6 位激活码 ② resetseed 激活链接 │ └────────────────┬────────────────┘ ▼ 浏览器打开 resetseed 页 粘贴 6 位激活码 → 提交 │ ▼ 页面显示 "Your new QRCode" ← 本次下发的新种子 │ ┌────────────────────┴────────────────────┐ │ │ 手机 SimplySign 扫码 解码工具读取二维码 (绑定设备、开始出 6 位码) (zbarimg / pyzbar) │ │ │ otpauth://…?secret=BASE32 │ │ └────────────────────┬────────────────────┘ ▼ oathtool / pyotp 与手机同刻比对(先验证,再入库) │ ▼ CI Secret:CERTUM_EMAIL + CERTUM_OTP │ ▼ ssign(或自建出码脚本)→ 触发 Desktop 会话 → signtool │ ▼ 签名 + RFC3161 时间戳 → 验签门禁 → 分发三、签发后会收到哪两封邮件
发件人:
simplysign@assecoce.pl(Asseco Data Systems / Certum 体系)。两封缺一不可。邮件标题 | 内容 | 作用 |
Activation code to activate / regain your SimplySign account | 一串 6 位激活码 | 「提取凭证」,不是种子本身 |
Activating / regaining access to the SimplySign service | cloudsign.webnotarius.pl/arc/app/ 开头的链接 | 进入 resetseed 流程,24 小时内有效 |
- 超过 24 小时链接失效,只能联系服务商重发(SSLDUN 客服可协助重发激活邮件)。
- 激活码只复制正文中加粗的那 6 位,不要带前后英文;已被用过的码会报错。
四、六步完成种子提取
1. 24h 内用电脑浏览器打开激活链接2. 在 "Enter secret provided by operator" 框粘贴 6 位激活码 → 提交3. 页面标题变为 Recovering access to the SimplySign service, 并显示 "Your new QRCode" —— 这枚二维码就是新种子4. 先不要关页面:用二维码解码工具把内容读出来5. 在 otpauth:// 链接里取 secret= 后面的 base32 串(A–Z、2–7),即种子6. 立刻验证一次(与手机 App 同刻比对),再存入 CI Secret4.1 解码二维码
# 先把二维码保存为 qr.png(截图或页面另存)sudo apt install zbar-toolszbarimg -q --raw qr.png# 期望输出形如:# otpauth://totp/SimplySign:you@example.com?secret=XXXXXXXXXXXXXXXX&issuer=Certum# 备选:Pythonfrom pyzbar.pyzbar import decodefrom PIL import Imageprint(decode(Image.open("qr.png"))[0].data.decode())- 取
secret=后面那段即为种子。
- 若解出的不是标准
otpauth://(厂商自定义 payload 也常见),取其中符合 base32 字符集(大写 A–Z 与 2–7)的长串。
- 若只解出一小段短码,说明拿到的是绑定码而非种子,确认页面是否真的进入了 resetseed 流程。
4.2 先验证,再入库
sudo apt install oathtooloathtool --totp -b "$SEED" # 每 30 秒一个值,与手机 App 同刻比对import pyotp, osprint(pyotp.TOTP(os.environ["SEED"]).now())对不上通常不是种子错,而是设备时间偏差:先确认 NTP 已同步,再比对。验证通过再写入 Secret,避免把错值带进流水线后才排查。
五、接入 CI:三种落地方式
方式 1:第三方 CLI 直接出码(跨平台)
export CERTUM_EMAIL=you@example.comexport CERTUM_OTP="$CERTUM_TOTP_SEED" # base32 种子,来自 CI Secretssign dist/*.exe dist/*.dll
# 非 PE 格式(MSI/CAB/目录文件):借 PKCS#11 模块给 osslsigncodeosslsigncode sign \ -pkcs11module ./libssign_pkcs11.so \ -pkcs11cert 'pkcs11:type=cert' -key 'pkcs11:type=private' \ -ac certum-code-signing-2021-ca.pem \ -h sha256 -t http://time.certum.pl/ \ -in installer.msi -out installer-signed.msi注意:这类工具属社区实现,非 Certum 官方路径;生产上线前应小批量验证,并接受条款风险自担。
方式 2:自建出码 + 维护 Desktop 会话(较稳)
用
pyotp 定时产出 6 位码,配合自托管 Windows Runner 上的 SimplySign Desktop 完成登录,再用原生 signtool 签名: - name: Refresh SimplySign session shell: pwsh run: | $code = python -c "import pyotp,os;print(pyotp.TOTP(os.environ['SEED']).now())" & "C:\Program Files\Certum\SimplySign Desktop\SimplySignDesktop.exe" # 按团队实际流程完成登录/续期 env: SEED: ${{ secrets.CERTUM_OTP }}
- name: Sign shell: cmd run: | signtool sign /sha1 "%THUMBPRINT%" /tr http://time.certum.pl ^ /td sha256 /fd sha256 /v dist\*.exe env: THUMBPRINT: ${{ secrets.CERTUM_THUMBPRINT }}
- name: Verify gate shell: pwsh run: | signtool verify /pa /all /tw dist\*.exe if ($LASTEXITCODE -ne 0) { exit 1 }方式 3:不取种子,只用会话(更保守)
仅在发布时人工确认一次,把"签名"放到人工审批环节之后:
- 全程不持有长期种子,第二因素不被复制;
- 缺点是无法完全无人值守,发版节奏受人工确认限制;
- 适合发版频率低、审核链条本身就需要人签字的团队。
六、五条纪律(比技术步骤更重要)
- 种子等于第二因素的全部能力:拿到种子 + 账号密码就能签名,风险等级与私钥口令同级。
- 只进 Secret:CI Secret / KMS / Vault,禁止写入代码仓库、工单、聊天记录、构建日志;脚本里用
set +x防回显。
- reset 即换种子:每次走激活/重置流程都会下发新种子,旧种子立即失效。轮换的正确做法是重走流程,不是去找旧值。
- 二维码随手删:一次性会话码,不要长期截图外流;需绑多台设备时先另存,绑完即删。
- 最小权限:签名作业绑定受保护环境 + 人工审批 + 仅 release 标签触发,避免日常 PR 消耗额度或滥用签名。
七、常见故障对照
现象 | 原因 | 处理 |
收不到激活邮件 | 进垃圾箱;已过 24 小时 | 联系服务商重发 |
提交激活码报错 | 多复制了前后英文;该码已被用过 | 只复制 6 位;重发新码 |
扫码失败 | 距离/亮度/会话超时 | 20–30cm、调高亮度、刷新页面 |
手机端生成码不被接受 | 设备时间偏差 | 开启 NTP 自动同步 |
解码找不到 secret | payload 非标准 otpauth | 取 base32 长串;或保存原始 payload |
签名报"找不到证书" | Desktop 未运行/未登录 | 先拉起并确认会话,再执行签名 |
八、一句话总结
种子的正规来源只有一个:签发邮件里的 resetseed 页。在二维码生成的那一分钟把它读下来、验一次、存进 Secret,Certum 的自动签名链路就通了;反过来去 App 里"挖",只会得到不稳定且不合规的结果。