跳到主要内容
SSL 证书付费服务

苹果 ATS 检测与 iOS App HTTPS 配置:SSL 证书、TLS 1.2+ 与全链部署实战

苹果 ATS 检测与 iOS App HTTPS 配置:SSL 证书、TLS 1.2+ 与全链部署实战 — 苹果 ATS 检测与 iOS App HTTPS 配置:SSL 证书、TLS 1.2+ 与全链部署实战

问题背景与根因:ATS 检测为何总在 iOS 端失败

苹果 ATS(App Transport Security)从 iOS 9 起默认要求 App 的 HTTPS 连接满足最低安全基线:TLS 1.2 及以上、支持前向保密并优先 ECDHE、使用 SHA-256 及以上签名、证书链可被系统信任、证书 SAN 与请求域名一致。很多团队只在服务器装了证书,却忽略全链证书、协议版本、密码套件、证书有效期四项,结果真机报 NSURLErrorAppTransportSecurityRequiresSecureConnection(-1022)或 NSURLErrorServerCertificateUntrusted(-1202)。常见根因包括:仍开启 TLS 1.0/1.1;使用 RC4、3DES 或纯 RSA 密钥交换;只部署叶子证书,缺少中间 CA;证书已过期或公共 TLS 证书有效期超过 398 天;请求域名与 SAN 不一致;用 IP 直连;HTTP 301 跳转后仍落到弱加密站点。注意:在 Info.plist 加 NSAllowsArbitraryLoads 只是关闭 ATS 校验,不是修复,上架审核和真实安全都会受影响。ATS 不要求 EV 证书,DV 证书即可,但必须受 iOS 信任;OCSP/CRL 不是 ATS 直接强制项,但链不完整会直接导致信任失败。正确做法是先按 ATS 基线做服务器预检,再申请合规证书并部署全链。

实操一:用 OpenSSL、nscurl 与 nmap 完成 ATS 预检

先在 macOS 或 Linux 上执行以下命令,确认 443 端口只协商 TLS 1.2/1.3,且证书链完整。把 api.example.com 替换为真实域名:

openssl s_client -connect api.example.com:443 -servername api.example.com -tls1_2 </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
openssl s_client -connect api.example.com:443 -servername api.example.com -cipher 'ECDHE' </dev/null 2>/dev/null | grep 'Cipher is'
openssl x509 -in fullchain.pem -noout -checkend 2592000
nmap --script ssl-enum-ciphers -p 443 api.example.com
nscurl --ats-diagnostics --verbose https://api.example.com

判断标准:subjectAltName 必须包含 App 实际请求的域名;notAfter 剩余天数大于 30;Cipher is 显示 ECDHE-RSA-AES128-GCM-SHA256 或 ECDHE-ECDSA-AES256-GCM-SHA384 等前向保密套件;nscurl 输出中每个测试项应为 PASS。若出现 verify error:num=20:unable to get local issuer certificate,说明缺少中间证书;若出现 no peer certificate available,检查 SNI 与 443 监听;若只支持 TLS 1.0/1.1,先升级 OpenSSL/Nginx。生产环境不要用 IP 地址做 ATS 域名,证书 SAN 必须写 DNS 名。需要看完整链时执行 openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts,正常应至少看到叶子证书和中间 CA 两级。

实操二:生成 CSR、申请 398 天内证书并部署全链

在服务器上生成 2048 位 RSA 私钥与 CSR,SAN 一次写全。命令如下:

openssl req -new -newkey rsa:2048 -nodes -keyout api.example.com.key -out api.example.com.csr -subj '/CN=api.example.com/O=Example/C=CN' -addext 'subjectAltName=DNS:api.example.com,DNS:www.example.com'
openssl req -in api.example.com.csr -noout -text | grep -A2 'Subject Alternative Name'
chmod 600 api.example.com.key

提交 CSR 后,选择受 iOS 信任的公共 CA。公共可信 TLS 证书最长有效期按 CA/B Forum 规则为 398 天,Let’s Encrypt 为 90 天且支持自动续期;不要再按旧文章里的多年期证书做规划。下载证书时选择 Nginx/Apache 格式,得到叶子证书 cert.pem、中间链 chain.pem、fullchain.pem。部署时必须使用 fullchain.pem,而不是只配 cert.pem。验证:openssl verify -CAfile chain.pem cert.pem 应返回 OK;openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts 应能看到至少两级证书。通配符证书 *.example.com 可覆盖一级子域,但不覆盖 example.com 本身,也不覆盖 a.b.example.com。

配置示例:Nginx、Apache 与 IIS 的 ATS 兼容写法

Nginx 关键配置如下,目标是 TLS 1.2/1.3 + ECDHE + 全链证书:

server {
  listen 443 ssl http2;
  server_name api.example.com;
  ssl_certificate /etc/nginx/ssl/fullchain.pem;
  ssl_certificate_key /etc/nginx/ssl/api.example.com.key;
  ssl_protocols TLSv1.2 TLSv1.3;
  ssl_ciphers 'ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256';
  ssl_prefer_server_ciphers on;
  ssl_session_cache shared:SSL:10m;
  ssl_session_timeout 1d;
  add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
}

Apache 使用 SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1,SSLCipherSuite 写 ECDHE 套件,SSLCertificateFile 指向 fullchain.pem,SSLCertificateKeyFile 指向私钥。IIS 用 IIS Crypto 禁用 TLS 1.0/1.1,启用 TLS 1.2/1.3,把中间 CA 导入“中间证书颁发机构”,站点绑定证书。三者的共同点是:证书链完整、私钥权限最小化、HTTP 跳 HTTPS 不能跳到弱加密域名。HSTS 不是 ATS 的硬性要求,但建议上线稳定后再加 includeSubDomains。

对比表格:ATS 过检配置与常见错误配置

下表用于快速定位“能打开网页但 iOS App 报错”的差异。ATS 关注的是系统信任链与 TLS 握手,不是浏览器绿锁外观。

检查项 ATS 兼容配置 常见错误配置 典型后果
TLS 版本 TLS 1.2 或 TLS 1.3 仅 TLS 1.0/1.1,或 SSLv3 -1022 或握手失败
密码套件 ECDHE-RSA/ECDSA + AES-GCM/CHACHA20 RC4、3DES、纯 RSA 密钥交换 ATS 判定不安全
证书链 叶子证书 + 中间 CA,fullchain.pem 只部署叶子证书 -1202,curl 报 unable to get local issuer certificate
域名匹配 SAN 包含 api.example.com CN 写错、用 IP 访问、通配符层级不符 hostname mismatch
有效期 公共证书不超过 398 天,Let’s Encrypt 90 天 过期证书或多年期旧证书 certificate has expired
签名算法 SHA-256 及以上 SHA-1、1024 位 RSA 系统不信任

如果表格中任一项不满足,先修服务器,不要先改 App 的 ATS 例外。例外配置会扩大攻击面,也不能解决证书链缺失。

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

报错一:NSURLErrorAppTransportSecurityRequiresSecureConnection(-1022)。先执行 openssl s_client -connect api.example.com:443 -servername api.example.com -tls1_2,若握手失败,检查 Nginx/Apache 是否仍只开 TLS 1.0/1.1;若握手成功但 nscurl 失败,检查密码套件是否包含非 ECDHE 套件。报错二:NSURLErrorServerCertificateUntrusted(-1202)。执行 openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts,若只看到一张证书,补全中间链;若出现 verify error:num=20,使用 fullchain.pem 并重启服务。报错三:curl: (60) SSL certificate problem: unable to get local issuer certificate。用 openssl verify -CAfile chain.pem cert.pem 验证,失败则重新下载中间 CA。报错四:certificate has expired。用 openssl x509 -in cert.pem -noout -dates 查看,公共证书有效期最长 398 天,Let’s Encrypt 90 天,需设置续期告警。报错五:hostname mismatch。检查 SAN 是否包含实际域名,通配符 *.example.com 不匹配 example.com 和二级以上子域。

效果验证:从 nscurl 诊断到真机 URLSession

服务端改完后,先在 macOS 执行 nscurl –ats-diagnostics –verbose https://api.example.com,输出中 TLS 1.2、TLS 1.3、前向保密等测试项应为 PASS;再执行 curl -vI https://api.example.com,确认 HTTP/2 或 HTTP/1.1 200、证书链和 SAN 正常。用 testssl.sh –full https://api.example.com 检查协议、套件、证书链和 OCSP stapling。真机验证时,在 Xcode 控制台观察 URLSession 错误码;生产包不要保留 NSAllowsArbitraryLoads。若必须访问特定旧域名,使用 NSExceptionDomains 做最小例外,并为该域名配置 NSExceptionMinimumTLSVersion。最后用不同网络(Wi-Fi、4G/5G)各测一次,排除中间盒降级。验收标准:nscurl 全部 PASS、真机无 -1022/-1202、证书剩余有效期大于 30 天、链上无 SHA-1。可补充执行 openssl s_client -connect api.example.com:443 -servername api.example.com </dev/null 2>/dev/null | openssl x509 -noout -text | grep -E ‘Signature Algorithm|Not After’,确认签名算法和到期时间。

上线后的证书生命周期与监控

公共 TLS 证书不再是“买一次管几年”:按现行规则最长 398 天,Let’s Encrypt 为 90 天。建议在到期前 30 天自动续期,并在到期前 45 天告警。监控命令可写入巡检脚本:openssl s_client -connect api.example.com:443 -servername api.example.com </dev/null 2>/dev/null | openssl x509 -noout -enddate;openssl x509 -in fullchain.pem -noout -checkend 2592000。返回值非 0 表示 30 天内到期。Nginx 重载前先 nginx -t;Apache 用 apachectl configtest;IIS 用 certlm.msc 检查绑定。OCSP stapling 建议开启,减少客户端回源;CRL 作为吊销兜底。证书更新后必须复测 fullchain,避免只换叶子证书导致链断。多域名、通配符和 CDN 场景要分别检查每个 SNI 的证书,不能只看主域名。

常见问题

ATS 是否强制 TLS 1.3?

不强制。ATS 的最低要求是 TLS 1.2 及以上,TLS 1.3 更推荐。关键是同时满足前向保密套件、受信任证书链、SAN 域名匹配和合规有效期;只把协议改成 TLS 1.3 但证书链缺失,仍然会报 -1202。

证书有效期 398 天怎么算?

公共可信 TLS 证书按 CA/B Forum 规则最长 398 天,从签发时间起算;Let’s Encrypt 仍为 90 天。自签证书不受该规则约束,但 ATS 默认不信任自签证书,不能用于正式 App 过检。

通配符证书能否通过 ATS?

可以。只要 SAN 匹配实际请求域名、证书链完整、有效期和签名算法合规即可。注意 *.example.com 只覆盖一级子域,不覆盖 example.com,也不覆盖 a.b.example.com;多级子域要单独写入 SAN 或另配证书。

已经配置 HTTPS 仍报 -1022 怎么办?

先查 TLS 版本和密码套件,再查 HTTP 跳转是否落到弱加密站点。用 openssl s_client -tls1_2 和 nscurl –ats-diagnostics 复测。不要用 NSAllowsArbitraryLoads 掩盖问题,它只是关闭 ATS 校验,不是修复。

是否需要 OCSP 和 CRL?

ATS 不直接强制 OCSP/CRL,但证书链必须可被系统信任。建议开启 OCSP stapling 降低回源延迟,并保留 CRL 作为吊销兜底;若中间 CA 缺失,OCSP 配置再好也无法通过 ATS。

能否用自签证书测试 ATS?

模拟器可临时信任自签证书,真机 ATS 默认不通过。正式测试应使用受信任测试 CA 或 Let’s Encrypt 证书;若必须用自签,只能在受控测试设备上安装并信任根证书,不能作为生产方案。

内容审核

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