升级Ubuntu 20.04后使用cqlsh连接Amazon Keyspaces报SSL内部错误
故障核心根因
该问题是Ubuntu 18.04升级为20.04后出现的系统环境不兼容问题,与Amazon Keyspaces服务端配置、证书有效性、DNS解析结果无关。核心触发点为两个系统层面的变更:
- Ubuntu 20.04默认搭载OpenSSL 1.1.1f,全局默认SECLEVEL(安全等级)从旧版的1提升至2,会主动拒绝未达到安全强度要求的TLS加密套件握手
- 系统升级后cqlsh关联的Python解释器版本、内置
ssl_transport_factory逻辑,未匹配新的OpenSSL默认安全策略,最终触发_ssl.c:727标记的SSL内部连接错误。
分步排障修复流程
- 校验根证书文件完整性
执行本地证书解析命令,确认证书无下载截断、格式损坏:
若命令执行报错,直接替换损坏的证书文件即可,无需其他调整。openssl x509 -in /home/abc/.cassandra/AmazonRootCA1.pem -noout -subject -issuer - 调整cqlsh独立SSL适配配置
打开本地的~/.cassandra/cqlshrc文件,在原有[ssl]配置块下补充适配参数,无需修改系统全局OpenSSL配置文件:
上述配置仅对当前用户的cqlsh进程生效,不会降低系统全局的TLS安全基线。[ssl] validate = true certfile = /home/abc/.cassandra/AmazonRootCA1.pem ssl_version = SSLv23 cipher_suites = HIGH:!aNULL:!MD5:@SECLEVEL=1 - 校验cqlsh运行环境兼容性
检查当前cqlsh脚本关联的Python解释器版本:
若输出指向Python2解释器,直接替换为匹配Python3的cqlsh版本,基于Python2的老旧cqlsh无法适配Ubuntu 20.04的ssl模块逻辑,是触发内部SSL错误的常见诱因。head -n 1 $(which cqlsh) - 复现连接验证
完成上述调整后,执行原cqlsh连接命令测试连通性。若仍存在握手失败,可在连接命令后追加--debug参数查看详细握手日志,剩余常见故障点为本地Python的cryptography库版本过低,升级对应库版本即可解决。
避坑提示
- 不要为了快速解决问题直接修改系统全局
/etc/ssl/openssl.cnf中的SECLEVEL参数,会导致系统所有HTTPS、TLS服务的安全强度下降 - 不要关闭证书校验开关绕过验证,避免触发中间人攻击风险
内容的提问来源于stack exchange,提问作者sdgfsdh
相关产品推荐
相关产品推荐

