> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/uk/keruvannya-koristuvachami-ta-proyektami/user-management/migrating-to-ldap-or-saml.md). # Міграція на LDAP або SAML ``` { _id: '123', email: 'alice@example.com' first_name: 'Alice', last_name: 'Jones' } ``` Тепер ви хочете інтегруватися з LDAP/Active Directory вашої компанії. У цій системі дані Alice такі: ``` Alice: - uid: 'alicejones' - mail: 'alicejones@tech.example.com' - givenName: 'Alice' - sn: 'Jones' ``` Ваша мета — дати Alice змогу входити, використовуючи своє LDAP-ім'я користувача (`alicejones`) і пароль замість старих облікових даних Overleaf, не втративши жодної своєї роботи. Ось як цього досягти. {% hint style="warning" %} Цей процес потребуватиме повторного створення **sharelatex** контейнера, що спричинить певний простій. Ми наполегливо рекомендуємо спочатку ознайомитися з цим процесом, виконавши його в тестовому/staging-середовищі. {% endhint %} {% stepper %} {% step %} ### Попросіть користувачів оновити свої адреси електронної пошти Облікові записи Overleaf прив’язані до адрес електронної пошти, тож перший крок — синхронізувати електронні адреси Overleaf ваших користувачів з їхніми адресами LDAP або SAML. У нашому прикладі ви попросите Alice увійти у свій обліковий запис Overleaf і змінити свою адресу електронної пошти з `alice@example.com` до `alicejones@tech.example.com`. {% hint style="warning" %} Не забудьте про себе! Якщо ви адміністратор, вам також потрібно буде оновити свою адресу електронної пошти. {% endhint %} {% hint style="success" %} Якщо у вас багато користувачів, ви можете скористатися [Міграція імені користувача](/on-premises/uk/keruvannya-koristuvachami-ta-proyektami/user-management/username-migration.md) скриптом, щоб масово змінити основну адресу електронної пошти користувача. {% endhint %} {% endstep %} {% step %} ### Увімкніть модуль LDAP або SAML Після того як адреси електронної пошти всіх будуть оновлені, час натиснути на перемикач! Вам потрібно буде встановити правильні змінні середовища для нового методу автентифікації, а потім знову створити **sharelatex** контейнер за допомогою `bin/up -d` команду. Це замінює стандартну форму входу Overleaf на вашу нову форму LDAP або SAML. {% hint style="info" %} Ви можете знайти потрібну інформацію для ввімкнення LDAP [тут](/on-premises/uk/konfiguraciya/overleaf-toolkit/authentication/ldap-authentication.md), а також SAML 2.0 [тут](/on-premises/uk/konfiguraciya/overleaf-toolkit/authentication/saml-authentication.md). {% endhint %} {% endstep %} {% step %} ### Користувачі тепер можуть входити через LDAP або SAML Наступного разу, коли Alice спробує увійти, вони побачать нову форму. ![Сторінка входу LDAP/Active Directory](/files/74bf9a09d27dab262626e8cfcce2160d72794541) Вони можуть ввести своє LDAP-ім'я користувача (`alicejones`) і пароль, і оскільки їхня адреса електронної пошти тепер збігається з тією, що в LDAP, вони відразу ввійдуть у свій наявний обліковий запис Overleaf. Усі їхні проєкти будуть точно там, де вони їх залишили. Якщо ви ввімкнули SAML 2.0, користувачі побачать кнопку, яка після натискання перенаправить їх до вашого IdP, щоб вони ввели свої облікові дані. Після успішної автентифікації їх буде перенаправлено назад до вашого екземпляра Overleaf і вони ввійдуть у свій обліковий запис. ![Сторінка входу SAML](/files/f3f920ba737aa52fbca3350d61198db984b3b674) {% hint style="info" %} Дивіться [Змінні середовища](broken://pages/2db6c85df4994d46e27a99e0d121414d97e0f879) сторінку з інформацією про налаштування вигляду сторінки входу. І якщо вам колись знадобиться відкотитися назад, просто закоментуйте конфігурацію LDAP/SAML і знову створіть **sharelatex** контейнер за допомогою `bin/up -d` контейнер за допомогою команди. Тоді користувачі зможуть входити, використовуючи свою поточну адресу електронної пошти та пароль Overleaf. {% endhint %} {% endstep %} {% endstepper %} ## У зворотному напрямку: перехід із LDAP/SAML назад до вбудованої автентифікації Що, якби ви вже деякий час використовували LDAP або SAML і хочете перейти на вбудовану систему входу Overleaf (можливо, ви вивели свій LDAP з експлуатації)? Немає проблем! Ось як можна це зробити. {% stepper %} {% step %} ### Перевірте, чи в усіх правильна електронна адреса Облікові записи ваших користувачів уже пов’язані з їхніми адресами електронної пошти LDAP або SAML. Саме цю адресу вони використовуватимуть для входу відтепер, тож просто переконайтеся, що все виглядає правильно. {% endstep %} {% step %} ### Вимкніть модуль LDAP або SAML Просто видаліть або зніміть налаштування конфігурації LDAP/SAML і знову створіть **sharelatex** контейнер за допомогою `bin/up -d` команду. Це поверне нативну форму входу Overleaf за допомогою електронної пошти та пароля. ![Сторінка входу з вбудованою автентифікацією](/files/26e95840b46d36657ee1088ae685a485bd1706fc) {% endstep %} {% step %} ### Попросіть користувачів скинути свої паролі Коли ваші користувачі тепер відвідають сторінку входу, вони побачать форму входу Overleaf замість форми LDAP/SAML. Оскільки в них, можливо, ніколи не було вбудованого пароля Overleaf, їм потрібно буде створити його. Кожен користувач повинен: * Натиснути посилання «Забули пароль?». * Ввести адресу електронної пошти, пов’язану з їхнім обліковим записом (ту, що з LDAP/SAML). * Перейти за посиланням у листі для скидання пароля, щоб установити новий пароль. {% hint style="info" %} Якщо ви ще цього не зробили, ознайомтеся з нашим посібником із ввімкнення [надсилання електронних листів](/on-premises/uk/konfiguraciya/overleaf-toolkit/email-delivery.md). {% endhint %} Коли це буде зроблено, вони зможуть увійти, використовуючи свою електронну пошту та новий пароль Overleaf, щоб отримати доступ до всіх своїх проєктів. {% endstep %} {% endstepper %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/on-premises/uk/keruvannya-koristuvachami-ta-proyektami/user-management/migrating-to-ldap-or-saml.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.