Skip to content

Commit 479f2f7

Browse files
committed
Adding explanation how ACS handles two OCP routes
1 parent bd1089a commit 479f2f7

1 file changed

Lines changed: 28 additions & 0 deletions

File tree

docs/acs-deployment.md

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -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

Comments
 (0)