Планируемый переход на иную систему

Если вы решите отказаться от использования Авторизы, вы сможете перенести данные пользователей своего проекта в другую систему аутентификации.

Чтобы минимизировать простой и риски, рекомендуется выполнять переход поэтапно.

Шаг 1. Подготовьте новую систему

Перед началом перехода:

разверните новую систему аутентификации;
реализуйте механизм импорта пользователей;
протестируйте импорт на тестовых данных.

Шаг 2. Получите тестовую выгрузку

Свяжитесь с командой Авторизы через раздел Контакты и запросите тестовый пакет переноса данных.

Он используется для проверки механизма импорта и настройки новой системы.

Шаг 3. Проверьте импорт

Импортируйте тестовый пакет и убедитесь, что:

пользователи создаются корректно;
сохраняются необходимые идентификаторы;
приложение успешно работает с новой системой.

При необходимости тестовый пакет может быть сформирован повторно.

Шаг 4. Получите промежуточную выгрузку

После успешного тестирования рекомендуется запросить промежуточный пакет переноса данных.

Он позволяет заранее перенести основную часть пользователей и сократить время окончательного перехода.

Шаг 5. Получите финальную выгрузку

Непосредственно перед переключением запросите финальный пакет переноса данных.

Он содержит наиболее актуальные сведения о пользователях вашего проекта.

Пример структуры пакета:

{
  "version": 1,
  "users": [
    {
      "profile_id": "d4f7b1a9-fd9f-4422-b5df-3560d6df1c4d",
      "external_user_id": "15284",
      "contact": "user@example.com",
      "attributes": {
        "department": "Sales"
      }
    }
  ]
}

Описание полей

Поле	Описание
`profile_id`	UUID профиля пользователя в Авторизе. Соответствует значению поля `sub` в ID Token.
`external_user_id`	Идентификатор пользователя, ранее переданный клиентом при переходе на Авторизу.
`contact`	Текущий адрес электронной почты пользователя.
`attributes`	Дополнительные пользовательские данные, ранее переданные клиентом.

Шаг 6. Переключите приложение

После импорта финального пакета переключите приложение на новую систему аутентификации.

Поскольку пароли между системами не передаются, пользователям потребуется один раз установить новый пароль или воспользоваться процедурой восстановления доступа, предусмотренной новой системой.

Шаг 7. Завершите переход

После успешной проверки новой системы можно:

отключить интеграцию с Авторизой;
удалить проект;
завершить переход.

Передача данных

Пакеты переноса данных передаются по защищенному каналу.

Конкретный способ передачи определяется по согласованию с клиентом с учетом требований безопасности проекта.