> 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/ru/upravlenie-polzovatelyami-i-proektami/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 вашей компании. В этой системе данные Алисы таковы: ``` Алиса: - uid: 'alicejones' - mail: 'alicejones@tech.example.com' - givenName: 'Alice' - sn: 'Jones' ``` Ваша цель — чтобы Алиса входила в систему, используя своё LDAP-имя пользователя (`alicejones`) и пароль вместо старых учетных данных Overleaf, не потеряв ни одной из своих работ. Вот как этого добиться. {% hint style="warning" %} Для этого потребуется пересоздать **sharelatex** контейнер, что приведёт к некоторому простою. Настоятельно рекомендуем сначала ознакомиться с этим процессом, выполнив его в тестовой/предпродакшн-среде. {% endhint %} {% stepper %} {% step %} ### Попросите пользователей обновить свои адреса электронной почты Аккаунты Overleaf привязаны к адресам электронной почты, поэтому первым шагом будет синхронизировать адреса Overleaf ваших пользователей с их адресами LDAP или SAML. В нашем примере вы попросите Алису войти в свой аккаунт Overleaf и изменить свой адрес электронной почты с `alice@example.com` с `alicejones@tech.example.com`. {% hint style="warning" %} Не забудьте про себя! Если вы администратор, вам тоже нужно будет обновить свой адрес электронной почты. {% endhint %} {% hint style="success" %} Если у вас много пользователей, вы можете использовать [Миграция имени пользователя](/on-premises/ru/upravlenie-polzovatelyami-i-proektami/user-management/username-migration.md) скрипт для массового изменения основного адреса электронной почты пользователя. {% endhint %} {% endstep %} {% step %} ### Включите модуль LDAP или SAML Когда адреса электронной почты у всех будут обновлены, пора переключать! Вам нужно будет задать правильные переменные окружения для нового способа аутентификации, а затем пересоздать **sharelatex** контейнер с помощью `bin/up -d` команды. Это заменит стандартную форму входа Overleaf на вашу новую форму LDAP или SAML. {% hint style="info" %} Соответствующую информацию о включении LDAP можно найти [здесь](/on-premises/ru/konfiguraciya/overleaf-toolkit/authentication/ldap-authentication.md), а также SAML 2.0 [здесь](/on-premises/ru/konfiguraciya/overleaf-toolkit/authentication/saml-authentication.md). {% endhint %} {% endstep %} {% step %} ### Теперь пользователи могут входить через LDAP или SAML В следующий раз, когда Алиса попробует войти, она увидит новую форму. ![Страница входа LDAP/Active Directory](/files/a3dfebcf0d4567c7b7cd06d202cf2ea0e0a6f293) Они могут ввести своё LDAP-имя пользователя (`alicejones`) и пароль, и поскольку их адрес электронной почты теперь совпадает с адресом в LDAP, они сразу войдут в свой существующий аккаунт Overleaf. Все их проекты будут точно там, где они их оставили. Если вы включили SAML 2.0, пользователи увидят кнопку, которая при нажатии перенаправит их к вашему IdP для ввода учётных данных. После успешной аутентификации их перенаправит обратно к вашему экземпляру Overleaf, и они войдут в свой аккаунт. ![Страница входа SAML](/files/c38ae97f1700a9451d8be849bfd8cd983ecf8b40) {% hint style="info" %} См. [Переменные окружения](broken://pages/14e3a99831712fbed641777e9989c81f73f12a3c) страница с информацией о настройке внешнего вида и поведения страницы входа. А если вам когда-нибудь понадобится откат, просто закомментируйте конфигурацию 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/d277ecf0132a41d4f509ed23a84b138670ab803e) {% endstep %} {% step %} ### Попросите пользователей сбросить свои пароли Когда пользователи откроют страницу входа, они увидят форму входа Overleaf вместо формы LDAP/SAML. Поскольку у них, возможно, никогда не было собственного пароля Overleaf, им нужно будет создать его. Каждый пользователь должен: * Нажать ссылку «Забыли пароль?». * Введите адрес электронной почты, связанный с их аккаунтом (тот, что из LDAP/SAML). * Перейти по ссылке в письме для сброса пароля и установить новый пароль. {% hint style="info" %} Если вы ещё этого не сделали, ознакомьтесь с нашим руководством по включению [Доставки электронной почты](/on-premises/ru/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/ru/upravlenie-polzovatelyami-i-proektami/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.