一、TLCP/GMSSL 概念TLCP 是国家标准协议GB/T 38636-2020/GM/T 0024-2014非标准叫法也有叫GMSSL协议的这个和GMSSL开源库( 实现TLCP协议的开源密码库名称容易造成混淆所以标准的统一名称应为 TLCP协议如果需要抓包查看需Wireshark 版本支持国密解析或配置密钥日志解密。1、核心概念辨析TLCPTransport Layer Cryptography Protocol中国自主制定的传输层密码协议标准基于 SM2/SM3/SM4 算法采用双证书机制协议版本号通常为0x0101。GMSSL北京大学开发的开源密码工具箱实现了TLCP 协议及国密算法常被误称为“国密 SSL它既支持 TLCP 也支持标准 TLS 1.3。关系TLCP 是“标准规范”GMSSL 是“实现工具”之一类似 OpenSSL 与 TLS 的关系两者不可等同 。2、抓包可见性条件要清晰识别并解析 TLCP 流量无需修改客户端与服务端的业务代码只要它们正确使用了支持 TLCP 的库如 GmSSL/Tongsuo关键在于抓包工具的解析能力和密钥获取2.1、 Wireshark 端要求必须满足其一新版/定制版 Wireshark官方 Wireshark 3.4 开始逐步增加对 TLCP 的基础识别显示为GMSSL或TLCP但深度解析如 SM2 签名验证细节可能需要特定编译版本或插件部分场景下标准版仅能识别握手头部应用数据仍为密文 。密钥日志解密推荐通用方案在客户端/服务端启动时设置环境变量SSLKEYLOGFILEGmSSL 命令行及部分库支持将会话密钥写入文件并在 Wireshark 首选项中指定该文件路径即可解密查看明文无需 Wireshark 特殊版本 。2.2、客户端/服务端端要求无需“改造”协议栈只要两端均配置了 TLCP 密码套件如ECC-SM2-WITH-SM4-SM3并成功握手流量即符合 TLCP 格式。需确保密钥导出若需 Wireshark 解密内容需确认所用库如 GmSSL支持输出 Pre-Master Secret 到日志文件若仅观察握手过程不解密应用数据普通 Wireshark 即可看到ClientHello中的国密套件标识 。二、抓包协议显示误解TLCP协议在通过 Wireshark 抓包时通常显示名称为TLCP但是有些版本会显示为GMSSL这个显示差异是抓包工具的协议识别规则不同。1、显示差异的核心原因Wireshark等抓包工具的不同版本对该协议的标识命名存在区别早期版本将国密传输层协议标注为GMSSL后续版本根据国标规范更新识别逻辑将其正式标注为TLCP这只是工具侧的显示命名差异。2、底层算法与操作逻辑完全一致两种显示对应的都是符合GB/T 38636-2020标准的国密传输层协议都采用SM2双证书身份认证、SM3哈希、SM4对称加密的算法组合握手流程里的双证书发送、密钥交换、签名验证等操作逻辑完全相同不存在协议层面的本质区别。三、SSL/TLS/TLCP的版本号与对应密码套件对照1、抓包工具显示规则Wireshark等抓包工具对握手协议的标记是基于协议本身的版本号核心依据是握手报文头部的协议版本号SSL/TLS的版本号为0x0300SSL 3.0、0x0301TLS 1.0、0x0303TLS 1.2等TLCP/GMSSL的版本号为国密专属的0x0101工具优先识别该版本字段再结合后续算法套件完成协议标注。以下整理SSL/TLS/TLCP的版本号与对应密码套件对照表方便抓包时快速区分识别2、国际标准SSL/TLS 版本与密码套件协议版本报文版本号核心密码套件示例特点说明SSL 3.00x0300SSL_RSA_WITH_RC4_128_SHA已全面淘汰存在POODLE等高危漏洞TLS 1.00x0301TLS_RSA_WITH_AES_128_CBC_SHA已全网禁用仅兼容极老旧系统TLS 1.10x0302TLS_RSA_WITH_AES_256_CBC_SHA基本淘汰无现代浏览器默认支持TLS 1.20x0303ECDHE-RSA-AES256-GCM-SHA384TLS_SM4_GCM_SM3国密扩展存量主流支持国密扩展套件TLS 1.30x0304TLS_AES_256_GCM_SHA384TLS_SM4_GCM_SM3RFC8998标准现代首选握手速度快、安全性高3、国密TLCPGMSSL版本与密码套件协议版本报文版本号核心密码套件示例特点说明TLCP 1.10x0101TLCP_ECC_SM4_GCM_SM3TLCP_ECC_SM4_CBC_SM3国内合规主流采用双证书体系全链路使用SM2/SM3/SM4国密算法4、抓包快速识别技巧先看握手报文头部的2字节版本号直接区分是国际TLS0x03xx还是国密TLCP0x0101再看协商出的密码套件名称带SM2/SM3/SM4标识的就是国密算法套件其余为国际算法套件若TLS 1.2/1.3报文中出现SM系列套件说明是支持国密扩展的国际标准TLS不属于TLCP协议。四、Wireshark中不同协议的抓包直观识别特征1、标准SSL/TLS 抓包特征握手报文头部版本号为0x030x格式Wireshark协议列直接显示TLSv1.2/TLSv1.3标识ClientHello的Cipher Suites列表里默认以TLS_前缀开头常见AES、SHA系列国际算法套件证书交换阶段仅返回单张RSA/ECC证书不会出现“签名证书加密证书”的双证书结构2、国密TLCP/GMSSL 抓包特征握手报文头部版本号固定为0x0101新版Wireshark协议列显示TLCP旧版显示GMSSLClientHello的Cipher Suites列表里套件以ECC_前缀开头全是SM2/SM3/SM4国密算法组合证书交换阶段会连续返回两张证书第一张为SM2签名证书第二张为SM2加密证书是TLCP独有的双证书标识3、特殊国密扩展TLS 抓包特征协议版本号仍为TLS 1.2/1.3的0x0303/0x0304Wireshark协议列显示为TLS而非TLCP密码套件里出现TLS_SM4_GCM_SM3这类国密扩展套件属于RFC8998定义的标准国密TLS不是TLCP协议证书仅返回单张支持SM2算法的证书没有TLCP的双证书结构五、Wireshark解密TLCP流量配置以下是完整的Wireshark解密TLCP流量配置步骤1、前置环境准备安装3.4版本以上的Wireshark推荐使用支持国密解析的定制版确保自带GMSSL/TLCP协议解析模块。部署基于GmSSL的TLCP客户端/服务端环境编译GmSSL时需开启enable-tlcp参数确保工具支持导出会话密钥。2、配置密钥日志导出在启动TLCP客户端前设置环境变量指定密钥日志文件路径GmSSL的s_client/s_server工具原生支持该配置Linux/macOS 终端执行exportSSLKEYLOGFILE/我的自定义的路径/tlcp_sslkeylog.txt 随后启动GmSSL国密客户端程序 ./my_gmssl_clientWindows系统可在系统环境变量中新增同名变量设置对应日志文件路径即可。3、Wireshark端关联密钥文件打开Wireshark依次进入「编辑」→「首选项」→「协议」→「TLS」配置页。在(Pre)-Master-Secret log filename输入框中填入刚才设置的tlcp_sslkeylog.txt完整路径点击确认保存。4、抓包验证解密效果启动Wireshark在443端口抓包过滤TLCP流量使用过滤表达式tlcp.version 0x0101完成TLCP握手后原本加密的Application Data字段会自动解密为明文内容。注意非GmSSL的第三方国密库可能不支持SSLKEYLOGFILE环境变量需查阅对应库文档确认密钥导出方式。六、TLCP抓包异常排查以下整理完整的TLCP抓包异常排查清单覆盖握手失败、解密失败等高频问题1、握手失败排查SNI扩展校验用Wireshark查看Client Hello消息确认Extension字段中存在正确的SNI主机名缺失SNI是TLCP握手失败的最常见原因。编译配置核对检查客户端GmSSL编译参数确认已开启--enable-tlcp和SNI扩展支持自编译版本常因配置缺失导致握手异常。服务器兼容性测试切换到不强制SNI的国密测试服务器验证确认是否是目标服务器强制要求SNI扩展导致的连接中断。版本差异对比将自编译客户端与官方gmcurl工具的抓包报文做对比定位Client Hello中缺失的扩展字段。2、解密失败排查SM2密文格式校验抓包查看Client Key Exchange阶段的SM2密文前缀若出现0x208199/0x20819a这类带前补0x00的ASN1编码需确认解密端已做坐标去前导零处理避免抛出无效点坐标错误。密钥日志配置检查确认客户端已正确设置SSLKEYLOGFILE环境变量Wireshark首选项中已指定该日志文件路径确保能读取到TLCP会话的预主密钥。套件匹配验证确认协商出的密码套件在Wireshark的国密支持列表内部分老旧版本Wireshark无法识别TLCP专属的ECC_SM4_CBC_SM3套件会导致应用数据无法解密。3、显示异常排查协议标识修正若抓包显示为GMSSL而非TLCP升级Wireshark到3.6以上版本新版已按国标规范将该协议标识统一标注为TLCP。报文过滤优化使用过滤表达式tlcp.version 0x0101精准筛选TLCP流量避免和带国密扩展的标准TLS流量混淆。
一、TLCP/GMSSL 概念TLCP 是国家标准协议GB/T 38636-2020/GM/T 0024-2014非标准叫法也有叫GMSSL协议的这个和GMSSL开源库( 实现TLCP协议的开源密码库名称容易造成混淆所以标准的统一名称应为 TLCP协议如果需要抓包查看需Wireshark 版本支持国密解析或配置密钥日志解密。1、核心概念辨析TLCPTransport Layer Cryptography Protocol中国自主制定的传输层密码协议标准基于 SM2/SM3/SM4 算法采用双证书机制协议版本号通常为0x0101。GMSSL北京大学开发的开源密码工具箱实现了TLCP 协议及国密算法常被误称为“国密 SSL它既支持 TLCP 也支持标准 TLS 1.3。关系TLCP 是“标准规范”GMSSL 是“实现工具”之一类似 OpenSSL 与 TLS 的关系两者不可等同 。2、抓包可见性条件要清晰识别并解析 TLCP 流量无需修改客户端与服务端的业务代码只要它们正确使用了支持 TLCP 的库如 GmSSL/Tongsuo关键在于抓包工具的解析能力和密钥获取2.1、 Wireshark 端要求必须满足其一新版/定制版 Wireshark官方 Wireshark 3.4 开始逐步增加对 TLCP 的基础识别显示为GMSSL或TLCP但深度解析如 SM2 签名验证细节可能需要特定编译版本或插件部分场景下标准版仅能识别握手头部应用数据仍为密文 。密钥日志解密推荐通用方案在客户端/服务端启动时设置环境变量SSLKEYLOGFILEGmSSL 命令行及部分库支持将会话密钥写入文件并在 Wireshark 首选项中指定该文件路径即可解密查看明文无需 Wireshark 特殊版本 。2.2、客户端/服务端端要求无需“改造”协议栈只要两端均配置了 TLCP 密码套件如ECC-SM2-WITH-SM4-SM3并成功握手流量即符合 TLCP 格式。需确保密钥导出若需 Wireshark 解密内容需确认所用库如 GmSSL支持输出 Pre-Master Secret 到日志文件若仅观察握手过程不解密应用数据普通 Wireshark 即可看到ClientHello中的国密套件标识 。二、抓包协议显示误解TLCP协议在通过 Wireshark 抓包时通常显示名称为TLCP但是有些版本会显示为GMSSL这个显示差异是抓包工具的协议识别规则不同。1、显示差异的核心原因Wireshark等抓包工具的不同版本对该协议的标识命名存在区别早期版本将国密传输层协议标注为GMSSL后续版本根据国标规范更新识别逻辑将其正式标注为TLCP这只是工具侧的显示命名差异。2、底层算法与操作逻辑完全一致两种显示对应的都是符合GB/T 38636-2020标准的国密传输层协议都采用SM2双证书身份认证、SM3哈希、SM4对称加密的算法组合握手流程里的双证书发送、密钥交换、签名验证等操作逻辑完全相同不存在协议层面的本质区别。三、SSL/TLS/TLCP的版本号与对应密码套件对照1、抓包工具显示规则Wireshark等抓包工具对握手协议的标记是基于协议本身的版本号核心依据是握手报文头部的协议版本号SSL/TLS的版本号为0x0300SSL 3.0、0x0301TLS 1.0、0x0303TLS 1.2等TLCP/GMSSL的版本号为国密专属的0x0101工具优先识别该版本字段再结合后续算法套件完成协议标注。以下整理SSL/TLS/TLCP的版本号与对应密码套件对照表方便抓包时快速区分识别2、国际标准SSL/TLS 版本与密码套件协议版本报文版本号核心密码套件示例特点说明SSL 3.00x0300SSL_RSA_WITH_RC4_128_SHA已全面淘汰存在POODLE等高危漏洞TLS 1.00x0301TLS_RSA_WITH_AES_128_CBC_SHA已全网禁用仅兼容极老旧系统TLS 1.10x0302TLS_RSA_WITH_AES_256_CBC_SHA基本淘汰无现代浏览器默认支持TLS 1.20x0303ECDHE-RSA-AES256-GCM-SHA384TLS_SM4_GCM_SM3国密扩展存量主流支持国密扩展套件TLS 1.30x0304TLS_AES_256_GCM_SHA384TLS_SM4_GCM_SM3RFC8998标准现代首选握手速度快、安全性高3、国密TLCPGMSSL版本与密码套件协议版本报文版本号核心密码套件示例特点说明TLCP 1.10x0101TLCP_ECC_SM4_GCM_SM3TLCP_ECC_SM4_CBC_SM3国内合规主流采用双证书体系全链路使用SM2/SM3/SM4国密算法4、抓包快速识别技巧先看握手报文头部的2字节版本号直接区分是国际TLS0x03xx还是国密TLCP0x0101再看协商出的密码套件名称带SM2/SM3/SM4标识的就是国密算法套件其余为国际算法套件若TLS 1.2/1.3报文中出现SM系列套件说明是支持国密扩展的国际标准TLS不属于TLCP协议。四、Wireshark中不同协议的抓包直观识别特征1、标准SSL/TLS 抓包特征握手报文头部版本号为0x030x格式Wireshark协议列直接显示TLSv1.2/TLSv1.3标识ClientHello的Cipher Suites列表里默认以TLS_前缀开头常见AES、SHA系列国际算法套件证书交换阶段仅返回单张RSA/ECC证书不会出现“签名证书加密证书”的双证书结构2、国密TLCP/GMSSL 抓包特征握手报文头部版本号固定为0x0101新版Wireshark协议列显示TLCP旧版显示GMSSLClientHello的Cipher Suites列表里套件以ECC_前缀开头全是SM2/SM3/SM4国密算法组合证书交换阶段会连续返回两张证书第一张为SM2签名证书第二张为SM2加密证书是TLCP独有的双证书标识3、特殊国密扩展TLS 抓包特征协议版本号仍为TLS 1.2/1.3的0x0303/0x0304Wireshark协议列显示为TLS而非TLCP密码套件里出现TLS_SM4_GCM_SM3这类国密扩展套件属于RFC8998定义的标准国密TLS不是TLCP协议证书仅返回单张支持SM2算法的证书没有TLCP的双证书结构五、Wireshark解密TLCP流量配置以下是完整的Wireshark解密TLCP流量配置步骤1、前置环境准备安装3.4版本以上的Wireshark推荐使用支持国密解析的定制版确保自带GMSSL/TLCP协议解析模块。部署基于GmSSL的TLCP客户端/服务端环境编译GmSSL时需开启enable-tlcp参数确保工具支持导出会话密钥。2、配置密钥日志导出在启动TLCP客户端前设置环境变量指定密钥日志文件路径GmSSL的s_client/s_server工具原生支持该配置Linux/macOS 终端执行exportSSLKEYLOGFILE/我的自定义的路径/tlcp_sslkeylog.txt 随后启动GmSSL国密客户端程序 ./my_gmssl_clientWindows系统可在系统环境变量中新增同名变量设置对应日志文件路径即可。3、Wireshark端关联密钥文件打开Wireshark依次进入「编辑」→「首选项」→「协议」→「TLS」配置页。在(Pre)-Master-Secret log filename输入框中填入刚才设置的tlcp_sslkeylog.txt完整路径点击确认保存。4、抓包验证解密效果启动Wireshark在443端口抓包过滤TLCP流量使用过滤表达式tlcp.version 0x0101完成TLCP握手后原本加密的Application Data字段会自动解密为明文内容。注意非GmSSL的第三方国密库可能不支持SSLKEYLOGFILE环境变量需查阅对应库文档确认密钥导出方式。六、TLCP抓包异常排查以下整理完整的TLCP抓包异常排查清单覆盖握手失败、解密失败等高频问题1、握手失败排查SNI扩展校验用Wireshark查看Client Hello消息确认Extension字段中存在正确的SNI主机名缺失SNI是TLCP握手失败的最常见原因。编译配置核对检查客户端GmSSL编译参数确认已开启--enable-tlcp和SNI扩展支持自编译版本常因配置缺失导致握手异常。服务器兼容性测试切换到不强制SNI的国密测试服务器验证确认是否是目标服务器强制要求SNI扩展导致的连接中断。版本差异对比将自编译客户端与官方gmcurl工具的抓包报文做对比定位Client Hello中缺失的扩展字段。2、解密失败排查SM2密文格式校验抓包查看Client Key Exchange阶段的SM2密文前缀若出现0x208199/0x20819a这类带前补0x00的ASN1编码需确认解密端已做坐标去前导零处理避免抛出无效点坐标错误。密钥日志配置检查确认客户端已正确设置SSLKEYLOGFILE环境变量Wireshark首选项中已指定该日志文件路径确保能读取到TLCP会话的预主密钥。套件匹配验证确认协商出的密码套件在Wireshark的国密支持列表内部分老旧版本Wireshark无法识别TLCP专属的ECC_SM4_CBC_SM3套件会导致应用数据无法解密。3、显示异常排查协议标识修正若抓包显示为GMSSL而非TLCP升级Wireshark到3.6以上版本新版已按国标规范将该协议标识统一标注为TLCP。报文过滤优化使用过滤表达式tlcp.version 0x0101精准筛选TLCP流量避免和带国密扩展的标准TLS流量混淆。
