tlscert

package
v0.1.19 Latest Latest
Warning

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

Go to latest
Published: Sep 25, 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 自签根形态。安全性由中转出站 pin 哈希保证(pin 命中即 验证通过,不依赖 CA 信任链),自签不降低链路安全性。

func NotAfter

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

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

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 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