- Konfigurieren eines OpenID-Providers in Authentik zur Generierung von Client-Anmeldeinformationen.
- Verknüpfung der Anwendung in Immich mithilfe der Aussteller-URL und der Authentifizierungsschlüssel.
- Anpassung spezifischer Redirect-URIs, um die korrekte Funktion der mobilen Anwendung sicherzustellen.
- Implementierung von Auto-Registrierung und Auto-Start zur Automatisierung des Benutzerzugriffs.

Wie verbinde ich Authentik mit Immich? Wenn Sie Ihren eigenen Fotoserver zu Hause einrichten, wissen Sie das wahrscheinlich schon. Immich ist ein wahrer Schatz.Die Verwaltung einzelner Benutzer kann jedoch mühsam sein. Um zu vermeiden, dass man das Passwort tausendfach eintippen oder manuell Konten für die ganze Familie anlegen muss, ist es am sinnvollsten, ein System einzurichten, Single Sign-On (SSO)Und genau hier kommt Authentik ins Spiel.
Die Idee ist einfach: Authentik fungiert als Gatekeeper Ihres Servers und überprüft Ihre Identität, damit Sie anschließend … Keine Komplikationen bei der Einreise nach ImmichAuch wenn die Konfiguration von OIDC (OpenID Connect) zunächst nach einer Welt voller technischer Komplikationen aussehen mag, ist sie kinderleicht, sobald man verstanden hat, wie die beiden Anwendungen miteinander kommunizieren, und die Bereitstellung wird zum Kinderspiel. professionelle Verarbeitung und viel sicherer.
Die Vorbereitungen für Authentik laufen.
Bevor wir in Immich irgendetwas ändern, müssen wir Authentik mitteilen, dass es eine Foto-App gibt, die die Benutzer verwenden dürfen. Dazu müssen wir zunächst die Administrationsoberfläche aufrufen und eine entsprechende Registrierung vornehmen. OpenID-TypanbieterWenn Sie diesen Anbieter konfigurieren, werden Sie sehen, dass das System automatisch eine generiert. Client-ID und Client-GeheimnisNotieren Sie diese Daten in einem Notizblock, denn dies sind die Hauptschlüssel, die wir später in die Immich-Konfiguration einfügen werden.
Ein wichtiges Detail ist der Autorisierungsablauf: Wenn Sie nicht möchten, dass Ihre Benutzer bei jeder Anmeldung Berechtigungen erteilen müssen, können Sie die entsprechende Option auswählen. impliziter Fluss Um den Vorgang zu beschleunigen: Bezüglich der Redirect-URIs: Übertreiben Sie es nicht und verwenden Sie exakt die in der Immich-Dokumentation angegebenen. Schon ein einziges falsches Zeichen führt zu einer Fehlermeldung und verhindert die Anmeldung. Beachten Sie bei älteren Authentik-Versionen (vor 2026.5), dass… Alle URIs werden als Autorisierungstyp behandeltVermeiden Sie unnötige Komplikationen durch die Konfiguration von Logout-URIs.
Sobald Sie den Lieferanten gefunden haben, besteht der nächste Schritt darin, das Die Anwendung selbst Im Authentik-Panel müssen Sie lediglich einen Namen vergeben (z. B. „Meine Fotos“ oder „Immich“) und ihn mit dem soeben erstellten Anbieter verknüpfen. Gehen Sie anschließend zurück zu den Anbieterdetails und kopieren Sie die Aussteller-URL (OpenID-Konfigurationsaussteller), das ist die Adresse, die Immich verwenden wird, um herauszufinden, wie er sich authentifizieren kann.
Detaillierte Konfiguration in Immich

Nun kommen wir zur Immich-Website. Sie müssen zum Abschnitt über Administration, dann Einstellungen Suchen Sie den Abschnitt „OAuth-Authentifizierung“. Aktivieren Sie das Kontrollkästchen, und es erscheint ein Formular, das zwar kompliziert aussieht, aber eigentlich ganz einfach zu bedienen ist. Hier fügen Sie die Daten ein. Aussteller-URL, Client-ID und Client-Geheimnis die Sie zuvor gespeichert haben.
Für ein reibungsloses Erlebnis empfehle ich die Aktivierung der Automatische Registrierungwodurch beim ersten Login des Benutzers über Authentik automatisch dessen Immich-Konto erstellt wird, und die Automatischer StartDadurch wird der Benutzer direkt zum Authentik-Login weitergeleitet, ohne den Immich-Startbildschirm zu durchlaufen. Hinweis: Wenn Sie den automatischen Start aktivieren, Du könntest außen vor bleiben Melden Sie sich von Ihrem lokalen Administratorkonto an. Um sich mit dem ursprünglichen Administratorkonto anzumelden, müssen Sie die spezielle URL verwenden, indem Sie Folgendes hinzufügen: ?autoLaunch=0 am Ende der Anmeldeadresse.
Das Rätsel der URIs und des mobilen Zugriffs

Hier unterlaufen vielen Nutzern Fehler. Immich benötigt mehrere Redirect-URIs, je nachdem, von wo aus Sie darauf zugreifen. Für das Web müssen Sie Folgendes hinzufügen: /auth/login und /user-settings zusammen mit Ihrer Domain. Am wichtigsten ist jedoch die mobile App: Sie müssen die URI angeben. app.immich:///oauth-callbackWenn Ihr Authentifizierungsserver dieses benutzerdefinierte Schema nicht akzeptiert, besteht die Lösung darin, einen HTTP-Endpunkt zu konfigurieren, der als Brücke fungiert und den Datenverkehr an diese Adresse umleitet, wobei diese Adresse später in der Konfiguration angegeben wird. Option zum Überschreiben der URI für mobile Umleitungen von Immich.
Sollten Sie auf einen 500-Fehler oder Netzwerkprobleme stoßen, insbesondere in Docker- oder Unraid-Umgebungen, liegt das Problem möglicherweise darin, dass die Container sich nicht über ihre öffentlichen Domainnamen erreichen können. Einige Benutzer haben dieses Problem folgendermaßen gelöst: Lokale IPs statt Domänen oder indem das Host-Netzwerk so angepasst wird, dass der Datenverkehr zwischen dem Reverse-Proxy und den Authentifizierungsdiensten korrekt fließt.
Benutzer- und Berechtigungsverwaltung

Um zu testen, ob alles funktioniert, verwenden Sie nicht das Authentik-Administratorkonto. Gehen Sie zum Benutzerverzeichnis, Neuen Benutzer erstellen Melden Sie sich mit Ihrem eigenen Passwort bei Immich an. Wenn alles klappt, werden Sie zu Authentik weitergeleitet. Geben Sie dort Ihre Daten ein, und schon befinden Sie sich in Ihrer Fotogalerie. Sie können natürlich auch mit den Einstellungen experimentieren. Lageransprüche in der Immich-Konfiguration, um jedem Benutzer spezifische Festplattenkontingente basierend auf den Informationen zuzuweisen, die Authentik im Token sendet.
Durch die Integration dieser beiden Tools können Sie die Sicherheit zentralisieren und Passwortmüdigkeit vermeiden, indem Sie die Identitätsprüfung an ein robustes System delegieren. Durch die korrekte Konfiguration von OIDC-Flows und Umleitungsrouten, sowohl im Web als auch in der mobilen Anwendung, schaffen Sie ein Ökosystem, in dem der Zugriff für den Endbenutzer transparent, aber vom Administrator streng kontrolliert ist und somit das Identitätsmanagement in Ihrer persönlichen Testumgebung optimiert wird.
Index