Files
certctl/internal/integration/negative_test.go
T
Shankar 1ef16984eb feat: M11a — certificate profiles, crypto policy enforcement, short-lived cert expiry
Add certificate profiles as named enrollment templates that control allowed
key algorithms, max TTL, permitted EKUs, required SAN patterns, and optional
SPIFFE URI SANs. CSR submissions are validated against profile rules at
signing time (key type + minimum size). Short-lived certs (TTL < 1 hour)
auto-expire via a new scheduler loop — expiry acts as revocation, no
CRL/OCSP needed.

New files:
- Migration 000003: certificate_profiles table, FK columns on
  managed_certificates/renewal_policies, key metadata on certificate_versions
- domain/profile.go: CertificateProfile + KeyAlgorithmRule structs
- repository/postgres/profile.go: full CRUD with JSONB marshaling
- service/profile.go: ProfileService with validation + audit logging
- service/crypto_validation.go: CSR-against-profile validation (RSA/ECDSA/Ed25519)
- handler/profiles.go: 5 HTTP endpoints under /api/v1/profiles
- web/src/pages/ProfilesPage.tsx: profiles management page

Modified:
- renewal.go: CSR validation in CompleteAgentCSRRenewal, ExpireShortLivedCertificates
- scheduler.go: 30s short-lived expiry check loop
- certificate.go (repo): nullable profile FK, key metadata on versions
- main.go: profile repo/service/handler wiring, 8-param NewRenewalService
- router.go: 12-param RegisterHandlers with profile routes
- seed_demo.sql: 4 demo profiles (standard, mtls, short-lived, high-security)
- Frontend: types, API client, routing, sidebar nav

Tests: 40 new tests across handler (15), service (13), crypto validation (12)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-20 20:39:49 -04:00

393 lines
12 KiB
Go

package integration
import (
"bytes"
"encoding/json"
"fmt"
"io"
"log/slog"
"net/http"
"net/http/httptest"
"testing"
"time"
"github.com/shankar0123/certctl/internal/api/handler"
"github.com/shankar0123/certctl/internal/api/router"
"github.com/shankar0123/certctl/internal/connector/issuer/local"
"github.com/shankar0123/certctl/internal/domain"
"github.com/shankar0123/certctl/internal/service"
)
// setupTestServer creates a fully-wired test server for negative path testing.
func setupTestServer(t *testing.T) (*httptest.Server, *mockCertificateRepository, *mockJobRepository, *mockAgentRepository) {
t.Helper()
certRepo := newMockCertificateRepository()
jobRepo := newMockJobRepository()
auditRepo := newMockAuditRepository()
agentRepo := newMockAgentRepository()
targetRepo := newMockTargetRepository()
notifRepo := newMockNotificationRepository()
policyRepo := newMockPolicyRepository()
renewalPolicyRepo := newMockRenewalPolicyRepository()
issuerRepo := newMockIssuerRepository()
logger := slog.New(slog.NewTextHandler(io.Discard, nil))
localCA := local.New(nil, logger)
issuerRegistry := map[string]service.IssuerConnector{
"iss-local": service.NewIssuerConnectorAdapter(localCA),
}
auditService := service.NewAuditService(auditRepo)
policyService := service.NewPolicyService(policyRepo, auditService)
certificateService := service.NewCertificateService(certRepo, policyService, auditService)
notificationService := service.NewNotificationService(notifRepo, make(map[string]service.Notifier))
renewalService := service.NewRenewalService(certRepo, jobRepo, renewalPolicyRepo, nil, auditService, notificationService, issuerRegistry, "server")
deploymentService := service.NewDeploymentService(jobRepo, targetRepo, agentRepo, certRepo, auditService, notificationService)
jobService := service.NewJobService(jobRepo, renewalService, deploymentService, logger)
agentService := service.NewAgentService(agentRepo, certRepo, jobRepo, targetRepo, auditService, issuerRegistry, renewalService)
issuerService := service.NewIssuerService(issuerRepo, auditService)
certificateHandler := handler.NewCertificateHandler(certificateService)
issuerHandler := handler.NewIssuerHandler(issuerService)
targetHandler := handler.NewTargetHandler(&mockTargetService{targetRepo: targetRepo, auditService: auditService})
agentHandler := handler.NewAgentHandler(agentService)
jobHandler := handler.NewJobHandler(jobService)
policyHandler := handler.NewPolicyHandler(policyService)
profileHandler := handler.NewProfileHandler(&mockProfileService{})
teamHandler := handler.NewTeamHandler(&mockTeamService{})
ownerHandler := handler.NewOwnerHandler(&mockOwnerService{})
auditHandler := handler.NewAuditHandler(auditService)
notificationHandler := handler.NewNotificationHandler(notificationService)
healthHandler := handler.NewHealthHandler("none")
r := router.New()
r.RegisterHandlers(
certificateHandler,
issuerHandler,
targetHandler,
agentHandler,
jobHandler,
policyHandler,
profileHandler,
teamHandler,
ownerHandler,
auditHandler,
notificationHandler,
healthHandler,
)
server := httptest.NewServer(r)
t.Cleanup(func() { server.Close() })
return server, certRepo, jobRepo, agentRepo
}
// TestNegativePaths exercises error paths and edge cases.
func TestNegativePaths(t *testing.T) {
server, _, _, _ := setupTestServer(t)
// ======================
// Nonexistent resource lookups
// ======================
t.Run("GetNonexistentCertificate", func(t *testing.T) {
resp, err := http.Get(server.URL + "/api/v1/certificates/mc-does-not-exist")
if err != nil {
t.Fatalf("request failed: %v", err)
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusNotFound {
t.Errorf("expected 404, got %d", resp.StatusCode)
}
})
t.Run("GetNonexistentAgent", func(t *testing.T) {
resp, err := http.Get(server.URL + "/api/v1/agents/agent-ghost")
if err != nil {
t.Fatalf("request failed: %v", err)
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusNotFound {
t.Errorf("expected 404, got %d", resp.StatusCode)
}
})
t.Run("GetNonexistentJob", func(t *testing.T) {
resp, err := http.Get(server.URL + "/api/v1/jobs/job-ghost")
if err != nil {
t.Fatalf("request failed: %v", err)
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusNotFound {
t.Errorf("expected 404, got %d", resp.StatusCode)
}
})
// ======================
// Invalid request bodies
// ======================
t.Run("CreateCertificateInvalidJSON", func(t *testing.T) {
resp, err := http.Post(server.URL+"/api/v1/certificates", "application/json", bytes.NewReader([]byte("not json")))
if err != nil {
t.Fatalf("request failed: %v", err)
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusBadRequest {
bodyBytes, _ := io.ReadAll(resp.Body)
t.Errorf("expected 400, got %d. Body: %s", resp.StatusCode, string(bodyBytes))
}
})
t.Run("CreateCertificateMissingCommonName", func(t *testing.T) {
body := map[string]interface{}{
"name": "Test Cert",
"environment": "test",
}
bodyBytes, _ := json.Marshal(body)
resp, err := http.Post(server.URL+"/api/v1/certificates", "application/json", bytes.NewReader(bodyBytes))
if err != nil {
t.Fatalf("request failed: %v", err)
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusBadRequest {
bodyBytes, _ := io.ReadAll(resp.Body)
t.Errorf("expected 400, got %d. Body: %s", resp.StatusCode, string(bodyBytes))
}
})
t.Run("CreatePolicyInvalidType", func(t *testing.T) {
body := map[string]interface{}{
"name": "Bad Policy",
"type": "NonexistentType",
}
bodyBytes, _ := json.Marshal(body)
resp, err := http.Post(server.URL+"/api/v1/policies", "application/json", bytes.NewReader(bodyBytes))
if err != nil {
t.Fatalf("request failed: %v", err)
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusBadRequest {
bodyBytes, _ := io.ReadAll(resp.Body)
t.Errorf("expected 400, got %d. Body: %s", resp.StatusCode, string(bodyBytes))
}
})
// ======================
// Invalid CSR submission
// ======================
t.Run("SubmitInvalidCSR", func(t *testing.T) {
// First register an agent
agentBody := map[string]interface{}{
"name": "test-agent",
"hostname": "test-host",
}
agentBytes, _ := json.Marshal(agentBody)
regResp, err := http.Post(server.URL+"/api/v1/agents", "application/json", bytes.NewReader(agentBytes))
if err != nil {
t.Fatalf("register agent failed: %v", err)
}
defer regResp.Body.Close()
if regResp.StatusCode != http.StatusCreated {
bodyBytes, _ := io.ReadAll(regResp.Body)
t.Fatalf("expected 201, got %d. Body: %s", regResp.StatusCode, string(bodyBytes))
}
var agentResp struct {
Agent domain.Agent `json:"agent"`
APIKey string `json:"api_key"`
}
if err := json.NewDecoder(regResp.Body).Decode(&agentResp); err != nil {
t.Fatalf("failed to decode agent response: %v", err)
}
// Submit garbage CSR
csrBody := map[string]interface{}{
"csr_pem": "not a valid CSR",
}
csrBytes, _ := json.Marshal(csrBody)
csrResp, err := http.Post(
fmt.Sprintf("%s/api/v1/agents/%s/csr", server.URL, agentResp.Agent.ID),
"application/json",
bytes.NewReader(csrBytes),
)
if err != nil {
t.Fatalf("CSR submission failed: %v", err)
}
defer csrResp.Body.Close()
// Should reject — either 400 (bad CSR format) or 500 (no cert to sign for)
if csrResp.StatusCode == http.StatusOK || csrResp.StatusCode == http.StatusCreated {
t.Errorf("expected error status for invalid CSR, got %d", csrResp.StatusCode)
}
})
// ======================
// Heartbeat for nonexistent agent
// ======================
t.Run("HeartbeatNonexistentAgent", func(t *testing.T) {
heartbeatBody := map[string]interface{}{
"status": "healthy",
}
bodyBytes, _ := json.Marshal(heartbeatBody)
resp, err := http.Post(
server.URL+"/api/v1/agents/agent-nonexistent/heartbeat",
"application/json",
bytes.NewReader(bodyBytes),
)
if err != nil {
t.Fatalf("request failed: %v", err)
}
defer resp.Body.Close()
// Should fail — agent doesn't exist
if resp.StatusCode == http.StatusOK {
t.Errorf("expected error status for nonexistent agent heartbeat, got 200")
}
})
// ======================
// Method not allowed
// ======================
t.Run("PutToListEndpoint", func(t *testing.T) {
req, _ := http.NewRequest(http.MethodPut, server.URL+"/api/v1/certificates", nil)
resp, err := http.DefaultClient.Do(req)
if err != nil {
t.Fatalf("request failed: %v", err)
}
defer resp.Body.Close()
if resp.StatusCode == http.StatusOK {
t.Errorf("expected error for PUT on list endpoint, got 200")
}
})
// ======================
// Empty list responses
// ======================
t.Run("ListEmptyCertificates", func(t *testing.T) {
resp, err := http.Get(server.URL + "/api/v1/certificates")
if err != nil {
t.Fatalf("request failed: %v", err)
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusOK {
t.Errorf("expected 200 for empty list, got %d", resp.StatusCode)
}
var result map[string]interface{}
if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
t.Fatalf("failed to decode: %v", err)
}
total, ok := result["total"].(float64)
if !ok || total != 0 {
t.Errorf("expected total 0, got %v", result["total"])
}
})
t.Run("ListEmptyJobs", func(t *testing.T) {
resp, err := http.Get(server.URL + "/api/v1/jobs")
if err != nil {
t.Fatalf("request failed: %v", err)
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusOK {
t.Errorf("expected 200 for empty list, got %d", resp.StatusCode)
}
})
// ======================
// Trigger renewal on nonexistent cert
// ======================
t.Run("TriggerRenewalNonexistentCert", func(t *testing.T) {
resp, err := http.Post(
server.URL+"/api/v1/certificates/mc-ghost/renew",
"application/json",
nil,
)
if err != nil {
t.Fatalf("request failed: %v", err)
}
defer resp.Body.Close()
if resp.StatusCode == http.StatusOK || resp.StatusCode == http.StatusCreated {
t.Errorf("expected error for renewal of nonexistent cert, got %d", resp.StatusCode)
}
})
}
// TestCertificateLifecycleWithExpiredCert verifies handling of an expired certificate.
func TestCertificateLifecycleWithExpiredCert(t *testing.T) {
server, certRepo, _, _ := setupTestServer(t)
// Create an already-expired certificate directly in the repo
expiredTime := time.Now().Add(-24 * time.Hour)
expiredCert := &domain.ManagedCertificate{
ID: "mc-expired-001",
Name: "Expired Cert",
CommonName: "expired.example.com",
Status: domain.CertificateStatusExpired,
Environment: "prod",
IssuerID: "iss-local",
RenewalPolicyID: "rp-default",
ExpiresAt: expiredTime,
CreatedAt: time.Now().Add(-90 * 24 * time.Hour),
UpdatedAt: time.Now(),
}
certRepo.certs[expiredCert.ID] = expiredCert
// Verify we can retrieve the expired cert
t.Run("GetExpiredCert", func(t *testing.T) {
resp, err := http.Get(server.URL + "/api/v1/certificates/mc-expired-001")
if err != nil {
t.Fatalf("request failed: %v", err)
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusOK {
t.Fatalf("expected 200, got %d", resp.StatusCode)
}
var cert domain.ManagedCertificate
if err := json.NewDecoder(resp.Body).Decode(&cert); err != nil {
t.Fatalf("failed to decode: %v", err)
}
if cert.Status != domain.CertificateStatusExpired {
t.Errorf("expected status Expired, got %s", cert.Status)
}
})
// Trigger renewal on expired cert — should succeed (creating a renewal job)
t.Run("TriggerRenewalOnExpiredCert", func(t *testing.T) {
resp, err := http.Post(
server.URL+"/api/v1/certificates/mc-expired-001/renew",
"application/json",
nil,
)
if err != nil {
t.Fatalf("request failed: %v", err)
}
defer resp.Body.Close()
// Renewal should be accepted (creates a job) or return an error
// if the service doesn't allow renewal on expired certs
t.Logf("Renewal trigger on expired cert returned status: %d", resp.StatusCode)
})
}