# christiaangoossens/hass-oidc-auth

OpenID Connect authentication provider for Home Assistant

Repository: https://github.com/christiaangoossens/hass-oidc-auth
Canonical: https://ross.abutalabs.com/products/hass-oidc-auth
Language: Python
License: MIT
License Family: permissive
Topics: homeassistant, oidc, openid, hacs, integration, authelia, authentik, custom-integration, keycloak, oauth2, openid-connect, pocket-id, single-sign-on, sso, hacktoberfest
Last push: 2026-08-31T06:06:26+00:00

## Health v2 (maintenance only)
Score: 99/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 100, release rhythm 98, longevity 98
- inputs: {"age_days": 1374, "days_push": 2, "days_rel": 14, "gap_med": 5, "n_releases_24m": 18}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1049, forks 55 (observed 2026-09-01T02:14:00.352461+00:00)

## What it is
A Home Assistant custom integration that adds OpenID Connect (OIDC) single sign-on authentication. It acts as a standards-compliant relying party so Home Assistant can log in via providers like Keycloak, Authelia, Authentik, or Pocket ID.

## Use cases
- add oidc login to home assistant
- single sign-on for home assistant with keycloak
- use authelia to authenticate home assistant
- sso for my homelab apps including home assistant
- replace home assistant password login with openid connect
- set up sso with authentik for home assistant

## When to choose
- you run Home Assistant in a homelab with an existing OIDC provider and want unified SSO
- you need a security-focused, spec-compliant OIDC client for Home Assistant
- you want accessible, low-maintenance SSO that survives Home Assistant updates

## When to avoid
- you don't use Home Assistant
- you need an OIDC provider (IdP) rather than a client/relying party
- you need OAuth2 flows beyond the client/RP role

## Facets
- artifact type: plugin
- maturity: active
- function: auth, security, middleware
- domain: self-hosted, security, developer-tools
- platform: python, self-hosted
- tags: home-assistant, oidc, sso, oauth2, hacs, single-sign-on, keycloak, authelia, authentik, home-automation, web-server

## Member repositories
- christiaangoossens/hass-oidc-auth (main) score 99

## Provenance
- Observed fields: from GitHub, fetched 2026-09-01T02:14:00.352461+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:03:35.742750+00:00, confidence not recorded.
  - readme: https://github.com/christiaangoossens/hass-oidc-auth (fetched 2026-09-01T02:14:00.352461+00:00, sha 286e8c12556a)
- Data as of 2026-08-30T08:39:29.467469+00:00.