LDAP veya SAML'ye Geçiş

{
  _id:        '123',
  email:      '[e-mail]'
  first_name: 'Alice',
  last_name:  'Jones'
}

Şimdi şirketinizin LDAP/Active Directory sistemiyle entegrasyon yapmak istiyorsunuz. Bu sistemde Alice’in bilgileri şöyledir:

Alice:
  - uid:  'alicejones'
  - mail: '[e-mail]'
  - givenName:   'Alice'
  - sn: 'Jones'

Amacınız, Alice’in hiçbir çalışmasını kaybetmeden eski Overleaf kimlik bilgileri yerine LDAP kullanıcı adı (alicejones) ve parolasıyla giriş yapmasını sağlamaktır. Bunu şu şekilde gerçekleştirebilirsiniz.

Bu süreç, sharelatex konteynerinin yeniden oluşturulmasını gerektirir ve bu da bir miktar kesinti süresine yol açar. Bu süreci önce bir test/hazırlık (staging) ortamında uygulayarak tanımanızı önemle tavsiye ederiz.

1. Kullanıcılarınızdan e-posta adreslerini güncellemelerini isteyin

   Overleaf hesapları e-posta adreslerine bağlıdır; bu nedenle ilk adım, kullanıcılarınızın Overleaf e-postalarını LDAP veya SAML e-postalarıyla eşitlemektir.

   Örneğimizde Alice’ten Overleaf hesabına giriş yapmasını ve e-postasını [e-mail] adresinden [e-mail] adresine değiştirmesini istersiniz.

   Kendinizi unutmayın! Yöneticiyseniz kendi e-posta adresinizi de güncellemeniz gerekir.

   Çok sayıda kullanıcınız varsa, kullanıcıların birincil e-posta adreslerini toplu olarak değiştirmek için Username migration betiğini kullanabilirsiniz.

2. LDAP veya SAML modülünü etkinleştirin

   Herkesin e-posta adresi güncellendiğinde düğmeye basma zamanı gelmiştir! Yeni kimlik doğrulama yönteminiz için doğru ortam değişkenlerini ayarlamanız ve ardından bin/up -d komutunu kullanarak sharelatex konteynerini yeniden oluşturmanız gerekir.

   Bu, standart Overleaf giriş formunu yeni LDAP veya SAML formunuzla değiştirir.

   LDAP’yi etkinleştirmeyle ilgili bilgileri burada, SAML 2.0 ile ilgili bilgileri ise burada bulabilirsiniz.

3. Kullanıcılar artık LDAP veya SAML ile giriş yapabilir

   Alice bir sonraki girişinde yeni formu görür.

   

   LDAP kullanıcı adını (alicejones) ve parolasını girebilir; e-posta adresi artık LDAP’deki adresle eşleştiği için doğrudan mevcut Overleaf hesabına giriş yapar. Tüm projeleri tam olarak bıraktığı yerde olur.

   SAML 2.0’ı etkinleştirdiyseniz kullanıcılar, tıklandığında kimlik bilgilerini girmeleri için onları IdP’nize yönlendiren bir düğme görür. Kimlik doğrulama başarılı olduğunda Overleaf örneğinize geri yönlendirilir ve hesaplarına giriş yaparlar.

   

   Giriş sayfası deneyimini özelleştirme hakkında bilgi için Ortam Değişkenleri sayfasına bakın.

   Geri dönmeniz gerekirse, LDAP/SAML yapılandırmasını yorum satırına alıp bin/up -d komutunu kullanarak sharelatex konteynerini yeniden oluşturmanız yeterlidir. Kullanıcılar bundan sonra mevcut e-posta adresleri ve Overleaf’e özgü parolalarıyla giriş yapabilir.

​

Ters yönde geçiş: LDAP/SAML’den yerel kimlik doğrulamaya geri dönme

Bir süredir LDAP veya SAML kullanıyorsanız ve Overleaf’in yerleşik giriş sistemine geçmek istiyorsanız (belki LDAP’nizi kullanımdan kaldırdınız) ne olur? Sorun değil! Bu geçişi şu şekilde yapabilirsiniz.

1. Herkesin e-postasının doğru olduğunu kontrol edin

   Kullanıcılarınızın hesapları zaten LDAP veya SAML e-posta adreslerine bağlıdır. Bundan sonra giriş yapmak için bu e-postayı kullanacaklarından, her şeyin doğru göründüğünden emin olun.

2. LDAP veya SAML modülünü devre dışı bırakın

   LDAP/SAML yapılandırma ayarlarını kaldırmanız veya ayarlarını sıfırlamanız ve bin/up -d komutunu kullanarak sharelatex konteynerini yeniden oluşturmanız yeterlidir. Bu, yerel Overleaf e-posta ve parola giriş formunu geri getirir.

   
3. Kullanıcılardan parolalarını sıfırlamalarını isteyin

   Kullanıcılarınız artık giriş sayfasını ziyaret ettiklerinde LDAP/SAML formu yerine Overleaf giriş formunu görürler.

   Hiçbir zaman yerel bir Overleaf parolaları olmamış olabileceğinden bir parola oluşturmaları gerekir. Her kullanıcı şunları yapmalıdır:

   • “Forgot your password?” bağlantısına tıklamak.
   • Hesabıyla ilişkili e-posta adresini (LDAP/SAML’deki adres) girmek.
   • Yeni bir parola belirlemek için parola sıfırlama e-postasındaki bağlantıyı izlemek.

   Henüz yapmadıysanız, E-posta teslimi özelliğini etkinleştirme kılavuzumuza göz atın.

   Bu işlem tamamlandıktan sonra e-postaları ve Overleaf’e özgü yeni parolalarıyla giriş yaparak tüm projelerine erişebilirler.