Files
certctl/internal/service/est_audit_actions_test.go
T
shankar0123 5a682db8e2 EST RFC 7030 hardening master bundle Phases 10-11: libest sidecar e2e
+ Cisco IOS quirk fixtures + ManagedCertificate.Source provenance +
EST bulk-revoke endpoint + 13 typed audit action codes.

Phase 10.1 — libest reference-client sidecar:
- deploy/test/libest/Dockerfile: multi-stage Debian-bookworm-slim
  build of Cisco's libest v3.2.0-2 from source (autoconf/automake/
  libtool + libcurl4-openssl-dev + libssl-dev). Runtime stage
  carries only estclient + bash + openssl + ca-certificates so the
  exec surface stays small + predictable.
- docker-compose.test.yml libest-client entry (profiles: [est-e2e])
  with bind mounts for /config/est (test workspace) + /config/certs
  (certctl CA bundle for TLS pinning); IP 10.30.50.9 (10.30.50.8
  was already taken by certctl-agent).
- deploy/test/est/.gitkeep keeps the bind-mount target tracked.

Phase 10.2 — 5 integration tests (//go:build integration) in
deploy/test/est_e2e_test.go:
- TestEST_LibESTClient_Enrollment_Integration (cacerts → simpleenroll
  → cert-shape assertion)
- TestEST_LibESTClient_MTLSEnrollment_Integration (mTLS sibling-route
  cert auth; skip when bootstrap cert absent)
- TestEST_LibESTClient_ServerKeygen_Integration (RFC 7030 §4.4
  multipart; skip when profile gate disabled)
- TestEST_LibESTClient_RateLimited_Integration (4th enroll trips
  per-principal cap, asserts 429-shaped error)
- TestEST_LibESTClient_ChannelBinding_Integration (libest
  --tls-exporter; skip when libest build lacks the flag).
- requireESTSidecar guard skips the suite when the operator forgot
  --profile est-e2e; helpful error message includes the exact
  command to bring the sidecar up.

Phase 10.3 — Cisco IOS quirk fixtures + 3 unit tests in
internal/api/handler/cisco_ios_quirks_test.go:
- testdata/cisco_ios_15x_pem_csr.txt: PEM body sent with
  Content-Type application/x-pem-file. Handler dispatches on
  body-prefix not Content-Type — accepts cleanly.
- testdata/cisco_ios_16x_trailing_newline_csr.txt: extra trailing
  newlines after base64 body. strings.TrimSpace tolerates.
- testdata/cisco_ios_crlf_b64_csr.txt: CRLF-wrapped base64.
  base64.StdEncoding handles CRLF + LF identically.

Phase 11.1 — ManagedCertificate.Source provenance:
- New domain.CertificateSource enum (Unspecified/EST/SCEP/API/Agent).
- Migration 000023_managed_certificates_source.up.sql adds source
  TEXT NOT NULL DEFAULT '' so existing rows scan as
  CertificateSourceUnspecified — back-compat: bulk-revoke filter
  treats empty as "any source".
- Postgres repo Insert/Update/scan paths all wire the new column.

Phase 11.2 — EST bulk-revoke endpoint:
- BulkRevocationCriteria.Source field (Source-only requests rejected
  as too broad — must accompany at least one narrower criterion).
- service.bulk_revocation.resolveCertificates post-filter by Source
  (empty=any, no SQL change so existing CertificateFilter callers
  unaffected).
- New BulkRevocationHandler.BulkRevokeEST method pins Source=EST +
  dispatches; new route POST /api/v1/est/certificates/bulk-revoke
  (M-008 admin-gated). openapi.yaml documented + parity-guard green.

Phase 11.3 — 13 typed audit action codes in
internal/service/est_audit_actions.go:
- est_simple_enroll_success / _failed
- est_simple_reenroll_success / _failed
- est_server_keygen_success / _failed
- est_auth_failed_basic / _mtls / _channel_binding
- est_rate_limited
- est_csr_policy_violation
- est_bulk_revoke
- est_trust_anchor_reloaded
- ESTService.processEnrollment + SimpleServerKeygen + ReloadTrust
  split-emit BOTH the legacy bare action codes (back-compat for the
  GUI activity-tab chip filters that match by exact string +
  existing audit-log analysers) AND the new typed _success / _failed
  variants (operator grep target + per-failure-mode counter).

Tests:
- internal/api/handler/bulk_revocation_est_test.go — 5 cases
  (admin-true happy path pins Source=EST + non-admin 403 +
  empty-criteria 400 + invalid-reason 400 + method-not-allowed).
- internal/service/est_audit_actions_test.go — 5 cases (SimpleEnroll
  legacy+typed emission / SimpleReEnroll typed / IssuerError
  typed-failed / PolicyViolation triple-emit /
  unique-string invariant).

Pre-commit verification (sandbox): gofmt clean, go vet clean
(excluding repository/postgres testcontainers limit), staticcheck
clean across api/handler/api/router/domain/service/deploy/test,
go test -short -count=1 green for every non-postgres Go package +
integration build (`go build -tags integration ./deploy/test/...`)
clean. G-3 docs-drift guard reproduced locally clean (Phases 10-11
added zero new env vars).

Spec preserved at cowork/est-rfc7030-hardening-prompt.md. Phases
12-13 (docs/est.md + WiFi/802.1X / IoT bootstrap / FreeRADIUS
recipes; release prep + tag) remain — post-2.1.0 work.
2026-04-30 00:52:43 +00:00

157 lines
5.4 KiB
Go

package service
import (
"context"
"errors"
"io"
"log/slog"
"strings"
"testing"
"github.com/shankar0123/certctl/internal/domain"
)
// EST RFC 7030 hardening master bundle Phase 11.4 — audit-code assertions.
// Drive each code path through a real ESTService instance + assert the
// typed action codes land in the audit log alongside the legacy bare
// codes (back-compat preservation).
func newAuditAssertService(t *testing.T) (*ESTService, *mockAuditRepo) {
t.Helper()
auditRepo := newMockAuditRepository()
auditSvc := NewAuditService(auditRepo)
silent := slog.New(slog.NewTextHandler(io.Discard, &slog.HandlerOptions{Level: slog.LevelError + 10}))
svc := NewESTService("iss-corp", &mockIssuerConnector{}, auditSvc, silent)
return svc, auditRepo
}
// auditActions returns the action codes recorded across every audit
// event in the repo, in emission order. Used to assert that the
// typed _success / _failed events fire in the right order alongside
// the legacy bare codes.
func auditActions(repo *mockAuditRepo) []string {
out := make([]string, 0, len(repo.Events))
for _, e := range repo.Events {
out = append(out, e.Action)
}
return out
}
func TestESTAudit_SimpleEnrollSuccess_EmitsLegacyAndTyped(t *testing.T) {
svc, repo := newAuditAssertService(t)
csrPEM := generateCSRPEM(t, "device.example.com", []string{"device.example.com"})
if _, err := svc.SimpleEnroll(context.Background(), csrPEM); err != nil {
t.Fatalf("SimpleEnroll: %v", err)
}
got := auditActions(repo)
wantBare := "est_simple_enroll"
wantTyped := AuditActionESTSimpleEnrollSuccess // est_simple_enroll_success
if !stringSliceContains(got, wantBare) {
t.Errorf("missing legacy bare code %q in %v", wantBare, got)
}
if !stringSliceContains(got, wantTyped) {
t.Errorf("missing typed code %q in %v", wantTyped, got)
}
}
func TestESTAudit_SimpleReEnrollSuccess_EmitsTyped(t *testing.T) {
svc, repo := newAuditAssertService(t)
csrPEM := generateCSRPEM(t, "device.example.com", nil)
if _, err := svc.SimpleReEnroll(context.Background(), csrPEM); err != nil {
t.Fatalf("SimpleReEnroll: %v", err)
}
if !stringSliceContains(auditActions(repo), AuditActionESTSimpleReEnrollSuccess) {
t.Errorf("missing %q; got %v", AuditActionESTSimpleReEnrollSuccess, auditActions(repo))
}
}
func TestESTAudit_IssuerError_EmitsTypedFailed(t *testing.T) {
auditRepo := newMockAuditRepository()
auditSvc := NewAuditService(auditRepo)
silent := slog.New(slog.NewTextHandler(io.Discard, &slog.HandlerOptions{Level: slog.LevelError + 10}))
svc := NewESTService("iss-corp", &mockIssuerConnector{Err: errors.New("CA down")}, auditSvc, silent)
csrPEM := generateCSRPEM(t, "device.example.com", nil)
if _, err := svc.SimpleEnroll(context.Background(), csrPEM); err == nil {
t.Fatal("expected enroll error")
}
if !stringSliceContains(auditActions(auditRepo), AuditActionESTSimpleEnrollFailed) {
t.Errorf("missing typed failure code; got %v", auditActions(auditRepo))
}
// And the bare _failed variant for back-compat:
if !stringSliceContains(auditActions(auditRepo), "est_simple_enroll_failed") {
t.Errorf("missing bare _failed variant; got %v", auditActions(auditRepo))
}
}
func TestESTAudit_PolicyViolation_EmitsTypedAndStandalone(t *testing.T) {
svc, repo := newAuditAssertService(t)
repoMock := newMockProfileRepository()
svc.SetProfileRepo(repoMock)
svc.SetProfileID("prof-tight")
repoMock.AddProfile(&domain.CertificateProfile{
ID: "prof-tight",
Name: "tight",
AllowedKeyAlgorithms: []domain.KeyAlgorithmRule{{Algorithm: "RSA", MinSize: 4096}}, // ECDSA-P256 CSR fails
Enabled: true,
})
csrPEM := generateCSRPEM(t, "device.example.com", nil) // ECDSA-P256
if _, err := svc.SimpleEnroll(context.Background(), csrPEM); err == nil {
t.Fatal("expected policy violation error")
}
got := auditActions(repo)
if !stringSliceContains(got, AuditActionESTCSRPolicyViolation) {
t.Errorf("missing standalone policy-violation code %q; got %v", AuditActionESTCSRPolicyViolation, got)
}
if !stringSliceContains(got, AuditActionESTSimpleEnrollFailed) {
t.Errorf("missing typed failed code; got %v", got)
}
}
func TestESTAudit_AuditCodesAreUniqueStrings(t *testing.T) {
// Tiny invariant test: every audit-action constant is a non-empty
// distinct string. Prevents a future cut-paste typo where two
// constants share the same value.
codes := []string{
AuditActionESTSimpleEnrollSuccess,
AuditActionESTSimpleEnrollFailed,
AuditActionESTSimpleReEnrollSuccess,
AuditActionESTSimpleReEnrollFailed,
AuditActionESTServerKeygenSuccess,
AuditActionESTServerKeygenFailed,
AuditActionESTAuthFailedBasic,
AuditActionESTAuthFailedMTLS,
AuditActionESTAuthFailedChannelBinding,
AuditActionESTRateLimited,
AuditActionESTCSRPolicyViolation,
AuditActionESTBulkRevoke,
AuditActionESTTrustAnchorReloaded,
}
seen := map[string]bool{}
for _, c := range codes {
if c == "" {
t.Errorf("empty audit-action constant")
}
if !strings.HasPrefix(c, "est_") {
t.Errorf("audit-action constant %q must start with est_", c)
}
if seen[c] {
t.Errorf("duplicate audit-action constant: %q", c)
}
seen[c] = true
}
}
func stringSliceContains(haystack []string, needle string) bool {
for _, s := range haystack {
if s == needle {
return true
}
}
return false
}
// silenceUnusedDomain keeps the domain import live when the policy-
// violation test compiles even if a future refactor removes the only
// reference site.
var _ domain.CertificateProfile