@@ -48,6 +48,34 @@ The ACS deployment in the Layered Zero Trust pattern is implemented using:
4848 - Admission Controller (policy enforcement)
4949 - Collector (DaemonSet for runtime monitoring)
5050
51+ ## Route and TLS Configuration
52+
53+ ACS Central exposes two OpenShift routes with different TLS termination modes:
54+
55+ | Route | TLS Mode | Purpose |
56+ | ---| ---| ---|
57+ | ` central ` | Passthrough | Sensor/SecuredCluster gRPC communication (mTLS) |
58+ | ` central-reencrypt ` | Reencrypt | Browser UI access using cluster wildcard certificate |
59+
60+ The ** passthrough route is required** for sensor communication. Sensors use
61+ mutual TLS with certificates from the cluster init bundle, and the RHACS
62+ operator [ explicitly states] ( https://github.com/stackrox/stackrox/blob/master/operator/api/v1alpha1/central_types.go )
63+ that the reencrypt route * "should not be used for sensor communication"*
64+ because the router terminates the sensor's TLS session, breaking mTLS
65+ authentication.
66+
67+ The ** reencrypt route** is enabled by default (` central.exposure.route.reencrypt.enabled: true ` )
68+ so that browser users see the cluster's wildcard certificate instead of
69+ Central's self-signed certificate. This works on all platforms:
70+
71+ - ** Cloud (AWS, Azure, GCP)** : wildcard cert is signed by a public CA — no browser warning
72+ - ** BareMetal / vSphere** : wildcard cert uses the cluster ingress CA — trusted
73+ if ` ztvp-certificates ` has injected it via ` proxyCA `
74+
75+ The RHACS operator auto-generates the reencrypt route hostname
76+ (` central-reencrypt-stackrox.apps.<domain> ` ). The ConsoleLink and OIDC auth
77+ provider ` uiEndpoint ` automatically point to the reencrypt route when enabled.
78+
5179## Deployment Workflow
5280
5381### Phase 1: Operator Installation (Managed by Pattern Framework)
0 commit comments