Skip to content

Commit 2eead67

Browse files
committed
doc: Add documentation for new deployment information configs
1 parent c2ed042 commit 2eead67

3 files changed

Lines changed: 24 additions & 0 deletions

File tree

doc/content/reference/branding/_index.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,3 +50,7 @@ $ convert console-favicon.png \
5050
console-favicon.ico
5151
```
5252
{{</ note >}}
53+
54+
## Deployment Information and Disclaimers
55+
56+
It is possible to highlight some deployment information and disclaimers in the header of the web UIs. E.g. you can highlight an SLA that applies or a support tier that is connected with the deployment. Please see the respective sections in the [Identity Server configuration reference]({{< ref "/reference/configuration/identity-server#oauth-ui-options" >}}) and [Console configuration reference]({{< ref "/reference/configuration/console#deployment-information-and-disclaimers" >}})

doc/content/reference/configuration/console.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -69,3 +69,14 @@ You can control the url of the assets folder that the Console frontend will use,
6969
- `console.ui.documentation-base-url`: The base URL for generating documentation links
7070
- `console.ui.theme-color`: The page theme color
7171
- `console.ui.title`: The page title
72+
- `console.ui.cluster-picker-url`: A URL to the a cluster picker to enable users to pick the correct cluster of the deployment
73+
74+
### Deployment Information and Disclaimers
75+
76+
It is possible to highlight some deployment information and disclaimers in the header of the Console:
77+
78+
- `console.ui.fair-use-policy-information-url`: A URL with information about the applicable fair use policy of the deployment
79+
- `console.ui.sla-applies`: The applicable Service Level Agreement of this deployment, e.g. `>99.9%`
80+
- `console.ui.sla-information-url`: A URL with information about the SLA applicable for this deployment
81+
- `console.ui.support-plan-applies`: The applicable support plan of this deployment, e.g. `priority`, `24h`
82+
- `console.ui.support-plan-information-url`: A URL with information about the support plan applicable for this deployment

doc/content/reference/configuration/identity-server.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -68,6 +68,7 @@ If page assets for the OAuth UI are served from a CDN or on a different path on
6868
- `is.oauth.ui.branding-base-url`: The base URL to the branding assets
6969
- `is.oauth.ui.branding-cluster-id`: The cluster ID to show below the logo {{< distributions "Cloud" "Enterprise" >}}
7070
- `is.oauth.ui.branding-text`: The branding text to show below the logo {{< distributions "Cloud" "Enterprise" >}}
71+
- `is.oauth.ui.cluster-picker-url`: A URL to the a cluster picker to enable users to pick the correct cluster of the deployment
7172

7273
The appearance of {{% tts %}} can optionally be customized.
7374

@@ -84,6 +85,14 @@ Further customization of the CSS files, JS files and icons is also possible:
8485
- `is.oauth.ui.js-file`: The names of the JS files
8586
- `is.oauth.ui.icon-prefix`: The prefix to put before the page icons (favicon.ico, touch-icon.png, og-image.png)
8687

88+
It is possible to highlight some deployment information and disclaimers in the header of the Account App:
89+
90+
- `is.oauth.ui.fair-use-policy-information-url`: A URL with information about the applicable fair use policy of the deployment
91+
- `is.oauth.ui.sla-applies`: The applicable Service Level Agreement of this deployment, e.g. `>99.9%`
92+
- `is.oauth.ui.sla-information-url`: A URL with information about the SLA applicable for this deployment
93+
- `is.oauth.ui.support-plan-applies`: The applicable support plan of this deployment, e.g. `priority`, `24h`
94+
- `is.oauth.ui.support-plan-information-url`: A URL with information about the support plan applicable for this deployment
95+
8796
## Profile Picture Storage Options
8897

8998
The profile pictures that users upload for their accounts are stored in a blob bucket. The global [blob configuration]({{< relref "the-things-stack.md#blob-options" >}}) is used for this. In addition to those options, specify the name of the bucket and the public URL to the bucket.

0 commit comments

Comments
 (0)