mirror of
https://github.com/shankar0123/certctl.git
synced 2026-06-07 14:51:30 +00:00
shankar0123
21aeed4f4e
Phase 0 closure (Path B2, post-rewrite):
addlicense sweep — adds the canonical certctl LLC copyright + BUSL-1.1
SPDX header to every production Go file. Template:
// Copyright 2026 certctl LLC. All rights reserved.
// SPDX-License-Identifier: BUSL-1.1
Coverage: 338 / 338 production Go files (cmd/ + internal/, excluding
*_test.go and **/testdata/**). Pre-sweep coverage was 22 / 338 (6.5%);
post-sweep is 338 / 338 (100%).
Normalized 22 pre-existing legacy headers (`// Copyright (c) certctl`
+ `// SPDX-License-Identifier: BSL-1.1`) and 1 file using a
`Certctl Contributors` attribution. The legacy SPDX ID `BSL-1.1`
is non-standard; the official SPDX identifier for Business Source
License 1.1 is `BUSL-1.1` (capital U). All 338 files now share the
canonical form.
Generated via:
addlicense -c "certctl LLC" -y 2026 \
-f cowork/legal/copyright-header.tpl \
-ignore '**/testdata/**' -ignore '**/*_test.go' \
cmd/ internal/
Verification:
find cmd internal -name '*.go' -not -name '*_test.go' \
-not -path '*/testdata/*' \
-exec grep -L '^// Copyright 2026 certctl LLC' {} \; | wc -l
Returns: 0
gofmt clean. Header additions are comments only, no compile impact.
Closes: cowork/certctl-architecture-diligence-audit.html#fix-RED-4
34 lines
1.8 KiB
Go
34 lines
1.8 KiB
Go
// Copyright 2026 certctl LLC. All rights reserved.
|
|
// SPDX-License-Identifier: BUSL-1.1
|
|
|
|
// Package signer abstracts the act of producing cryptographic signatures
|
|
// over digests on behalf of a certificate authority. It exists so that
|
|
// downstream code (leaf-cert issuance, CRL generation, OCSP response
|
|
// signing, SSH CA cert signing — anything that today does
|
|
// x509.CreateCertificate(... caKey)) sees a single interface and does
|
|
// not need to know whether the underlying private key lives on disk, in
|
|
// a PKCS#11 token, in an HSM, or in a cloud KMS.
|
|
//
|
|
// The Signer interface deliberately embeds the stdlib crypto.Signer
|
|
// (Sign + Public) and adds a single method, Algorithm, that returns a
|
|
// value callers can switch on to pick the matching x509.SignatureAlgorithm
|
|
// without reflecting on the concrete key type. This is the only certctl-
|
|
// specific addition; everything else is stdlib-compatible — any
|
|
// crypto.Signer wrapped by this package's Wrap helper becomes a Signer
|
|
// without per-key-type boilerplate at the call site.
|
|
//
|
|
// Driver implementations live in this package today (FileDriver,
|
|
// MemoryDriver). HSM-backed drivers (PKCS#11, cloud KMS) land in
|
|
// follow-on packages (e.g., internal/crypto/signer/pkcs11) and consume
|
|
// this interface unchanged. Adding a driver does not require modifying
|
|
// any existing call site or any other driver.
|
|
//
|
|
// Threat-model note: Signer wraps a crypto.Signer; the bytes-in-process
|
|
// hygiene (heap zeroization, no swap, no core-dump exposure) is the
|
|
// underlying driver's responsibility, not this package's. The L-014
|
|
// carve-out documented at the top of internal/connector/issuer/local/
|
|
// local.go applies to FileDriver-backed signers; alternative drivers
|
|
// (PKCS#11, KMS) close that disk-exposure leg of the threat model
|
|
// because the key never leaves the token / KMS.
|
|
package signer
|