Authelia与Home Assistant的OpenID Connect集成指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01150/article/details/148361941

Authelia与Home Assistant的OpenID Connect集成指南

authelia The Single Sign-On Multi-Factor portal for web apps 项目地址: https://gitcode.com/gh_mirrors/au/authelia

概述

本文将详细介绍如何将Authelia作为OpenID Connect 1.0身份提供者(IdP)与Home Assistant智能家居平台进行集成。通过这种集成方式，用户可以使用Authelia的统一身份认证系统来保护Home Assistant的访问权限，实现单点登录(SSO)体验。

环境要求

版本兼容性

Authelia版本：v4.39.4及以上
Home Assistant核心版本：v2025.4.2及以上
OIDC认证插件：hass-oidc-auth v0.6.2-alpha及以上

基础概念

在开始配置前，我们需要了解几个关键概念：

OpenID Connect(OIDC)：建立在OAuth 2.0协议之上的身份认证层，允许客户端验证用户身份并获取基本用户信息。
身份提供者(IdP)：Authelia在此场景中扮演的角色，负责用户认证和授权。
依赖方(RP)：Home Assistant在此场景中扮演的角色，依赖Authelia进行用户认证。

配置步骤

Authelia端配置

在Authelia的配置文件中添加以下客户端配置：

identity_providers:
  oidc:
    clients:
      - client_id: 'home-assistant'
        client_name: 'Home Assistant'
        client_secret: '$pbkdf2-sha512$310000$c8p78n7pUMln0jzvd4aK4Q$JNRBzwAo0ek5qKn50cFzzvE9RXV88h1wJn5KGiHrD0YKtZaR/nCb2CJPOsKaPK0hjf.9yHxzQGZziziccp6Yng'
        public: false
        require_pkce: true
        pkce_challenge_method: 'S256'
        authorization_policy: 'two_factor'
        redirect_uris:
          - 'https://home-assistant.example.com/auth/oidc/callback'
        scopes:
          - 'openid'
          - 'profile'
          - 'groups'
        userinfo_signed_response_alg: 'none'
        token_endpoint_auth_method: 'client_secret_post'

配置说明：

client_id：客户端唯一标识符，需与Home Assistant配置一致
client_secret：客户端密钥，这里使用了PBKDF2加密后的值
authorization_policy：设置为two_factor要求双因素认证
redirect_uris：认证成功后重定向的URI
scopes：定义了请求的用户信息范围

Home Assistant端配置

在Home Assistant的configuration.yaml文件中添加以下配置：

auth_oidc:
  client_id: 'home-assistant'
  client_secret: 'insecure_secret'
  discovery_url: 'https://auth.example.com/.well-known/openid-configuration'
  display_name: 'Authelia'
  roles:
    admin: 'admins'

配置说明：