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

苹果 ATS 检测与 iOS App HTTPS 配置实战:SSL 证书、TLS 参数与排错指南

苹果 ATS 检测与 iOS App HTTPS 配置实战:SSL 证书、TLS 参数与排错指南 — 苹果 ATS 检测与 iOS App HTTPS 配置实战:SSL 证书、TLS 参数与排错指南

很多 iOS 团队在 App 上线前才做苹果 ATS 检测,结果发现 URLSession 请求被拦截,或者 WKWebView 页面出现混合内容警告。本文从 ATS 根因、SSL 证书申请、Nginx/Apache 配置、真实报错排查到 nscurl 验证,给出一套可直接执行的 HTTPS 配置流程。

问题背景与根因:ATS 为什么会拦截 iOS App 的 HTTPS

ATS(App Transport Security)是 Apple 在 iOS 9 和 macOS 10.11 引入的网络传输安全策略。使用 URLSession、NSURLConnection 发起请求时默认启用;WKWebView 加载的页面和子资源也要避免混合内容。ATS 不是“有证书就放行”,默认要求:HTTPS 访问、TLS 1.2 及以上、支持前向保密的密码套件、证书签名算法 SHA-256 及以上、RSA 密钥至少 2048 位或 ECC 至少 256 位、证书 SAN 与请求主机名匹配、信任链完整。Apple 不要求 EV 证书,证书主题只显示域名也不会影响 ATS;OCSP/CRL 支持情况也不是 ATS 的硬性开关。

典型根因有:App 里仍硬编码 http://;证书是自签名或只部署了叶证书,缺少中间证书;请求 api.example.com,证书 SAN 只有 example.com;服务器仍开放 TLS 1.0/1.1 或只提供非前向保密套件;RSA 1024 位、SHA-1 签名;CDN 边缘证书正常但回源证书链错误;WKWebView 页面引用了 HTTP 图片、JS、CSS。对应 iOS 常见报错是 NSURLErrorDomain Code=-1022、-1200、-9802。临时用 NSAllowsArbitraryLoads 关闭 ATS 只能救急,审核和长期安全都不建议。

因此处理顺序应是:先确认 App 请求的每个主机名和端口,再检查证书 SAN、链、TLS 版本与套件,最后才改客户端例外。下面命令均以 example.com 和 www.example.com 为例。

证书选型与有效期:DV/OV/EV、RSA/ECC 与 398/90 天

ATS 只看密码学和信任链,不看证书是 DV、OV 还是 EV。对大多数 App API,DV 证书已经足够;OV/EV 主要影响浏览器展示和组织的审核流程,不会提高 ATS 通过率。证书必须覆盖 App 实际请求的主机名,且应写入 SAN 扩展。单域名证书只覆盖一个 FQDN;多域名证书按 SAN 数量计费;通配符 *.example.com 只覆盖一级子域,不能覆盖 a.b.example.com。请求 www 和不带 www 时,应把两个名字都加入 SAN,或统一 301 到其中一个。

有效期方面,公开信任 TLS 证书的传统单张上限是 398 天,Let’s Encrypt 默认 90 天;CA/B Forum 已推动有效期逐步缩短,实际以 CA 签发结果为准。不要按“多年不换”规划,必须做自动续期和到期监控。密钥选择上,RSA 2048 位兼容性最好;ECC P-256 握手性能更好,但很老的客户端可能不支持。需要兼顾旧设备时可部署 RSA 与 ECC 双证书,或先用 RSA 2048 过渡。OCSP/CRL 是吊销状态查询机制,商业 CA 通常支持;ATS 不强制 OCSP Must-Staple,开启前要确认服务器和 CA 支持。

生成 ECC 私钥和 CSR 可用:openssl ecparam -name prime256v1 -genkey -noout -out example.com.ecc.key,再执行 openssl req -new -key example.com.ecc.key -out example.com.ecc.csr -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'。如果团队没有成熟运维,优先 RSA 2048,减少兼容性变量。

完整实操步骤:从 CSR 到证书签发与部署

第一步,在服务器上生成 RSA 2048 私钥和 CSR,并把所有域名写进 SAN:

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

输出中必须看到 DNS:example.com 和 DNS:www.example.com。第二步,提交 CSR 给 CA 完成域名控制权验证。DV 可用 HTTP 文件、DNS TXT 或邮箱;Let’s Encrypt 可用 certbot:certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com --email ops@example.com --agree-tos --no-eff-email。需要通配符时用 DNS-01:certbot certonly --manual --preferred-challenges dns -d example.com -d '*.example.com',并注意通配符不覆盖多级子域。

第三步,合并证书链。Nginx 的 ssl_certificate 应指向包含叶证书和中间证书的 fullchain,而不是只放叶证书:cat cert.pem chain.pem > fullchain.pem。私钥权限收紧:chmod 600 example.com.key。第四步,部署并重载:nginx -t && systemctl reload nginx,Apache 用 apachectl configtest && systemctl reload httpd。第五步,配置自动续期并演练:certbot renew --dry-run;商业证书也要在到期前 30 天更新。Let’s Encrypt 90 天证书必须自动续期,公开信任证书传统上限 398 天,不能把续期当手动任务。

配置示例:Nginx 与 Apache 的 ATS 兼容参数

Nginx 示例中,关键是 fullchain、TLS 1.2/1.3 和 ECDHE 套件:

server {
    listen 443 ssl;
    server_name example.com www.example.com;
    ssl_certificate /etc/nginx/ssl/fullchain.pem;
    ssl_certificate_key /etc/nginx/ssl/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_session_timeout 1d;
    ssl_session_tickets off;
    add_header Strict-Transport-Security 'max-age=31536000' always;
}

Apache 2.4 示例:

<VirtualHost *:443>
    ServerName example.com
    SSLEngine on
    SSLCertificateFile /etc/httpd/ssl/fullchain.pem
    SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
    SSLProtocol -all +TLSv1.2 +TLSv1.3
    SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384
    SSLHonorCipherOrder off
    Header always set Strict-Transport-Security max-age=31536000
</VirtualHost>

不要只写 TLSv1.2 而漏掉中间证书;不要把 ssl_certificate 指向叶证书;不要启用 TLS 1.0/1.1 或 RC4、3DES。HSTS 不是 ATS 的强制要求,但 Web 站点建议开启;开启前确认全站 HTTPS 和子域策略。改完后必须 nginx -t 或 apachectl configtest,再 reload。若使用 CDN,边缘和回源都要检查证书链与 TLS 版本,App 直连域名时看边缘节点。

对比表格:证书、密钥与协议组合怎么选

下表用于快速判断 ATS 兼容性和适用场景。ATS 的核心是 TLS 1.2+、前向保密、SHA-256、RSA 2048/ECC 256、SAN 匹配和完整链;DV/OV/EV 不是通过条件。

组合 ATS 兼容 适用场景 注意事项
DV + RSA 2048 是 大多数 App API、初创业务 兼容性最好,需 fullchain
OV/EV + RSA 2048 是 需要组织审核或品牌展示 不提高 ATS 通过率
DV + ECC P-256 是 新客户端、追求握手性能 极老设备可能不信任
Let’s Encrypt 90 天 是 自动化运维、Web/API 必须自动续期
商业证书 398 天传统上限 是 需要 SLA/人工支持 新规可能缩短,以 CA 为准
通配符 *.example.com 是 同一级多个子域 不覆盖 a.b.example.com
多域名 SAN 是 api、www、m 等多个主机名 每个请求主机名都要在 SAN
TLS 1.2 + ECDHE 是 兼容旧 iOS 与 Android 禁用 TLS 1.0/1.1
TLS 1.3 是 新系统优先 保留 TLS 1.2 兜底

选择时先满足“域名覆盖 + 链完整 + TLS 1.2+ + PFS”,再考虑 ECC、EV 和商业 SLA。多域名证书按 SAN 个数计费,通配符只解决一级子域;如果 App 同时请求 api.example.com 和 cdn.example.com,最稳妥是 SAN 明确列出。RSA 与 ECC 双证书能兼顾兼容和性能,但配置复杂度更高,建议在压测和真机验证后上线。

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

1. iOS 报 -1022:NSURLErrorDomain Code=-1022,提示 The resource could not be loaded because the App Transport Security policy requires the use of a secure connection。先确认 URL 是 https,且没有 302 跳到 http;再用 nscurl --ats-diagnostics --verbose https://example.com 看哪项 FAIL。修复:启用 TLS 1.2/1.3,配置 ECDHE 套件,证书 SAN 匹配。

2. iOS 报 -1200:Code=-1200 An SSL error has occurred and a secure connection to the server cannot be made。执行 openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>/dev/null,看是否握手失败、是否返回错误证书。常见是 SNI 未配置、协议不匹配、链不全。

3. iOS 报 -9802:Code=-9802 The certificate for this server is invalid。用 openssl x509 -noout -subject -issuer -dates -ext subjectAltName 检查是否过期、SAN 是否缺 api.example.com、颁发者是否受信任。自签名证书必须换成公开 CA 或企业内部分发方案。

4. OpenSSL 报 verify error:num=20:verify error:num=20:unable to get local issuer certificate,说明服务端没发中间证书。Nginx 的 ssl_certificate 改为 fullchain.pem,Apache 的 SSLCertificateFile 也指向 fullchain。用 openssl s_client -showcerts -connect example.com:443 -servername example.com 数证书链。

5. Nginx 报 key values mismatch:SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch),表示证书和私钥不配对。分别执行 openssl x509 -noout -modulus -in fullchain.pem | openssl md5 与 openssl rsa -noout -modulus -in example.com.key | openssl md5,两个 MD5 必须一致。

6. curl 报 60:curl: (60) SSL certificate problem: unable to get local issuer certificate,客户端缺链或服务端链不全。先修服务端 fullchain,再用 curl -v --tlsv1.2 https://example.com 观察握手。浏览器 ERR_CERT_AUTHORITY_INVALID 同理。

效果验证:nscurl、OpenSSL、curl 与真机检查

macOS 上优先用 Apple 自带工具:nscurl --ats-diagnostics --verbose https://example.com,它会逐项测试 ATS 配置并输出 PASS/FAIL;对 App 内每个 API 域名都跑一遍。OpenSSL 验证协议和证书:openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName。再检查链验证结果:echo | openssl s_client -connect example.com:443 -servername example.com -tls1_2 2>/dev/null | grep 'Verify return code',应为 0 (ok)。

用 curl 模拟客户端:curl -I https://example.com 和 curl -v --tlsv1.2 https://example.com;如果返回 200/301/302 且证书校验通过,说明基础 HTTPS 正常。进一步用 testssl.sh --fast https://example.com 或 nmap --script ssl-enum-ciphers -p443 example.com 检查是否还开放 TLS 1.0/1.1、弱套件和证书链问题。在线 SSL Labs 评级可作参考,但 ATS 以 nscurl 和真机为准。

真机验证:在 iOS App 的 URLSession 请求中打开 Xcode Console,观察 NSURLErrorDomain 错误;Safari 访问同一域名,确认没有混合内容。WKWebView 页面按 F12 或 Safari 开发菜单检查 HTTP 资源。最后把验证命令写进发布检查单:CSR SAN、fullchain、TLS 1.2+、PFS、到期时间、nscurl PASS、真机请求成功。这样才算完成苹果 ATS 检测与 HTTPS 配置。

常见问题

苹果 ATS 是否要求 EV 证书?

不要求。ATS 只校验证书链、SAN、TLS 版本、前向保密和密钥强度。DV 证书只要满足这些条件即可通过;OV/EV 不会提高 ATS 通过率。

证书最长有效期是 398 天吗?

公开信任 TLS 证书的传统单张上限是 398 天,Let’s Encrypt 默认 90 天;CA/B Forum 新规正在逐步缩短有效期,实际以 CA 签发为准。无论哪种,都应自动续期并监控到期。

一张证书可以绑定几个域名?

单域名证书覆盖一个 FQDN;多域名证书按 SAN 数量计费;通配符只覆盖一级子域。App 请求的每个主机名都必须出现在 SAN 中,www 与不带 www 通常算两个名字。

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

先查是否硬编码 http 或 302 跳到 http,再用 nscurl 看 FAIL 项;常见原因是 TLS 1.0/1.1、非 PFS 套件、证书链不全或 SAN 不匹配。不要先关 ATS,先修服务端。

需要配置 HSTS 吗?

ATS 不强制 HSTS,但 Web 站点建议开启;开启前确保全站 HTTPS、子域策略正确。App 端仍以 ATS 和证书校验为准,HSTS 不能替代证书链修复。

微信和 Android 能兼容吗?

证书通用,现代微信和 Android 支持 TLS 1.2/1.3;很老 Android 可能不信任 ECC 或新根证书。面向旧设备时优先 RSA 2048,并验证根证书链。

内容审核

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