Files
2026-09-21 09:12:53 +01:00

24 lines
1.2 KiB
Go

// Package testca provides utilities for creating test Certificate Authorities
// and certificates for testing and development purposes.
//
// This package supports:
// - Generation of test CA certificates and private keys
// - Creation of end-entity certificates signed by test CAs
// - Certificate chain building for testing
// - Generation of various key types (RSA, ECDSA) for testing
// - PEM encoding/decoding utilities for test certificates
//
// The package is primarily intended for use in unit tests and development
// environments where real certificates are not required or desired.
//
// Default common names and issuer serial numbers are allocated safely across
// concurrent NewEntity and Entity.Issue calls. Configure package defaults,
// entity fields, and option data before starting concurrent calls, and leave
// them unchanged until the calls finish. Custom private keys must support
// concurrent signing. Access Entity.NextSN directly only while issuance and
// Entity.IncrementSN calls are stopped; do not copy an Entity after first use.
//
// Note: Certificates generated by this package should never be used in
// production environments as they are not trusted by any real PKI.
package testca