当前位置:首页 > 文章列表 > Golang > Go教程 > Go crypto/tls.CipherSuites 怎样查看当前支持的密码套件

Go crypto/tls.CipherSuites 怎样查看当前支持的密码套件

来源:17golang原创 2026-11-18 20:53:01 0浏览 收藏

如果你想查看当前 Go crypto/tls 实现了哪些可用密码套件,直接调用 tls.CipherSuites()。它返回按套件 ID 排序的 []*tls.CipherSuite,并排除官方标记为存在安全问题的套件;后者可以用 tls.InsecureCipherSuites() 单独查看。

官方文档:https://pkg.go.dev/crypto/tls#CipherSuites

要注意,这个返回值是“当前实现的可用目录”,不是一次连接一定会采用的默认协商顺序。Go 官方文档明确说明,默认套件选择还可能由动态逻辑决定。因此,排查配置时应先打印目录,再结合实际的 tls.Config.CipherSuites 判断。

先用 CipherSuites 打印当前支持的套件

下面的程序把最有用的四个信息放在同一行:数值 ID、名称、可协商的 TLS 版本,以及安全标记。示例只做静态 API 读取,不发起网络连接。

package main

import (
	"crypto/tls"
	"fmt"
)

func main() {
	// CipherSuites 返回当前实现且未被标记为不安全的套件,并按 ID 排序。
	for _, suite := range tls.CipherSuites() {
		fmt.Printf("0x%04X %-42s versions=", suite.ID, suite.Name)
		for i, version := range suite.SupportedVersions {
			// 多个版本用逗号分隔,便于复制到排查日志中。
			if i > 0 {
				fmt.Print(",")
			}
			fmt.Print(tls.VersionName(version))
		}
		fmt.Printf(" insecure=%t\n", suite.Insecure)
	}
}
Go crypto/tls CipherSuites 返回密码套件目录的字段关系说明图
图1:CipherSuites 返回套件目录、ID、名称和支持版本的静态说明图,不是运行截图。

输出中的 SupportedVersions 是该套件能够参与协商的协议版本集合。例如某个套件只出现在 TLS 1.3 版本列表中,就不能把它写入只允许 TLS 1.2 的配置。版本名称用 tls.VersionName 转换,比直接打印数字更适合日志和配置审查。

CipherSuite 的字段分别表示什么

tls.CipherSuite 是一个描述对象,核心字段可以这样理解:

字段用途排查时关注什么
ID协议使用的数值标识写入 tls.Config.CipherSuites 时使用它,而不是名称字符串
Name便于阅读的套件名称用于日志、白名单审查和配置说明
SupportedVersions可以协商该套件的 TLS 版本检查它是否与 MinVersion、MaxVersion 兼容
Insecure对象自身的安全问题标记CipherSuites() 返回的对象通常不在不安全目录中

这里有一个容易混淆的点:套件名称里出现 AES 或 CHACHA20,并不等于它能在任意 TLS 版本下使用。真正的版本边界要看 SupportedVersions,连接的最终结果还要受双方能力和配置共同影响。

不要把 CipherSuites 和 InsecureCipherSuites 混为一谈

需要审计旧配置时,可以把两个目录按 ID 做一次对照。CipherSuites() 表示当前实现且未被标记为不安全的套件,InsecureCipherSuites() 则专门返回官方认为存在安全问题的套件。大多数应用不应该主动使用第二个列表中的项目。

func printInsecureSuites() {
	// 只打印官方单独列出的不安全套件,用于迁移旧配置时的排查。
	for _, suite := range tls.InsecureCipherSuites() {
		fmt.Printf("0x%04X %s versions=%v\n", suite.ID, suite.Name, suite.SupportedVersions)
	}
}

不要用“两个列表的差集”推断默认配置,也不要因为某个套件没有出现在 CipherSuites() 中就断言它从所有 Go 版本中永久删除。标准库的实现目录会随 Go 版本和安全策略变化;文章开头的官方文档地址适合在升级后重新核对。

把目录结果转换成明确的 tls.Config 白名单

如果业务确实需要固定允许列表,建议以套件名称做可读的配置输入,再映射成 ID,并在启动时拒绝未知名称。这样既能避免把字符串直接塞进配置,也能让升级后新增或移除套件变得可见。

func suiteIDs(allowNames []string) ([]uint16, error) {
	// 先建立名称到 ID 的索引,避免把名称误当成 tls.Config 的配置类型。
	byName := make(map[string]uint16)
	for _, suite := range tls.CipherSuites() {
		byName[suite.Name] = suite.ID
	}

	ids := make([]uint16, 0, len(allowNames))
	for _, name := range allowNames {
		id, ok := byName[name]
		if !ok {
			// 未知名称直接报错,防止服务启动后静默使用意外配置。
			return nil, fmt.Errorf("unsupported or insecure cipher suite: %s", name)
		}
		ids = append(ids, id)
	}
	return ids, nil
}

func exampleConfig() (*tls.Config, error) {
	ids, err := suiteIDs([]string{
		"TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256",
	})
	if err != nil {
		return nil, err
	}
	// CipherSuites 使用数值 ID;TLS 版本仍由 MinVersion/MaxVersion 控制。
	return &tls.Config{
		MinVersion:   tls.VersionTLS12,
		CipherSuites: ids,
	}, nil
}
Go tls.Config 通过密码套件名称映射 ID 并结合 TLS 版本设置的结构说明图
图2:从可读名称到 ID,再进入 tls.Config 的静态结构图,不是运行截图。

这个示例只展示配置边界,不代表所有项目都应固定为一个套件。实际白名单至少要与证书类型、客户端覆盖范围和允许的 TLS 版本一起评估;如果没有明确的兼容需求,优先让标准库维护默认选择通常更省心。

常见误区与排查顺序

  1. 先看名称,忽略版本:先读取 SupportedVersions,再对照 MinVersion 和 MaxVersion。
  2. 把目录当成默认顺序:CipherSuites() 按 ID 排序,不能用它推断一次握手的最终选择。
  3. 只改 CipherSuites:如果白名单与证书、协议版本或对端能力不兼容,握手仍可能失败。
  4. 遇到未知名称静默跳过:升级或配置拼写错误时应在启动阶段报错,而不是悄悄退回另一套策略。

小结

tls.CipherSuites() 适合回答“当前 Go 标准库有哪些未被标记为不安全的密码套件”,返回对象里的 ID、Name 和 SupportedVersions 分别服务于配置、阅读和兼容性判断。它不是默认协商结果;需要迁移旧配置时,再用 InsecureCipherSuites() 定位风险项,并在明确需求下把 ID 写入 tls.Config.CipherSuites。

相关问题

为什么 tls.CipherSuites 没有返回我配置里的某个套件?

先检查它是否被归入 InsecureCipherSuites(),再检查当前 Go 版本与构建模式;不要只根据名称判断套件是否仍由当前实现提供。

tls.Config.CipherSuites 应该填名称还是数字?

字段类型是 []uint16,应填套件 ID。名称可以作为外部配置,再通过 tls.CipherSuites() 映射并在启动时校验。

CipherSuites 返回顺序就是握手优先级吗?

不是。官方文档说明返回列表按 ID 排序,而默认选择还可能依赖无法由静态列表表达的动态逻辑。

版本声明
本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
Go io.MultiWriter 怎样把一份写入复制到多个 WriterGo io.MultiWriter 怎样把一份写入复制到多个 Writer
上一篇
Go io.MultiWriter 怎样把一份写入复制到多个 Writer
Go io.ReadFull 怎样读取固定长度数据并区分短读
下一篇
Go io.ReadFull 怎样读取固定长度数据并区分短读
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1099次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1094次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1264次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1204次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1050次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码