Перехід на LDAP або SAML

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

Тепер ви хочете інтегруватися з системою LDAP/Active Directory вашої компанії. У цій системі дані Alice такі:

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

Ваша мета — щоб Alice входила за допомогою свого імені користувача LDAP (alicejones) і пароля замість старих облікових даних Overleaf, не втративши жодної своєї роботи. Ось як цього досягти.

Цей процес потребує перестворення контейнера sharelatex, що спричинить певний простій. Наполегливо радимо спершу ознайомитися з процесом, виконавши його в тестовому/проміжному середовищі.

1. Попросіть користувачів оновити адреси електронної пошти

   Облікові записи Overleaf прив’язані до адрес електронної пошти, тому першим кроком є синхронізація адрес електронної пошти користувачів в Overleaf з їхніми адресами в LDAP або SAML.

   У нашому прикладі ви попросите Alice увійти у свій обліковий запис Overleaf і змінити адресу з [e-mail] на [e-mail].

   Не забудьте про себе! Якщо ви адміністратор, вам також потрібно оновити власну адресу електронної пошти.

   Якщо у вас багато користувачів, можна скористатися скриптом міграції імен користувачів, щоб масово змінити основні адреси електронної пошти користувачів.

2. Увімкніть модуль LDAP або SAML

   Коли адреси електронної пошти всіх користувачів оновлено, настав час перемкнути систему! Потрібно задати відповідні змінні середовища для нового методу автентифікації, а потім перестворити контейнер sharelatex за допомогою команди bin/up -d.

   Це замінить стандартну форму входу Overleaf на нову форму LDAP або SAML.

   Відповідні відомості щодо ввімкнення LDAP можна знайти тут, а щодо SAML 2.0 — тут.

3. Тепер користувачі можуть входити через LDAP або SAML

   Наступного разу, коли Alice входитиме в систему, вона побачить нову форму.

   

   Вона може ввести своє ім’я користувача LDAP (alicejones) і пароль, а оскільки її адреса електронної пошти тепер збігається з адресою в LDAP, вона одразу ввійде у свій наявний обліковий запис Overleaf. Усі її проєкти залишаться саме там, де вона їх залишила.

   Якщо ви ввімкнули SAML 2.0, користувачі побачать кнопку, натискання якої перенаправить їх до вашого IdP для введення облікових даних. Після успішної автентифікації їх буде перенаправлено назад до вашого екземпляра Overleaf і виконано вхід в обліковий запис.

   

   Відомості про налаштування сторінки входу див. на сторінці Змінні середовища.

   А якщо колись знадобиться відкотитися, просто закоментуйте конфігурацію LDAP/SAML і перестворіть контейнер sharelatex за допомогою команди bin/up -d. Після цього користувачі зможуть входити за допомогою поточної адреси електронної пошти та пароля Overleaf.

​

Зворотний шлях: перехід з LDAP/SAML назад на вбудовану автентифікацію

Що робити, якщо ви деякий час використовували LDAP або SAML і хочете перейти на вбудовану систему входу Overleaf (наприклад, ви відмовилися від LDAP)? Без проблем! Ось як можна здійснити цей перехід.

1. Перевірте правильність адрес електронної пошти всіх користувачів

   Облікові записи ваших користувачів уже прив’язані до їхніх адрес електронної пошти з LDAP або SAML. Саме цю адресу вони використовуватимуть для входу надалі, тож просто переконайтеся, що все правильно.

2. Вимкніть модуль LDAP або SAML

   Просто видаліть або скиньте параметри конфігурації LDAP/SAML і перестворіть контейнер sharelatex за допомогою команди bin/up -d. Це поверне вбудовану форму входу Overleaf за адресою електронної пошти та паролем.

   
3. Попросіть користувачів скинути паролі

   Тепер, відвідавши сторінку входу, користувачі побачать форму входу Overleaf замість форми LDAP/SAML.

   Оскільки вони, можливо, ніколи не мали власного пароля Overleaf, їм потрібно його створити. Кожен користувач повинен:

   • Натиснути посилання “Forgot your password?”.
   • Ввести адресу електронної пошти, пов’язану з обліковим записом (ту, що з LDAP/SAML).
   • Перейти за посиланням у листі для скидання пароля і задати новий пароль.

   Якщо ви ще цього не зробили, ознайомтеся з нашим посібником з увімкнення доставки електронної пошти.

   Після цього вони зможуть входити за допомогою своєї адреси електронної пошти та нового пароля Overleaf і отримати доступ до всіх своїх проєктів.