mirror of
https://github.com/shankar0123/certctl.git
synced 2026-06-07 22:31:36 +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
105 lines
4.3 KiB
Go
105 lines
4.3 KiB
Go
// Copyright 2026 certctl LLC. All rights reserved.
|
|
// SPDX-License-Identifier: BUSL-1.1
|
|
|
|
package domain
|
|
|
|
import "time"
|
|
|
|
// RevocationReason represents the reason for revoking a certificate.
|
|
// Values align with RFC 5280 Section 5.3.1 CRL reason codes.
|
|
type RevocationReason string
|
|
|
|
const (
|
|
RevocationReasonUnspecified RevocationReason = "unspecified"
|
|
RevocationReasonKeyCompromise RevocationReason = "keyCompromise"
|
|
RevocationReasonCACompromise RevocationReason = "caCompromise"
|
|
RevocationReasonAffiliationChanged RevocationReason = "affiliationChanged"
|
|
RevocationReasonSuperseded RevocationReason = "superseded"
|
|
RevocationReasonCessationOfOperation RevocationReason = "cessationOfOperation"
|
|
RevocationReasonCertificateHold RevocationReason = "certificateHold"
|
|
RevocationReasonPrivilegeWithdrawn RevocationReason = "privilegeWithdrawn"
|
|
)
|
|
|
|
// ValidRevocationReasons contains all valid revocation reason strings.
|
|
var ValidRevocationReasons = map[RevocationReason]int{
|
|
RevocationReasonUnspecified: 0,
|
|
RevocationReasonKeyCompromise: 1,
|
|
RevocationReasonCACompromise: 2,
|
|
RevocationReasonAffiliationChanged: 3,
|
|
RevocationReasonSuperseded: 4,
|
|
RevocationReasonCessationOfOperation: 5,
|
|
RevocationReasonCertificateHold: 6,
|
|
RevocationReasonPrivilegeWithdrawn: 9,
|
|
}
|
|
|
|
// IsValidRevocationReason checks whether a reason string is a valid RFC 5280 reason code.
|
|
func IsValidRevocationReason(reason string) bool {
|
|
_, ok := ValidRevocationReasons[RevocationReason(reason)]
|
|
return ok
|
|
}
|
|
|
|
// CRLReasonCode returns the RFC 5280 integer reason code for a revocation reason.
|
|
func CRLReasonCode(reason RevocationReason) int {
|
|
if code, ok := ValidRevocationReasons[reason]; ok {
|
|
return code
|
|
}
|
|
return 0 // unspecified
|
|
}
|
|
|
|
// BulkRevocationCriteria defines the filter criteria for bulk certificate revocation.
|
|
// At least one field must be set — empty criteria is rejected as a safety guard.
|
|
type BulkRevocationCriteria struct {
|
|
ProfileID string `json:"profile_id,omitempty"`
|
|
OwnerID string `json:"owner_id,omitempty"`
|
|
AgentID string `json:"agent_id,omitempty"`
|
|
IssuerID string `json:"issuer_id,omitempty"`
|
|
TeamID string `json:"team_id,omitempty"`
|
|
CertificateIDs []string `json:"certificate_ids,omitempty"`
|
|
// Source filters by ManagedCertificate.Source provenance value.
|
|
// Empty matches any source (back-compat with v2.X.0 callers); the
|
|
// EST bulk-revoke endpoint pins this to CertificateSourceEST so an
|
|
// operator hitting POST /api/v1/est/certificates/bulk-revoke only
|
|
// affects EST-issued certs, never SCEP/API/Agent-provisioned ones.
|
|
//
|
|
// EST RFC 7030 hardening master bundle Phase 11.2.
|
|
Source CertificateSource `json:"source,omitempty"`
|
|
}
|
|
|
|
// IsEmpty returns true if no filter criteria are set. Source alone does
|
|
// NOT count as a criterion — a Source=EST request without any narrower
|
|
// criterion (profile_id, owner_id, etc.) is rejected as too broad,
|
|
// because it would revoke EVERY EST-issued cert in the deployment.
|
|
func (c BulkRevocationCriteria) IsEmpty() bool {
|
|
return c.ProfileID == "" && c.OwnerID == "" && c.AgentID == "" &&
|
|
c.IssuerID == "" && c.TeamID == "" && len(c.CertificateIDs) == 0
|
|
}
|
|
|
|
// BulkRevocationResult contains the outcome of a bulk revocation operation.
|
|
type BulkRevocationResult struct {
|
|
TotalMatched int `json:"total_matched"`
|
|
TotalRevoked int `json:"total_revoked"`
|
|
TotalSkipped int `json:"total_skipped"`
|
|
TotalFailed int `json:"total_failed"`
|
|
Errors []BulkRevocationError `json:"errors,omitempty"`
|
|
}
|
|
|
|
// BulkRevocationError records a per-certificate revocation failure.
|
|
type BulkRevocationError struct {
|
|
CertificateID string `json:"certificate_id"`
|
|
Error string `json:"error"`
|
|
}
|
|
|
|
// CertificateRevocation records the revocation of a specific certificate version.
|
|
// Used as the authoritative source for CRL generation.
|
|
type CertificateRevocation struct {
|
|
ID string `json:"id"`
|
|
CertificateID string `json:"certificate_id"`
|
|
SerialNumber string `json:"serial_number"`
|
|
Reason string `json:"reason"`
|
|
RevokedBy string `json:"revoked_by"`
|
|
RevokedAt time.Time `json:"revoked_at"`
|
|
IssuerID string `json:"issuer_id"`
|
|
IssuerNotified bool `json:"issuer_notified"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
}
|