- Authentik'te istemci kimlik bilgilerini oluşturmak için bir OpenID Sağlayıcısı yapılandırma.
- Uygulamayı, Issuer URL'si ve kimlik doğrulama sırları kullanarak Immich'e bağlama.
- Mobil uygulamanın doğru çalışmasını sağlamak için belirli yönlendirme URI'lerinde ayarlamalar yapılması.
- Kullanıcı erişimini otomatikleştirmek için Otomatik Kayıt ve Otomatik Başlatma özelliğinin uygulanması.

Authentik'i Immich'e nasıl bağlarım? Evde kendi fotoğraf sunucunuzu kuruyorsanız, muhtemelen bunu zaten biliyorsunuzdur. Immich gerçek bir cevher.Ancak kullanıcıları tek tek yönetmek baş ağrısı olabilir. Şifreyi binlerce kez yazmaktan veya tüm aile için manuel olarak hesap oluşturmaktan kaçınmak için en akıllıca şey, bir sistem kurmaktır. Tekli Oturum Açma (SSO)İşte tam bu noktada Authentik devreye giriyor.
Fikir basit: Authentik, sunucunuzun bekçisi görevi görerek kim olduğunuzu doğrular, böylece siz de daha sonra işlemlerinizi gerçekleştirebilirsiniz. İmmich'e sorunsuz bir şekilde girildi.OIDC'yi (OpenID Connect) yapılandırmak teknik açıdan karmaşık bir süreç gibi görünse de, iki uygulamanın nasıl iletişim kurduğunu anladığınızda oldukça kolaylaşır ve dağıtım çok rahat hale gelir. profesyonel sonuç ve çok daha güvenli.
Authentik'te zemin hazırlığı
Immich'te herhangi bir şeye dokunmadan önce, Authentik'e kullanıcılarının kullanmasına izin vermek istediği bir fotoğraf uygulaması olduğunu bildirmemiz gerekiyor. Bunu yapmak için ilk adım, yönetim arayüzüne gidip bir hesap oluşturmaktır. OpenID türü sağlayıcısıBu sağlayıcıyı yapılandırdığınızda, sistemin otomatik olarak bir dosya oluşturduğunu göreceksiniz. İstemci Kimliği ve İstemci Gizli AnahtarıBu verileri bir not defterine yazın çünkü bunlar daha sonra Immich yapılandırmasına yapıştıracağımız anahtar verilerdir.
Önemli bir ayrıntı da yetkilendirme akışıdır: Kullanıcılarınızın her giriş yaptıklarında izinleri kabul etmek zorunda kalmalarını istemiyorsanız, şunu seçebilirsiniz: örtük akış Süreci hızlandırmak için. Yönlendirme URI'leri konusunda, abartmayın ve Immich dokümanında belirtilenleri aynen kullanın, çünkü tek bir karakter bile yanlış olursa sistem hata verecek ve oturum açmanızı engelleyecektir. Authentik'in çok eski sürümlerini (2026.5 öncesi) kullanıyorsanız, şunu aklınızda bulundurun: Tüm URI'ler Yetkilendirme türü olarak ele alınır.Bu nedenle, çıkış URI'lerini yapılandırarak işleri karmaşıklaştırmayın.
Tedarikçiyi belirledikten sonraki adım, oluşturmaktır. Uygulamanın kendisi Authentik panelinde. Sadece bir isim vermeniz (örneğin "Fotoğraflarım" veya "Immich") ve yeni oluşturduğunuz sağlayıcıya bağlamanız gerekiyor. Son olarak, sağlayıcı ayrıntılarına geri dönün ve kopyalayın. Yayıncı URL'si (OpenID Yapılandırma Yayıncısı)Bu, Immich'in kimlik doğrulama yöntemini bulmak için kullanacağı adrestir.
Immich'te detaylı yapılandırma

Şimdi Immich web sitesine geçiyoruz. Şu bölüme gitmeniz gerekiyor: Yönetim, ardından Ayarlar OAuth Kimlik Doğrulama bölümünü bulun. Etkinleştir kutusunu işaretleyin ve göz korkutucu görünen ancak aslında çok basit olan bir form belirecektir. Buraya yapıştıracağınız şey budur. Yayınlayan URL, İstemci Kimliği ve İstemci Gizli Anahtarı Daha önce kaydettiğiniz.
Sorunsuz bir deneyim için etkinleştirmenizi öneririm. Otomatik KayıtBu, kullanıcının Authentik üzerinden ilk kez giriş yaptığında otomatik olarak Immich hesabını oluşturur ve Otomatik BaşlatmaBu, kullanıcıyı Immich ana ekranından geçmeden doğrudan Authentik giriş sayfasına yönlendirir. Burada dikkat edilmesi gereken nokta: Otomatik Başlatmayı etkinleştirirseniz, Dışarıda kalabilirsiniz. Yerel yönetici hesabınızdan giriş yapın. Orijinal yönetici hesabıyla giriş yapmak için, özel URL'yi eklemeniz gerekecektir. ?autoLaunch=0 Giriş adresinin sonunda.
URI'lerin ve mobil erişimin bilmecesi

İşte birçok kişinin hata yaptığı yer burası. Immich, erişim sağladığınız yere bağlı olarak çeşitli yönlendirme URI'lerine ihtiyaç duyar. Web için şunları eklemeniz gerekecek: /auth/login ve /user-settings Alan adınızla birlikte. Ancak en kritik nokta mobil uygulama: URI'yi mutlaka eklemelisiniz. uygulama.immich:///oauth-callbackKimlik doğrulama sunucunuz bu özel şemayı kabul etmiyorsa, çözüm, köprü görevi gören ve trafiği bu adrese yönlendiren bir HTTP uç noktası yapılandırmak ve bunu daha sonra belirtmektir. Mobil Yönlendirme URI Geçersiz Kılma seçeneği Immich tarafından.
Özellikle Docker veya Unraid ortamlarında 500 hatası veya ağ sorunlarıyla karşılaşırsanız, sorun konteynerlerin genel alan adlarını kullanarak birbirlerini görememesinden kaynaklanıyor olabilir. Bazı kullanıcılar bunu şu şekilde çözmüştür: Alan adları yerine yerel IP adresleri veya ana ağda, ters proxy ile kimlik doğrulama hizmetleri arasında trafiğin doğru şekilde akmasını sağlayacak şekilde ayarlamalar yapılarak.
Kullanıcı ve izin yönetimi

Her şeyin düzgün çalıştığını test etmek için Authentik yönetici hesabını kullanmayın. Kullanıcı dizinine gidin, yeni kullanıcı oluştur Kendi şifrenizle giriş yapın ve bu hesapla Immich'e giriş yapmayı deneyin. Her şey yolunda giderse, Authentik'e yönlendirileceksiniz, bilgilerinizi girin ve işte! Fotoğraf galerinizde olacaksınız. Unutmayın ki, ayarlar üzerinde dilediğiniz gibi oynayabilirsiniz. Depolama talepleri Immich yapılandırmasında, Authentik'in token'da gönderdiği bilgilere dayanarak her kullanıcıya belirli disk kotaları atanır.
Bu iki aracı entegre etmek, kimlik doğrulamasını sağlam bir sisteme devrederek güvenliği merkezileştirmenize ve parola yorgunluğunu önlemenize olanak tanır. Hem web'de hem de mobil uygulamada OIDC akışlarını ve yönlendirme rotalarını doğru şekilde yapılandırarak, erişimin son kullanıcı için şeffaf ancak yönetici tarafından sıkı bir şekilde kontrol edildiği bir ekosistem oluşturursunuz ve kişisel laboratuvarınızda kimlik yönetimini optimize edersiniz.
İndeks