tlscert

package
v0.3.3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 16, 2026 License: AGPL-3.0 Imports: 15 Imported by: 0

Documentation

Overview

Package tlscert 提供证书/私钥校验与解析(主控 certs API 与 agent push_cert 落盘共用)。

Index

Constants

This section is empty.

Variables

View Source
var DomainRe = regexp.MustCompile(`^[A-Za-z0-9][A-Za-z0-9.-]*$`)

DomainRe 允许的域名/标签字符,杜绝路径穿越。

Functions

func GenerateSelfSigned

func GenerateSelfSigned(domain string) (certPEM, keyPEM string, err error)

GenerateSelfSigned 生成自签证书(链式代理 TLS + pinnedPeerCertSha256 场景): ECDSA P-256、10 年期、IsCA 自签形态(信任锚兼容),但不置 KeyUsageCertSign—— 它只服务 TLS,不签发任何证书。安全性由中转出站 pin 哈希保证(pin 命中即 验证通过,不依赖 CA 信任链),自签不降低链路安全性。

func NotAfter

func NotAfter(certPEM string) (time.Time, error)

NotAfter 返回证书链 leaf 的到期时间(用于 certs 表)。

func ParseCA added in v0.2.0

func ParseCA(certPEM string) (*x509.Certificate, error)

ParseCA 解析并校验 CA 根证书:第一张证书必须带 BasicConstraints.IsCA=true。 仅用于主控 push_ca 的落盘前校验(节点只需要公钥,不需要私钥)。

func ParseChain

func ParseChain(certPEM string) ([]*x509.Certificate, error)

ParseChain 解析证书链中的全部 CERTIFICATE 块。

func ParseKey

func ParseKey(keyPEM string) (any, error)

ParseKey 解析私钥(PKCS1/PKCS8/EC)。

func ParseLeaf

func ParseLeaf(certPEM string) (*x509.Certificate, error)

ParseLeaf 解析证书链中的第一张证书(leaf;自签/CA 标记不影响)。

func PinSHA256Hex

func PinSHA256Hex(certPEM string) (string, error)

PinSHA256Hex 计算证书链 leaf 的 SHA-256(DER 原始字节,小写 hex)—— 与 xray tlsSettings.pinnedPeerCertSha256 的格式约定一致(v26.6.27 实测)。

func PublicKeysEqual added in v0.3.1

func PublicKeysEqual(a, b crypto.PublicKey) bool

PublicKeysEqual 判断两个公钥是否为同一密钥。

统一走各实现自带的 crypto.PublicKey.Equal:RSA 比 (N,E)、ECDSA 比曲线与坐标、 Ed25519 比完整公钥。不要手工比较 ecdsa.PublicKey.X/Y——该字段自 Go 1.26 起已弃用, 只比坐标会漏掉曲线,RSA 只比 N 会漏掉指数,Ed25519 则根本没有对应分支。

func SanitizeDomain

func SanitizeDomain(domain string) string

SanitizeDomain 供日志使用:去除换行等控制字符。

func ValidatePair

func ValidatePair(certPEM, keyPEM string) error

ValidatePair 校验证书链与私钥:PEM 可解析、链中存在与私钥公钥匹配的证书 (自签证书 IsCA=true 也是合法 leaf,不能按 IsCA 跳过)。

Types

This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL