π A self-hostable personal dashboard built for you. Includes status-checking, widgets, themes, icon packs, a UI editor and tons more!
Vue awesomedashboarddockerhomelabhomepagemitnodejsorganizationproductivitypwaself-hostedstartpagevue
:memo: additional keycloak roles/groups documentation
Leonardo Covarrubias4a841b90e7d9
diff --git a/docs/authentication.md b/docs/authentication.mdindex e5de308c..b429adea 100644--- a/docs/authentication.md+++ b/docs/authentication.md@@ -143,9 +143,25 @@ appConfig:realm: 'alicia-homelab'clientId: 'dashy'```++### 4. Add groups and roles (Optional)+Keycloak allows you to assign users roles and groups. You can use these values to configure who can access various sections in Dashy.+Keycloak server administration and configuration is a deep topic; please refer to the [server admin guide](https://www.keycloak.org/docs/latest/server_admin/index.html#assigning-permissions-and-access-using-roles-and-groups) to see details about creating and assigning roles and groups.+Once you have groups or roles assigned to users you can configure access under each sections `displayData.showForKeycloakUser` and `displayData.hideForKeycloakUser`.+Both show and hide configurations accept a list of `groups` and `roles` that limit access. If a users data matches one or more items in these lists they will be allowed or excluded as defined.+```yaml+sections:+ - name: DeveloperResources+ displayData:+ showForKeycloakUsers:+ roles: ['canViewDevResources']+ hideForKeycloakUsers:+ groups: ['ProductTeam']+```+Your app is now secured :) When you load Dashy, it will redirect to your Keycloak login page, and any user without valid credentials will be prevented from accessing your dashboard.-From within the Keycloak console, you can then configure things like user permissions, time outs, password policies, access, etc. You can also backup your full Keycloak config, and it is recommended to do this, along with your Dashy config. You can spin up both Dashy and Keycloak simultaneously and restore both applications configs using a `docker-compose.yml` file, and this is recommended.+From within the Keycloak console, you can then configure things like time-outs, password policies, etc. You can also backup your full Keycloak config, and it is recommended to do this, along with your Dashy config. You can spin up both Dashy and Keycloak simultaneously and restore both applications configs using a `docker-compose.yml` file, and this is recommended.---diff --git a/docs/developing.md b/docs/developing.mdindex 6f8ac2b0..22672f1f 100644--- a/docs/developing.md+++ b/docs/developing.md@@ -285,6 +285,7 @@ Styleguides:β βββ InitServiceWorker.js # Initializes and manages service worker, if enabledβ βββ Search.js # Helper functions for searching/ filtering items in all viewsβ βββ JsonToYaml.js # Function that parses and converts raw JSON into valid YAML+β βββ KeycloakAuth.js # Singleton class to manage Keycloak authenticationβ βββ languages.js # Handles fetching, switching and validating languagesβ β°ββ ThemeHelper.js # Function that handles the fetching and setting of user themesβ°ββ views # Directory of available pages, corresponding to available routes