一、这一篇在处理什么
这一篇只处理一件事:在美国西海岸运行的出海营销站,使用维科云的SDK 盾时,如何处理「证书校验失败」。
客户端固定校验某一张旧证书或错误的域名,证书正常轮换后全部无法连接。
看校验失败的证书指纹和域名是否与线上证书一致。
二、美国西海岸的网络和高峰
当地晚间对应亚洲的白天。和亚洲站共用一套高峰预案时,两边会抢同一批容量。用户到美西边缘近,但若源站在亚洲,回源跨太平洋。未缓存的动态请求会把这段距离暴露出来。
排查时:分别看边缘命中和回源耗时。命中高而用户仍慢,问题在用户到边缘;命中低而回源慢,问题在跨洋回源。
不要这样做:只在亚洲时间看美西监控。美西的忙时不在亚洲的忙时。
三、出海营销站要分开的路径
落地页、统计参数和表单提交分开。落地页可以缓存,表单地址使用最终的安全地址,避免再跳一次。
防护边界:国家跳转只能用在没有具体内容的入口。已经分享出去的文章地址不要被改到对方国家的首页。
验证:从另一个地区打开分享链接,应看到原文而不是首页。广告参数在最终页面上仍然存在。
四、SDK 盾怎么接
App 里的登录、下单等关键请求走 SDK 隧道,图片和安装包仍走 CDN。服务端校验时间窗、随机数和签名,不把源站地址写进客户端包。隧道失败时可以降级,但降级必须打点,不能静默改去连源站 IP。
产品说明见SDK 盾。只改和「证书校验失败」有关的域名或路径,不要把出海营销站的其他路径一起改掉。
五、排查步骤
下面五步按因果顺序执行,后一步依赖前一步的结果。步骤针对「证书校验失败」,不是一套通用清单。
- 落地页、带统计参数的访问和表单提交分成三列。 按美西当地晚间看容量,不要和亚洲高峰共用一个阈值。 这一故障在本步要完成的事:确认失败发生在校验阶段,而不是签名阶段。
- 国家跳转只允许发生在没有具体内容的入口。分享出去的文章地址不要被改到首页。 边缘命中高但仍慢,查用户到美西边缘;命中低且回源慢,查跨太平洋回源。 这一故障在本步要完成的事:读出客户端期望的域名和指纹。
- 落地页可以缓存。表单直接提交到最终的安全地址,避免再跳一次。 能缓存的请求先提高命中,不要先加大跨洋带宽。 这一故障在本步要完成的事:与边缘正在下发的证书对比。
- 源站接收表单时核对统计参数还在。参数丢失就先查跳转,不要先改表单程序。 动态请求若必须回亚洲,只把这类请求留在跨洋路径上。 这一故障在本步要完成的事:改为校验系统信任链,或使用可更新的指纹列表。
- 从另一个地区打开分享链接,应看到原文。广告参数在最终页面上仍然存在。 在美西当地晚间复测。用亚洲白天的监控判断美西,不算完成。 这一故障在本步要完成的事:轮换证书前,先发布带新指纹的客户端。
六、处理办法
- 不要把单张叶子证书写死在包里。
- 校验失败使用单独错误码。
- 证书轮换列入客户端发布日历。
改完后在美国西海岸的用户网络上复查,不要只在机房内网看。复查时带上出海营销站的验证:从另一个地区打开分享链接,应看到原文而不是首页。广告参数在最终页面上仍然存在。
七、案例
边缘证书正常更新后,旧包全部失败。包里写死了上一张叶子的指纹。改为信任链校验后,轮换不再要求同步发版。
若同样的现象出现在美国西海岸,额外核对:分别看边缘命中和回源耗时。命中高而用户仍慢,问题在用户到边缘;命中低而回源慢,问题在跨洋回源。
业务侧核对:落地页、统计参数和表单提交分开。落地页可以缓存,表单地址使用最终的安全地址,避免再跳一次。
这个案例只说明怎么定位,不构成容量或可用性承诺。
八、常见问题
问:写死指纹不是更安全吗?
答:只能防住这一张证书被替换,但正常轮换会把自己锁死。
问:系统信任链不够吗?
答:对正常域名够用。若要防系统被植入根证书,再用可更新的指纹。
问:用户不升级怎么办?
答:服务端在过渡期同时保留旧证书不可行,所以不要写死叶子。
问:同一故障换一个地区或一种业务,排查还一样吗?
答:不一样。每一步都先按出海营销站的路径处理,再按美国西海岸的网络条件收窄,最后才做「证书校验失败」这一故障本身的动作。换地区或换业务,前两段操作就会变。
九、边界
只讨论SDK 盾在「证书校验失败」上的处理,地区范围是美国西海岸,业务范围是出海营销站。请遵守当地法律。维科云提供网络能力,不对客户业务内容负责。