OpenID / OAuth2 authentication für Home Assistant (Marketplace-Integration)

Installationen: 543 teilen Analysedaten
GitHub-Sterne: 214
Verbindung: Nutzt die Cloud des Herstellers
Pflege: In den letzten 6 Monaten aktualisiert
Version: 1.4.0, 10. Oktober 2026
Art: Marketplace-Integration
Voraussetzung: Braucht den Marketplace (HACS bis Home Assistant 2026.10)
Domain: openid
Quelle: github.com/cavefire/hass-openid
Probleme: Problem melden

Unabhängiges Verzeichnis, erstellt vom Entwickler von Vulpo. Steht in keiner Verbindung zu Home Assistant oder der Open Home Foundation.

Überblick

Die OpenID / OAuth2 Authentifizierung lässt Home Assistant Benutzer über einen OpenID Connect Identity Provider anmelden. Sie nutzt den Authorization Code Flow und fügt sich in das integrierte Home Assistant Anmeldesystem ein, wobei auf der Anmeldeseite eine Provider-Schaltfläche mit konfigurierbarem Text hinzugefügt wird. Die Endpunkte des Providers können aus einer Discovery-URL stammen oder von Hand eingegeben werden, mit optionalem PKCE und der Wahl, ob das TLS-Zertifikat des Providers geprüft wird. Die Identitätszuordnung umfasst den angeforderten Scope und welcher Claim zum Home Assistant Benutzernamen wird, etwa preferred username oder E-Mail. Mit den erweiterten Optionen lassen sich Home Assistant Benutzer bei der ersten Anmeldung automatisch anlegen, andere Anmeldemethoden außer aus vertrauenswürdigen IPv4- oder IPv6-Bereichen sperren und zusätzliche Autorisierungsparameter senden. Sie wird über die Home Assistant Oberfläche eingerichtet und hängt von der Cloud des Herstellers ab.

Zusammenfassung der README und des Codes von cavefire/hass-openid, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich

Unterstützt

Nutzt die Cloud des Herstellers Braucht eine Internetverbindung und einen Account beim Hersteller.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.

Einrichtung

Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.

Anmelden

Client-IDOAuth2/OpenID-Client-ID fur Home Assistant
Client-SecretOAuth2/OpenID-Client-Secret fur Home Assistant

Schritt 2

Andere Anmeldemethoden blockierenErlaube nur die OpenID-Anmeldung, es sei denn, die Client-IP entspricht einem der vertrauenswurdigen IPv4- oder IPv6-CIDR-Blöcke unten
Home-Assistant-Benutzer automatisch erstellenErstellt automatisch einen Home-Assistant-Benutzer, wenn sich jemand zum ersten Mal anmeldet
Benutzerdefinierte Fehler-Weiterleitungs-URLOptionale URL, zu der statt der integrierten OpenID-Fehlerseite umgeleitet wird
Text der AnmeldeschaltflacheText, der auf der Home-Assistant-Anmeldeseite angezeigt wird
Vertrauenswurdige IPv4-/IPv6-CIDR-BlöckeGib pro Zeile einen IPv4- oder IPv6-CIDR-Block ein
HTTP-Basic-Authentifizierung fur den Token-Request verwendenSende Client-ID und Secret im Authorization-Header beim Austausch des Codes gegen Tokens
Zusätzliche AutorisierungsparameterOptionale zusätzliche Parameter für die Autorisierungsanfrage beim Anbieter, ein key=value pro Zeile (zum Beispiel hd=example.com)

Schritt 3

Configure-URLDiscovery-Endpunkt, ublicherweise die OpenID-Konfigurations-URL des Providers
TLS-Zertifikat prüfenPrüfe das TLS-Zertifikat des Providers beim Abrufen des Discovery-Dokuments

Schritt 4

Angeforderter ScopeOAuth2/OpenID-Scope, der beim Provider angefordert wird
Benutzername-FeldClaim, der als Home-Assistant-Benutzername verwendet wird, zum Beispiel preferred_username oder email

Schritt 5

Autorisierungs-EndpunktAutorisierungs-Endpunkt
Logout-EndpunktOptionaler Logout-Endpunkt
Token-EndpunktToken-Endpunkt
PKCE verwendenOb der Autorisierungsfluss PKCE verwenden soll
User-Info-EndpunktUser-Info-Endpunkt
TLS-Zertifikat prüfenPrüfe das TLS-Zertifikat des Providers für Discovery-, Token- und User-Info-Anfragen

Texte aus dem Code von cavefire/hass-openid.

Aus der README

This integration allows Home Assistant to authenticate users via an OpenID Connect (OIDC) provider. It supports the authorization code flow and integrates seamlessly with Home Assistant's authentication system.

Aus der README von cavefire/hass-openid, GNU GPL v3.0. Gekürzt.