From 0bc2d4a7b8f40319dc6315ffe19a679db0edd3b2 Mon Sep 17 00:00:00 2001 From: Sergii Bogomolov Date: Mon, 16 Dec 2024 08:54:14 -0600 Subject: [PATCH] website/integrations: Update Home Assistant integration docs (#12233) Update Home Assistant integration docs Extra care should be taken to proxy only /auth endpoint through Authentik. Signed-off-by: Sergii Bogomolov Co-authored-by: Tana M Berry --- website/integrations/services/home-assistant/index.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/website/integrations/services/home-assistant/index.md b/website/integrations/services/home-assistant/index.md index 2daffe0847..99eeb506d9 100644 --- a/website/integrations/services/home-assistant/index.md +++ b/website/integrations/services/home-assistant/index.md @@ -16,6 +16,9 @@ sidebar_label: Home Assistant :::caution You might run into CSRF errors, this is caused by a technology Home-assistant uses and not authentik, see [this GitHub issue](https://github.com/goauthentik/authentik/issues/884#issuecomment-851542477). ::: +:::caution +Only prefixes starting with `/auth` need to be proxied (excluding prefixes starting with `/auth/token`), see [this GitHub issue](https://github.com/BeryJu/hass-auth-header/issues/212). This can be configured in the reverse proxy (e.g. nginx, Traefik) or in authentik Provider's **Unauthorized Paths**. +::: :::note For Home Assistant to work with authentik, a custom integration needs to be installed for Home Assistant. :::