tls

package
v0.9.0 Latest Latest
Warning

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

Go to latest
Published: Jul 2, 2026 License: MIT Imports: 14 Imported by: 0

Documentation

Overview

Package tls generates the local CA and wildcard certificate (via crypto/x509) and installs/removes trust in the system and NSS stores.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func CACertLocation added in v0.4.0

func CACertLocation() (string, error)

CACertLocation resolves the CA certificate path without creating any directories, so query-only callers (`proximo config ca-path`) leave a host without proximo state untouched. The file may not exist yet (proximo not installed); callers that care must check.

func CACertPath

func CACertPath() (string, error)

CACertPath is the path to the local CA certificate (PEM).

func CAKeyPath

func CAKeyPath() (string, error)

CAKeyPath is the path to the local CA private key (PEM).

func CertPath

func CertPath() (string, error)

CertPath is the path to the wildcard leaf certificate (PEM).

func Dir

func Dir() (string, error)

Dir returns (creating if needed) the directory holding the CA and certificate material.

func EnsureCA

func EnsureCA() (certPath, keyPath string, err error)

EnsureCA generates a local CA on first use and reuses an existing one on subsequent runs. It returns the CA certificate and key file paths.

func InstallNSSTrust

func InstallNSSTrust(r platform.Runner) error

InstallNSSTrust adds the local CA to the NSS trust databases used by Firefox and Chrome-on-Linux. When certutil is missing it installs nss-tools first. certutil invocations go through the injected Runner; certutil discovery and bootstrap stay on the package helpers.

func InstallSystemTrust

func InstallSystemTrust(r platform.Runner) error

InstallSystemTrust adds the local CA to the OS system trust store using built-in OS tooling. Privileged operations go through the injected Runner so the install step is testable.

func IssueHostCert

func IssueHostCert(caCert *x509.Certificate, caKey *ecdsa.PrivateKey, hosts []string) (certPEM, keyPEM []byte, err error)

IssueHostCert generates a leaf certificate covering the exact hosts, signed by the CA, and returns it PEM-encoded. Validity stays under 398 days to satisfy the Apple/Chrome TLS policy (which rejects longer-lived leaf certs, and also rejects TLD-level wildcards like *.test — hence exact SANs, no wildcard).

func KeyPath

func KeyPath() (string, error)

KeyPath is the path to the wildcard leaf private key (PEM).

func LoadCA

func LoadCA(certPath, keyPath string) (*x509.Certificate, *ecdsa.PrivateKey, error)

LoadCA loads the CA certificate and private key from PEM files.

func Purge

func Purge() error

Purge deletes the local CA and certificate material from disk.

func RemoveNSSTrust

func RemoveNSSTrust(r platform.Runner) error

RemoveNSSTrust removes the local CA from all discovered NSS databases.

func RemoveSystemTrust

func RemoveSystemTrust(r platform.Runner) error

RemoveSystemTrust removes the local CA from the OS system trust store.

Types

This section is empty.

Jump to

Keyboard shortcuts

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