跳到主要内容
HTTPS安装配置

iOS ATS 与 HTTPS 部署实战:SSL 证书、TLS 1.2/1.3 与 App 兼容性排查

iOS ATS 与 HTTPS 部署实战:SSL 证书、TLS 1.2/1.3 与 App 兼容性排查 — iOS ATS 与 HTTPS 部署实战:SSL 证书、TLS 1.2/1.3 与 App 兼容性排查

问题背景与根因:iOS ATS 为什么让旧 HTTPS 部署失效

iOS 9 引入 App Transport Security(ATS),App 默认禁止明文 HTTP,并要求 HTTPS 连接满足 TLS 1.2 及以上、前向保密(Forward Secrecy)密码套件、受信任 CA 签发、SAN 与域名匹配、证书链完整等条件。2017 年起 App Store 审核对新应用更严格,使用例外需要说明原因。很多旧部署失败不是“没装 SSL”,而是只部署了叶子证书、缺中间证书;仍开启 TLS 1.0/1.1;使用 CBC 或弱套件;证书有效期超过 398 天;SAN 未包含 www 或 API 子域;App 仍请求 http:// 或 IP 地址。另需纠正两个过时说法:Symantec 根证书已不是首选,应选 DigiCert、GlobalSign、Sectigo、Let’s Encrypt 等受信任 CA;公开 TLS 证书最长有效期 398 天,Let’s Encrypt 为 90 天。ATS 不要求 EV/OV,DV 证书只要技术合规也可通过。如果 App 使用 WebView 加载混合内容,也会触发 ATS 拦截,需同时检查页面内资源。排查顺序应先协议与证书链,再查 App 的 Info.plist 和请求 URL。

前置检查:用命令确认域名、证书链与 TLS 版本

在改配置前,先在服务器或 macOS 终端对线上域名做基线检查。以下命令可直接执行,把 example.com 换成你的域名:

openssl s_client -connect example.com:443 -servername example.com -tls1_2 -showcerts </dev/null
openssl s_client -connect example.com:443 -servername example.com </dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem
nmap --script ssl-enum-ciphers -p443 example.com
curl -I --tlsv1.2 https://example.com

判断标准:第一条能完成 TLS 1.2 握手并输出 Verify return code: 0;第二条的 subjectAltName 必须包含 App 实际访问的域名,notAfter 与 notBefore 覆盖当前时间,且证书有效期不超过 398 天;第三条返回 OK,说明 fullchain.pem 链完整;nmap 输出中不应再出现 TLSv1.0、TLSv1.1 和 3DES/RC4 等弱套件;curl 返回 200 或 30x 且无证书错误。若第一条失败,先修 TLS 协议和密码套件;若第三条失败,优先补中间证书;若 SAN 不含 www,App 访问 https://www.example.com 仍会报证书无效。

申请与部署 398 天以内证书(含 Let’s Encrypt 90 天)

公开受信任 TLS 证书自 2020 年 9 月 1 日起最长有效期 398 天,Let’s Encrypt 仍为 90 天,必须自动化续期。用 Let’s Encrypt 申请双域名证书:

certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com --deploy-hook 'systemctl reload nginx'
certbot renew --dry-run

商业 CA 申请时先生成 CSR,确保 SAN 写全,不要只写 CN:

openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj /CN=example.com -addext subjectAltName=DNS:example.com,DNS:www.example.com
openssl req -in example.com.csr -noout -text | grep -A2 subjectAltName

签发后部署 fullchain.pem 与 privkey.pem,不要只部署 cert.pem。fullchain.pem 包含叶子证书和中间证书,能避免 iOS 报 -9816 和 curl 报 unable to get local issuer certificate。Let’s Encrypt 证书路径通常为 /etc/letsencrypt/live/example.com/fullchain.pem 与 privkey.pem;商业 CA 需把 CA 提供的中间证书与服务器证书按顺序合并。续期后必须 reload Nginx/Apache,否则旧证书继续生效。建议在到期前 30 天告警,并用 openssl x509 -noout -dates 检查 notAfter。

Nginx/Apache 配置示例:满足 ATS 的 TLS 1.2/1.3 与密码套件

Nginx 最小可用配置如下,关键点是 fullchain、TLSv1.2/TLSv1.3、ECDHE 前向保密套件和 HTTP 跳转:

server {
    listen 443 ssl http2;
    server_name example.com www.example.com;
    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    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:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305';
    ssl_prefer_server_ciphers off;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;
    ssl_session_tickets off;
    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
    add_header Strict-Transport-Security max-age=31536000;
    location / { proxy_pass http://127.0.0.1:8080; }
}
server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

Apache 对应配置:SSLProtocol -all +TLSv1.2 +TLSv1.3;SSLCipherSuite 使用上面的 ECDHE 套件;SSLCertificateFile 指向 fullchain.pem;SSLCertificateKeyFile 指向 privkey.pem;SSLUseStapling on。不要启用 SSLv3、TLSv1.0、TLSv1.1,不要使用 AES-CBC、3DES、RC4。修改后执行 nginx -t 或 apachectl configtest,再 reload。HSTS 先从小 max-age 灰度,确认全站 HTTPS 后再加到 31536000。

iOS App 侧 ATS 配置与例外策略(Info.plist 示例)

App 链接 iOS 9 及以上 SDK 时 ATS 默认开启。优先把请求地址改为 https:// 域名,服务端修到 ATS 合规;只有遗留域名确实无法短期改造时,才在 Info.plist 做最小例外。示例关闭全局放行,仅对 example.com 放宽到 TLS 1.2 并要求前向保密:

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <false/>
    <key>NSExceptionDomains</key>
    <dict>
        <key>example.com</key>
        <dict>
            <key>NSExceptionMinimumTLSVersion</key>
            <string>TLSv1.2</string>
            <key>NSExceptionRequiresForwardSecrecy</key>
            <true/>
            <key>NSIncludesSubdomains</key>
            <true/>
        </dict>
    </dict>
</dict>

不要用 NSAllowsArbitraryLoads 一刀切绕过 ATS,App Store 审核通常要求解释原因,而且会降低安全性。本地调试可用 NSAllowsLocalNetworking,但上线前移除。若 API 使用独立子域 api.example.com,要单独列在 NSExceptionDomains 或把 SAN 和证书覆盖到该域名。例外只降低 ATS 检查,不会修复证书链、过期证书或弱套件,因此仍要用 nscurl 和 openssl 验证服务端。

ATS 兼容性对比表:证书、TLS、密码套件与 iOS 行为

下表把常见配置与 iOS ATS 行为对齐,便于快速定位。注意“浏览器能打开”不代表 ATS 通过,Safari 与 App 的信任和协议策略不完全相同。

检查项 ATS 要求 不合规表现 验证命令
TLS 版本 TLS 1.2 及以上,TLS 1.3 可用 握手失败,-9802 openssl s_client -tls1_2
证书链 叶子证书+中间证书+受信任根 -9816、curl 60 openssl verify -CAfile
域名匹配 SAN 包含实际访问域名 证书无效、-1202 openssl x509 -ext subjectAltName
有效期 当前时间在有效期内,公开证书最长 398 天 证书过期/不受信 openssl x509 -dates
密码套件 ECDHE 前向保密,AES-GCM/ChaCha20 handshake failure nmap –script ssl-enum-ciphers
明文 HTTP 默认禁止 ATS blocked cleartext HTTP curl -I http://example.com
证书类型 DV/OV/EV 均可,需受信任 CA 不受信根导致失败 openssl s_client -showcerts

从表中可见,ATS 的核心是“受信任链+TLS 1.2+前向保密+SAN 匹配”,不是证书品牌。原文章强调 Symantec 根证书兼容性第一已过时;当前应选择仍被 Apple 信任的 CA,并关注证书有效期 398 天和 Let’s Encrypt 90 天的续期节奏。

常见错误排查:真实报错与修复命令

报错 1:curl: (60) SSL certificate problem: unable to get local issuer certificate。原因是服务器只发了叶子证书,缺中间证书。修复:Nginx 的 ssl_certificate 改用 fullchain.pem,Apache 的 SSLCertificateFile 改用 fullchain.pem,然后执行 openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem 确认 OK。

报错 2:NSURLSession/NSURLConnection HTTP load failed (kCFStreamErrorDomainSSL, -9802)。常见于 TLS 1.0/1.1、弱套件或协议不匹配。用 openssl s_client -connect example.com:443 -servername example.com -tls1_2 测试;服务端改为 TLSv1.2 TLSv1.3 和 ECDHE 套件;用 nmap –script ssl-enum-ciphers -p443 example.com 复查。

报错 3:kCFStreamErrorDomainSSL, -9816 或 The certificate for this server is invalid。多为证书链不完整、根不受信任、SAN 不匹配或证书过期。执行 openssl s_client -showcerts 和 openssl x509 -noout -dates -ext subjectAltName 检查;缺中间证书就补链,SAN 不含 www 就重签证书。

报错 4:App Transport Security has blocked a cleartext HTTP (http://) resource load since it is insecure。App 仍在请求 HTTP 或 WebView 内嵌 HTTP。把 URL 改成 HTTPS,检查重定向;确需例外时用 NSExceptionDomains 最小化,不要全局 NSAllowsArbitraryLoads。

报错 5:nginx: [emerg] SSL_CTX_use_certificate:key_values_mismatch。证书与私钥不匹配。执行 openssl x509 -noout -modulus -in fullchain.pem | openssl md5 与 openssl rsa -noout -modulus -in privkey.pem | openssl md5,两值必须一致。若报 sslv3 alert handshake failure,检查客户端与服务端密码套件交集,删除 CBC/3DES/RC4。

效果验证与上线检查清单

部署完成后在 macOS(安装 Xcode)执行 ATS 诊断,这是最接近 iOS 行为的检查:

nscurl --ats-diagnostics --verbose https://example.com
curl -sS -I https://example.com
curl -sS -I http://example.com
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null | openssl x509 -noout -dates -ext subjectAltName
nmap --script ssl-enum-ciphers -p443 example.com

通过标准:nscurl 各组合无 ATS 失败;https 返回 200/30x 且响应头含 Strict-Transport-Security;http 返回 301 到 https;证书 notAfter 不超过 398 天且 SAN 覆盖所有域名;nmap 不出现 TLSv1.0、TLSv1.1、3DES、RC4。再用 TestFlight 在至少一台 iOS 15+ 和一台旧版本设备上跑登录、支付、图片上传等核心链路。最后把 certbot renew –dry-run 加入定时任务,续期后自动 reload Nginx;监控证书剩余天数,提前 30 天告警。只有服务端、App 配置和续期机制同时通过,才算完成 ATS 部署。

常见问题

ATS 是否必须使用 EV 或 OV 证书?

不必须。ATS 关注受信任 CA、SAN 匹配、TLS 1.2+、前向保密和完整证书链,DV 证书满足这些条件也可通过。公开 TLS 证书最长有效期 398 天,Let’s Encrypt 为 90 天。

证书有效期 398 天和 Let’s Encrypt 90 天如何自动续期?

用 certbot renew –dry-run 验证续期,配置 systemd timer 或 cron 每天执行 certbot renew,并用 –deploy-hook ‘systemctl reload nginx’ 在续期成功后 reload。监控剩余天数,提前 30 天告警。

为什么浏览器正常但 iOS App 报 -9802 或 -9816?

浏览器容错和缓存更强,App ATS 更严格。用 nscurl –ats-diagnostics 和 openssl s_client -tls1_2 检查;-9802 多为 TLS/密码套件,-9816 多为证书链、根信任、SAN 或有效期问题。

能否用 NSAllowsArbitraryLoads 通过审核?

不建议。全局放行会触发审核问询,且掩盖服务端问题。优先修 HTTPS;遗留域名用 NSExceptionDomains 做最小例外,并在审核说明中给出理由。

TLS 1.3 是否满足 ATS?

满足。ATS 最低要求 TLS 1.2,TLS 1.3 可用且更安全。服务端同时开启 TLSv1.2 和 TLSv1.3,保留 ECDHE 前向保密套件即可。

fullchain.pem 和 cert.pem 有什么区别?

cert.pem 通常只有叶子证书,fullchain.pem 含叶子证书和中间证书。Nginx/Apache 应配置 fullchain.pem,否则 iOS 可能报 -9816,curl 可能报 unable to get local issuer certificate。

内容审核

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