Skip to content

Agent Mesh

docs: document --sts-issuer-url and AGENTMESH_STS_ISSUER_URL

Tomas Tormo0d3e944029c2
diff --git a/site/content/docs/reference/control-plane.md b/site/content/docs/reference/control-plane.md
index d5759c0e..56432b61 100644
--- a/site/content/docs/reference/control-plane.md
+++ b/site/content/docs/reference/control-plane.md
@@ -25,6 +25,7 @@ agentmesh-control-plane admin unban --peer <id> lift a ban
| `--oidc-client-id` | first audience | OAuth client ID advertised on `/info`, for providers where it differs from the audience. |
| `--insecure-skip-tls-verify` | `false` | Skip TLS verification when fetching issuer metadata and keys. For a cluster issuer served with the cluster CA, or a local development issuer. |
| `--bind-address` | `0.0.0.0:8080` | HTTP listen address. |
+| `--sts-issuer-url` | from the request | Public URL of this control plane. It is the `issuer` of `/.well-known/openid-configuration` and the `iss` claim of the JWTs that `POST /sts/token` mints. Can also be set with `AGENTMESH_STS_ISSUER_URL`. Without it, the control plane takes the scheme and host of each request and never reads `X-Forwarded-*` headers, so set it behind a TLS-terminating proxy. |
| `--pprof-addr` | off | Serve Go runtime profiles under `/debug/pprof/` on this address. Unauthenticated, and a heap profile is a dump of process memory, which holds the signing keys and the admin token: bind it to loopback, never to the API address. |
| `--db-driver` | `sqlite` | `sqlite` or `postgres`. |
| `--db-dsn` | `control-plane.db` | Database DSN. A PostgreSQL DSN contains a password, so the next two options are preferred for PostgreSQL. |