破解Home Assistant身份验证难题：hass-oidc-auth让SSO登录变得简单

【免费下载链接】hass-oidc-authOpenID Connect authentication provider for Home Assistant项目地址: https://gitcode.com/gh_mirrors/ha/hass-oidc-auth

hass-oidc-auth是一款专为Home Assistant设计的OpenID Connect (OIDC)身份验证集成，通过简单配置即可实现安全稳定的单点登录(SSO)功能，让家庭自动化系统的访问管理更加便捷。无论是智能家居爱好者还是家庭用户，都能轻松搭建企业级的身份验证体系，保护你的智能家庭隐私与安全。

为什么选择hass-oidc-auth？三大核心优势

🔒 银行级安全标准

严格遵循OpenID Connect规范、OAuth2协议及RFC安全标准，默认启用PKCE防护机制，确保登录过程防篡改、防重放攻击。无需担心凭证泄露风险，让你的智能家居系统固若金汤。

🛠️ 零代码快速部署

提供两种配置方式满足不同用户需求：

• UI配置：适合新手用户的图形化界面，3步完成设置
• YAML配置：高级用户可通过配置文件实现更多自定义功能

🏠 全家适用的访问体验

无论家庭成员使用什么设备，都能通过统一的身份验证系统安全访问Home Assistant，支持自动用户链接和角色分配，让技术小白也能轻松上手。

5分钟完成安装：从下载到使用的完整指南

1️⃣ 安装准备

确保你的Home Assistant已安装HACS（Home Assistant Community Store），这是获取社区集成的最佳途径。如果尚未安装HACS，请先按照官方指南完成设置。

2️⃣ 获取集成

在HACS中搜索"OpenID Connect"并安装，或直接通过HACS仓库链接添加：

git clone https://gitcode.com/gh_mirrors/ha/hass-oidc-auth

3️⃣ 配置OIDC提供程序

根据你的身份提供商选择对应的配置指南：

• Authentik
• Authelia
• Keycloak
• Microsoft Entra

大多数提供商只需两个核心参数：client_id和discovery_url，无需复杂设置即可开始使用。

4️⃣ 图形化配置流程

通过Home Assistant UI完成设置的步骤如下：

1. 进入设置 > 设备与服务
2. 点击添加集成并搜索"OpenID Connect/SSO Authentication"
3. 按照向导输入必要信息并完成配置

图：通过Home Assistant界面配置OIDC认证的完整流程

5️⃣ 验证与使用

配置完成后，访问Home Assistant将自动重定向到你的OIDC登录页面。首次登录会创建对应的用户账户，后续访问则直接通过SSO验证，无需重复输入密码。

高级功能：打造个性化身份验证系统

🔧 自定义登录界面

通过YAML配置修改登录按钮显示名称：

auth_oidc: client_id: "你的客户端ID" discovery_url: "https://你的OIDC提供商/.well-known/openid-configuration" display_name: "家庭智能登录"

设置后登录按钮将显示为"Login with 家庭智能登录"，让界面更具个性化。

⚡ 跳过欢迎界面

启用默认重定向功能，直接进入OIDC登录流程：

auth_oidc: features: default_redirect: true

如需使用备用登录方式，可访问https://你的HA地址/?skip_oidc_redirect=true

🔄 用户角色管理

通过组配置控制用户权限：

auth_oidc: roles: admin: "ha_admins" # 拥有管理员权限的组 user: "ha_users" # 拥有普通用户权限的组

只有属于指定组的用户才能登录，增强系统访问控制。

🔄 重新配置与管理

如需修改现有配置，可在集成管理界面轻松调整：

图：在Home Assistant中管理和重新配置OIDC集成

常见问题解答

Q: 忘记管理员密码怎么办？

A: 可通过访问https://你的HA地址/?skip_oidc_redirect=true使用本地账号登录，或在紧急情况下删除auth_oidc配置段落暂时禁用集成。

Q: 支持双因素认证吗？

A: 完全支持！所有双因素认证配置在OIDC提供商中完成，hass-oidc-auth会自动继承这些安全设置。

Q: 能否与其他认证方式共存？

A: 可以！默认情况下，Home Assistant原生认证方式仍可使用，作为OIDC认证的备份选项。

开始使用hass-oidc-auth，提升你的智能家居安全等级

无论你是智能家居新手还是资深玩家，hass-oidc-auth都能为你的Home Assistant提供企业级的身份验证保护。通过简单几步配置，即可实现安全、便捷的单点登录体验，让家人放心使用，让你高枕无忧。

现在就通过HACS搜索"OpenID Connect"开始安装，或查看完整的配置文档了解更多高级功能！

【免费下载链接】hass-oidc-authOpenID Connect authentication provider for Home Assistant项目地址: https://gitcode.com/gh_mirrors/ha/hass-oidc-auth