diff --git a/docs/enterprise/console-settings.yaml b/docs/enterprise/console-settings.yaml index 5e3471ccf..c2cefd003 100644 --- a/docs/enterprise/console-settings.yaml +++ b/docs/enterprise/console-settings.yaml @@ -147,14 +147,12 @@ settings: - name: "Certificates" - name: "Configure" settings: - - name: "User Impersonation" - doc: | - - name: "Settings" settings: - name: "Global" settings: - name: "Administrators" + doc: A list of users with full access to the Pomerium Enterprise Console - name: "Debug" - name: "Forward Auth" - name: "HTTP Redirect Address" @@ -167,11 +165,14 @@ settings: - name: "HTTPS Only" keys: ["cookie_secure"] - name: "Javascript Security" - keys: ["cookie_http_only"] - name: "Expires" keys: ["cookie_expire"] - name: "Timeouts" + doc: "Timeouts set the global server timeouts. Timeouts can also be set for individual routes." - name: "GRPC" + settings: + - name: "GRPC Server Max Connection Age" + - name: "GRPC Server Max Connection Age Grace" - name: "Tracing" - name: "Authenticate" - name: "Authorize" diff --git a/docs/enterprise/reference/configure.md b/docs/enterprise/reference/configure.md index 7ceceedcd..453d223ca 100644 --- a/docs/enterprise/reference/configure.md +++ b/docs/enterprise/reference/configure.md @@ -9,9 +9,6 @@ meta: # Configure -## User Impersonation - - ## Settings @@ -20,6 +17,7 @@ meta: #### Administrators +A list of users with full access to the Pomerium Enterprise Console #### Debug @@ -148,19 +146,47 @@ Proxy log level sets the logging level for the pomerium proxy service access log #### HTTPS Only +If true, instructs browsers to only send user session cookies over HTTPS. + +:::warning + +Setting this to false may result in session cookies being sent in cleartext. + +::: #### Javascript Security +If true, prevents javascript in browsers from reading user session cookies. + +:::warning + +Setting this to false enables hostile javascript to steal session cookies and impersonate users. + +::: #### Expires +Sets the lifetime of session cookies. After this interval, users must reauthenticate. ### Timeouts +Timeouts set the global server timeouts. Timeouts can also be set for individual routes. ### GRPC +#### GRPC Server Max Connection Age + +Set max connection age for GRPC servers. After this interval, servers ask clients to reconnect and perform any rediscovery for new/updated endpoints from DNS. + +See for details + +#### GRPC Server Max Connection Age Grace + +Additive period with `grpc_server_max_connection_age`, after which servers will force connections to close. + +See for details + ### Tracing Tracing tracks the progression of a single user request as it is handled by Pomerium. @@ -224,7 +250,7 @@ tracing_zipkin_endpoint | Url to the Zipkin HTTP endpoint. | ✅ ## Service Accounts - Service accounts... +See [Concepts: Service Accounts][service-accounts-concept]. ## Namespaces @@ -239,3 +265,4 @@ A [Namespace][namespace-concept] is a collection of users, groups, routes, and p [route-reference]: /enterprise/reference/manage.md#routes [namespace-concept]: /enterprise/concepts.md#namespaces [namespace-reference]: /enterprise/reference/configure.md#namespaces +[service-accounts-concept]: /enterprise/concepts.md#service-accounts diff --git a/docs/enterprise/reference/manage.md b/docs/enterprise/reference/manage.md index 3aa08e8aa..02bf294b7 100644 --- a/docs/enterprise/reference/manage.md +++ b/docs/enterprise/reference/manage.md @@ -364,3 +364,4 @@ certificates: [route-reference]: /enterprise/reference/manage.md#routes [namespace-concept]: /enterprise/concepts.md#namespaces [namespace-reference]: /enterprise/reference/configure.md#namespaces +[service-accounts-concept]: /enterprise/concepts.md#service-accounts diff --git a/docs/enterprise/reference/reports.md b/docs/enterprise/reference/reports.md index ba5df8dba..f0f1a5813 100644 --- a/docs/enterprise/reference/reports.md +++ b/docs/enterprise/reference/reports.md @@ -28,3 +28,4 @@ meta: [route-reference]: /enterprise/reference/manage.md#routes [namespace-concept]: /enterprise/concepts.md#namespaces [namespace-reference]: /enterprise/reference/configure.md#namespaces +[service-accounts-concept]: /enterprise/concepts.md#service-accounts