diff --git a/website/integrations/services/freshrss/index.md b/website/integrations/services/freshrss/index.md index 94c568363..7514fd758 100644 --- a/website/integrations/services/freshrss/index.md +++ b/website/integrations/services/freshrss/index.md @@ -27,14 +27,15 @@ The following placeholders will be used: - **Client Type**: Confidential - **Client ID**: Either create your own Client ID or use the auto-populated ID - **Client Secret**: Either create your own Client Secret or use the auto-populated secret -:::note -Take note of the `Client ID` and `Client Secret`, you'll need them later. -::: + :::note + Take note of the `Client ID` and `Client Secret`, you'll need them later. + ::: - **Redirect URIs/Origins**: - - `https://freshrss.company/i/oidc/` - - `https://freshrss.company:port/i/oidc` + - `https://freshrss.company/i/oidc/` + - `https://freshrss.company:port/i/oidc` - **Signing Key**: Any of your signing keys - Leave everything else as default + 2. Create an **Application** under **Applications** > **Applications** using the following settings: - **Name**: FreshRSS - **Slug**: freshrss diff --git a/website/integrations/services/home-assistant/index.md b/website/integrations/services/home-assistant/index.md index 007b38d9b..fde3f0106 100644 --- a/website/integrations/services/home-assistant/index.md +++ b/website/integrations/services/home-assistant/index.md @@ -1,4 +1,3 @@ - --- title: Home Assistant --- @@ -28,39 +27,32 @@ The following placeholders will be used: ## Home Assistant configuration 1. Configure [trusted_proxies](https://www.home-assistant.io/integrations/http/#trusted_proxies) for the HTTP integration with the IP(s) of the Host(s) authentik is running on. -2. If you don't already have it set up, install https://github.com/BeryJu/hass-auth-header, using the installation guide. +2. If you don't already have it set up, https://github.com/BeryJu/hass-auth-header, using the installation guide. 3. There are two ways to configure the custom component. - 1. To match on the user's authentik username, use the following configuration: - - ```yaml - auth_header: - username_header: X-authentik-username - ``` - + ```yaml + auth_header: + username_header: X-authentik-username + ``` 2. Alternatively, you can associate an existing Home Assistant username to an authentik username. 1. Within authentik, naviagte to **Directory** > **Users**. 2. Select **Edit** for the user then add the following configuration to the **Attributes** section. Be sure to replace `hassusername` with the Home Assistant username. - - :::note - This configuration will add an additional header for the authentik user which will contain the Home Assistant username and allow Home Assistant to authenticate based on that. - ::: - - ```yaml - additionalHeaders: - X-ak-hass-user: hassusername - ``` - + :::note + This configuration will add an additional header for the authentik user which will contain the Home Assistant username and allow Home Assistant to authenticate based on that. + ::: + ```yaml + additionalHeaders: + X-ak-hass-user: hassusername + ``` 3. Then configure the Home Assistant custom component to use this header: - ```yaml - auth_header: - username_header: X-ak-hass-user - ``` + ```yaml + auth_header: + username_header: X-ak-hass-user + ``` ## authentik configuration 1. Create a **Proxy Provider** under **Applications** > **Providers** using the following settings: - - **Name**: Home Assistant - **Authentication flow**: default-authentication-flow - **Authorization flow**: default-provider-authorization-explicit-consent