From 1c9d4cc42bd7c627c24c359f5249653ba797a55e Mon Sep 17 00:00:00 2001 From: Kenneth Bingham Date: Sun, 16 Apr 2023 16:34:42 -0400 Subject: [PATCH] hint at the expected source and format of the zrok admin tokens --- docs/guides/metrics-and-limits/configuring-metrics.md | 2 +- docs/guides/self-hosting/self_hosting_guide.md | 4 +++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/guides/metrics-and-limits/configuring-metrics.md b/docs/guides/metrics-and-limits/configuring-metrics.md index 1945647b..eb9e970a 100644 --- a/docs/guides/metrics-and-limits/configuring-metrics.md +++ b/docs/guides/metrics-and-limits/configuring-metrics.md @@ -12,7 +12,7 @@ Environments that horizontally scale the `zrok` control plane with multiple cont ## Configuring the OpenZiti Controller -> This requires a version of OpenZiti with a `fabric` dependency of `v0.22.52` or newer. +> This requires a version of OpenZiti with a `fabric` dependency of `v0.22.52` or newer, which is satisfed by the `v0.27.6` release of OpenZiti Controller. Emitting `fabric.usage` events to a file is currently the most reliable mechanism to capture usage events into `zrok`. We're going to configure the OpenZiti controller to append `fabric.usage` events to a file, by adding this stanza to the OpenZiti controller configuration: diff --git a/docs/guides/self-hosting/self_hosting_guide.md b/docs/guides/self-hosting/self_hosting_guide.md index 84dec517..940ba3d5 100644 --- a/docs/guides/self-hosting/self_hosting_guide.md +++ b/docs/guides/self-hosting/self_hosting_guide.md @@ -50,8 +50,10 @@ Create a controller configuration file in `etc/ctrl.yml`. The controller does no v: 3 admin: + # generate these admin tokens from a source of randomness, e.g. + # LC_ALL=C tr -dc _A-Z-a-z-0-9 < /dev/urandom | head -c32 secrets: - - f60b55fa-4dec-4c4a-9244-e3b7d6b9bb13 + - Q8V0LqnNb5wNX9kE1fgQ0H6VlcvJybB1 endpoint: host: 0.0.0.0