This document describes controls visible in the current repository and checks that still require deployment-specific verification. It is not a security certification.
- Tenant API keys are generated with cryptographic randomness and stored as SHA-256 hashes; plaintext keys are returned only when created or rotated.
- Constant-time comparison is used by the in-memory authentication path.
- Event tenant identity is derived from the authenticated credential, not a client-provided event field.
- Event JSON uses strict decoding, validation, payload limits, and timestamp checks.
- PostgreSQL statements use parameters and enforce unique tenant/event IDs.
- Redis rate limiting uses an atomic Lua script and a per-tenant key.
- Webhook requests use HMAC-SHA256 signatures and timestamp/event headers.
- Webhook URLs are restricted to HTTP(S), reject user info and known/private address classes, and use a safe dialer that rechecks resolved addresses. The isolated Compose E2E profile opts into private endpoints only for its local mock; this setting must remain disabled in production.
- HTTP server timeouts and webhook client timeout bound request duration.
- Helm defaults request non-root execution, drop Linux capabilities, disable privilege escalation, and use a read-only root filesystem.
- Terminate TLS for client, Kafka, database, Redis, ClickHouse, and webhook traffic where the deployment requires it; Compose uses local plaintext and is not a production security profile.
- Replace all
change-me-*values with an external secret mechanism. Never commit.envfiles, admin tokens, API keys, webhook secrets, or credentials. - Restrict the admin token path to an operator-controlled network and rotate it under an access-controlled process.
- Apply least-privilege database, Kafka, Redis, ClickHouse, Kubernetes, and observability permissions.
- Configure network policies and egress controls in Kubernetes; SSRF checks do not replace network-layer egress restrictions.
- Define API-key rotation/revocation operations and audit logging for the production control plane.
- Validate container image provenance, dependency advisories, TLS settings, and non-root behavior with the target runtime.
- Confirm sensitive fields are absent from logs, traces, metric labels, and error responses.
| Check | Command/evidence | Status |
|---|---|---|
| Go tests and race detector | make test, make race |
PASS |
| Static analysis | make lint, make vet |
PASS |
| Dependency vulnerabilities | govulncheck ./... |
PASS |
| Compose and Helm validation | make validate |
PASS |
| API key hash and rotation | unit/integration output | PASS |
| SSRF and HMAC tests | unit/E2E output | PASS |
| Secret scan and image scan | Trivy image HIGH/CRITICAL | PASS |
| TLS, network policy, RBAC | target deployment evidence | Required before production |