跳到主要内容
HTTPS小程序证书

Comodo Essential SSL 实战:单域名 DV 证书部署、iOS IPA 在线安装与小程序 HTTPS 配置

Comodo Essential SSL 实战:单域名 DV 证书部署、iOS IPA 在线安装与小程序 HTTPS 配置 — Comodo Essential SSL 实战:单域名 DV 证书部署、iOS IPA 在线安装与小程序 HTTPS 配置

一、问题背景:IPA 在线安装与小程序为什么卡在证书上

原文宣称“完美兼容 iOS 任何版本、在线安装 ipa”,其真正的技术含义是:iOS 通过 itms-services 协议安装 IPA 时,会由系统独立的安装进程去校验下载地址的 HTTPS 证书链。根证书缺失、中间证书没下发、域名不匹配、证书过期,任何一环出问题,都会表现为安装弹窗一闪而过或提示“无法安装 App”。同理,微信小程序的 wx.request 强制 HTTPS,且要求 TLS 1.2 及以上、证书由受信任 CA 签发,自签名证书会被直接拒绝。

根因通常不是“没有加密”,而是“加密了但对方不信任”。常见四类:自签名证书;只部署了叶证书、漏掉中间证书;Common Name 与访问域名不一致(现代浏览器只认 SAN 扩展);仍使用已被淘汰的 SHA-1 签名。另外,自 2020 年 9 月起 CA/B 论坛规定公有 TLS 证书最长有效期 398 天,原文“一年期”需按 398 天理解,Let’s Encrypt 则固定 90 天。

# 四类典型报错
curl: (60) SSL certificate problem: unable to get local issuer certificate
Chrome: NET::ERR_CERT_AUTHORITY_INVALID
iOS: 无法安装“XXX”,请稍后重试
小程序: request:fail ssl hand shake error

彻底解决只需一条完整且受信任的证书链:叶证书 + 中间证书 + 受信任根证书,签名算法 SHA-256。

二、证书选型:Comodo Essential SSL 的现状与关键参数

Comodo CA 已于 2018 年更名为 Sectigo,市面上“Comodo Essential SSL”现在多以 Sectigo Essential SSL / PositiveSSL 名义签发,链到 USERTrust RSA 或 Sectigo Public Server Authentication Root R46,iOS、Android、Chrome、Firefox、Safari 均内置信任。

  • 验证级别:DV(域名验证),只校验域名控制权,通常 5–15 分钟签发;
  • 覆盖范围:单域名 example.com,部分产品可免费追加 www 作为 SAN,下单前确认;
  • 签名算法:SHA-256;SHA-1 已被主流浏览器全面拒绝;
  • 密钥与加密:RSA 2048/4096 或 ECDSA P-256,所谓“256 位加密”指握手协商出的 AES-256-GCM 对称加密,不是证书密钥长度;
  • 有效期:受 CA/B 规则限制最长 398 天,到期必须重签;
  • 重签与绑定:DV 证书有效期内可免费重签,不绑定服务器和 IP,原文这点是正确的;
  • 共享 IP:虚拟主机普遍支持 SNI,共享 IP 也能装证书,原文“共享 IP 一般不支持”已过时。

个人站、测试环境或小程序后端,Let’s Encrypt(90 天,certbot 自动续期)完全够用;需要 398 天少运维、或客户指定商业 CA 品牌时,再选 Sectigo 单域名 DV。

三、实操:生成私钥与 CSR 并提交签发

推荐在服务器本地生成密钥对,只把 CSR 交给 CA,私钥永不出服务器。

# 1. 生成 2048 位 RSA 私钥 + 带 SAN 的 CSR(一条命令)
openssl req -new -newkey rsa:2048 -nodes 
  -keyout /etc/ssl/private/example.com.key 
  -out /etc/ssl/csr/example.com.csr 
  -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example/CN=example.com' 
  -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'

# 2. 校验 CSR 中的 SAN 是否包含全部域名
openssl req -in /etc/ssl/csr/example.com.csr -noout -text | grep -A2 'Subject Alternative Name'

# 3. 校验私钥与 CSR 配对(两条 md5 输出必须一致)
openssl rsa -noout -modulus -in /etc/ssl/private/example.com.key | openssl md5
openssl req -noout -modulus -in /etc/ssl/csr/example.com.csr | openssl md5

chmod 600 /etc/ssl/private/example.com.key

提交 CSR 后完成域名验证(DNS TXT 或 HTTP 文件)。你会拿到 example.com.crt(叶证书)与 intermediate.crt(中间证书),务必拼接并验证:

cat example.com.crt intermediate.crt > fullchain.crt
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt 
  -untrusted intermediate.crt example.com.crt
# 期望输出:example.com.crt: OK

若用 Let’s Encrypt 可跳过手工流程:certbot --nginx -d example.com -d www.example.com,再用 certbot renew --dry-run 验证自动续期。

四、Nginx 配置示例:TLS 1.2/1.3、HSTS 与 OCSP Stapling

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    server_name example.com www.example.com;

    ssl_certificate     /etc/ssl/certs/fullchain.crt;   # 必须含中间证书
    ssl_certificate_key /etc/ssl/private/example.com.key;

    ssl_protocols       TLSv1.2 TLSv1.3;
    ssl_ciphers         ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
    ssl_prefer_server_ciphers off;
    ssl_session_cache   shared:SSL:10m;

    ssl_stapling        on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/ssl/certs/fullchain.crt;
    resolver            223.5.5.5 1.1.1.1 valid=300s;

    add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
}

要点:ssl_certificate 必须指向 fullchain,只配叶证书就会出现 unable to get local issuer certificate;ssl_protocols 不要保留 TLSv1/TLSv1.1,iOS ATS 与小程序都要求 TLS 1.2+;HSTS 首次上线先用 max-age=300 试跑,确认全站 HTTPS 后再调大。改完执行 nginx -t && nginx -s reload。

五、iOS IPA 在线安装:itms-services 与 plist 配置

iOS 7.1 之后 OTA 安装必须走 HTTPS,且 manifest.plist 与 ipa 都要能被 Safari 直接访问,MIME 类型必须正确。

location /ipa/ {
    default_type application/octet-stream;
}
location = /ipa/manifest.plist {
    default_type application/x-plist;
}

manifest.plist 最小示例:

<?xml version='1.0' encoding='UTF-8'?>
<plist version='1.0'><dict>
  <key>items</key><array><dict>
    <key>assets</key><array>
      <dict><key>kind</key><string>software-package</string>
        <key>url</key><string>https://app.example.com/ipa/app.ipa</string></dict>
    </array>
    <key>metadata</key><dict>
      <key>bundle-identifier</key><string>com.example.app</string>
      <key>bundle-version</key><string>1.0.0</string>
      <key>title</key><string>Example</string>
    </dict>
  </dict></array>
</dict></plist>

安装页放链接:<a href='itms-services://?action=download-manifest&url=https://app.example.com/ipa/manifest.plist'>安装</a>。三个坑:plist 的 MIME 必须是 application/x-plist,否则提示“无法安装”;manifest 里的 url 必须是完整 https 地址;ipa 必须用企业证书或含设备 UDID 的 Ad Hoc 描述文件签名,否则证书再正确也装不上。

六、证书方案对比:Let’s Encrypt、Sectigo DV、OV 与自签名

方案 验证方式 有效期 iOS/小程序信任 适用场景
自签名证书 无 自定 否 仅内网测试
Let’s Encrypt DV 域名 / DNS 90 天,可自动续期 是 个人站、API、测试环境
Sectigo(原 Comodo)Essential SSL DV 最长 398 天 是 单域名官网、小程序后端
OV 单域名 域名 + 企业资料 最长 398 天 是 需展示企业身份
DV 通配符 DNS 最长 398 天 是 app.、api. 等多子域

选型建议:只有 1 个域名且能接受自动续期,选 Let’s Encrypt;要 398 天少运维、或客户指定商业品牌,选 Sectigo DV;有 app.example.com、api.example.com 多个子域,直接上通配符,比逐张单域名更省事。EV 证书的绿色地址栏已被主流浏览器取消,不必为“显示公司名”多付费。

七、常见错误排查:从真实报错到修复命令

报错 / 现象 根因 修复动作
curl: (60) unable to get local issuer certificate 未下发中间证书 ssl_certificate 改配 fullchain.crt
NET::ERR_CERT_COMMON_NAME_INVALID SAN 不含当前域名 重签 CSR,-addext 补齐 SAN
NET::ERR_CERT_DATE_INVALID 证书过期或服务器时间错误 校时 + 续签,检查 -dates
SSL_CTX_use_PrivateKey: key values mismatch 私钥与证书不配对 比对 modulus md5 后重新部署
iOS 提示“无法安装 App” plist MIME 错误或 ipa 未含 UDID 改 application/x-plist,重签 ipa
小程序 request:fail ssl hand shake error 仍开放 TLS 1.0/1.1 或证书链不全 只留 TLSv1.2/1.3,配 fullchain
# 一次性定位:看服务端下发的证书链与校验结果
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep 'Verify return code'
# Verify return code: 0 (ok) 才算链路完整

排查顺序固定为:链 → 域名 → 时间 → 协议版本。先用上面两条命令确认服务端行为,再查 Nginx error.log 中的 SSL_CTX_use_PrivateKey 与 no shared cipher 关键字,比反复重装证书快得多。

八、效果验证:五条命令确认证书真的生效

# 1. 查看有效期与 SAN
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -dates -subject -ext subjectAltName

# 2. 确认 HTTP 已 301 到 HTTPS,且 HSTS 已下发
curl -sI http://example.com | head -n 5
curl -sI https://example.com | grep -i strict-transport-security

# 3. 确认 TLS 1.1 已被拒绝
openssl s_client -connect example.com:443 -tls1_1 </dev/null

# 4. 证书 30 天内是否过期(返回 0 表示仍安全)
openssl x509 -checkend 2592000 -noout -in fullchain.crt

接着用 SSL Labs(ssllabs.com/ssltest)跑分级,目标 A 以上;iOS 真机用 Safari 打开安装页实测一次完整安装;小程序在开发者工具“详情 → 本地设置”关闭“不校验合法域名”后请求真实接口。三项都通过,才算证书真正落地,而不只是 Nginx 里多了一行配置。

常见问题

Comodo Essential SSL 还能买吗?和 Sectigo 是什么关系?

能买,但品牌已更名。Comodo CA 于 2018 年更名为 Sectigo,原 Essential SSL 产品线现在以 Sectigo Essential SSL / PositiveSSL 名义签发,根证书为 USERTrust 或 Sectigo,iOS、Android、Chrome、Firefox、Safari 均预置信任,功能与旧名一致。

证书有效期到底是一年还是 398 天?

公有 TLS 证书自 2020 年 9 月起最长 398 天,商业 CA 普遍按 398 天签发,不再有“买一年用一年”的说法;Let’s Encrypt 固定 90 天。因此必须配置到期监控或自动续期,否则会在某天突然全线报错。

共享 IP 的虚拟主机能装 SSL 证书吗?

能。SNI 扩展已全面普及,一台共享 IP 上可承载多个不同域名的证书,浏览器与 iOS、小程序均支持。只有极老的客户端(如 IE8 on XP)不支持 SNI,如今可忽略。

证书配好了,IPA 还是装不上怎么办?

先看 plist 的 MIME 是否为 application/x-plist,再确认 manifest 中 ipa 的 url 是完整 https 地址;最后检查 ipa 签名类型——企业证书需在“设置 → 通用 → VPN 与设备管理”中信任,Ad Hoc 则必须把设备 UDID 加入描述文件。

小程序必须用商业证书吗?Let’s Encrypt 可以吗?

可以。微信只要求证书由受信任 CA 签发、域名已备案、TLS 1.2 及以上,Let’s Encrypt 完全符合。关键在于自动续期要稳定,避免 90 天到期后小程序接口集体报 ssl hand shake error。

“256 位加密”指的是什么?

指 TLS 握手协商出的对称加密算法强度,如 AES-256-GCM,与证书密钥长度无关。证书侧常见的是 RSA 2048/4096 位或 ECDSA P-256,签名算法为 SHA-256,这三者共同决定安全性与兼容性。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。