Mutual TLS (mTLS) Architecture
Carpenter enforces a strict Zero-Trust Ingress Standard. Underlying hosting networks, cloud VPC peerings, and physical data center boundaries are untrusted. Transport security is anchored in mutual TLS using client certificates issued by our central Certificate Authority (CA).
Trust Store Synchronization
Section titled “Trust Store Synchronization”A single internal CA signs all developer and machine credentials. The public trust bundle is propagated automatically across all operational environments:
1. AWS Multi-Region Propagation
Section titled “1. AWS Multi-Region Propagation”- The Root and Intermediate CA bundles are managed via AWS Certificate Manager (ACM) and replicated across active regions (
us-east-1,eu-west-1,ap-northeast-1). - Application Load Balancers (ALBs) consume the regional trust store to enforce mTLS at the VPC ingress boundary.
2. Bare-Metal Host Management
Section titled “2. Bare-Metal Host Management”- Dedicated hardware nodes pull the latest CA certificates via automated configuration agents.
- Ingress proxies (Caddy/Nginx) mount the CA bundle from read-only host storage (
/etc/ssl/certs/carpenter-ca.pem) to validate incoming client connections directly on bare metal.
Client Setup Instructions
Section titled “Client Setup Instructions”Workstation Browsers (macOS / Linux / Windows)
Section titled “Workstation Browsers (macOS / Linux / Windows)”- Import the provisioned
.p12bundle into your system keychain or browser certificate store. - The browser prompts for identity presentation when navigating to any target resolving under your assigned
<zone-domain>.
CLI & Development Containers
Section titled “CLI & Development Containers”# Inject client certificates into dev environmentsCOPY ./certs/carpenter-client.pem /etc/ssl/certs/carpenter-client.pemCOPY ./certs/carpenter-client.key /etc/ssl/private/carpenter-client.keyENV SSL_CERT_FILE=/etc/ssl/certs/carpenter-client.pem