Планируемый переход на Авторизу

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

Авториза позволяет связать существующих пользователей с профилями внутри вашего проекта и постепенно перевести приложение на использование OpenID Connect.

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

Шаг 1. Подготовьте приложение

Перед переносом пользователей рекомендуется:

создать проект;
создать приложение;
выполнить интеграцию с Авторизой;
протестировать процесс входа на тестовых пользователях.

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

Шаг 2. Подготовьте пакет переноса данных

Подготовьте пакет переноса данных в формате JSON.

Минимальный пример:

{
  "version": 1,
  "users": [
    {
      "user_id": "15284",
      "contact": "user@example.com",
      "attributes": {
        "department": "Sales"
      }
    }
  ]
}

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

Поле	Обязательно	Описание
`version`	✓	Версия формата пакета переноса данных.
`users`	✓	Список пользователей.
`user_id`	✓	Идентификатор пользователя в вашей системе. Используется для сохранения связи между вашей системой и профилем пользователя в Авторизе.
`contact`	✓	Контактный идентификатор пользователя. В текущей версии используется адрес электронной почты. В будущих версиях способ связи с пользователем может зависеть от настроек проекта и выбранного уровня приватности.
`attributes`	Нет	Дополнительные пользовательские данные, которые могут использоваться вашим приложением после входа пользователя.

Передача паролей или их хэшей в Авторизу не требуется и не поддерживается.

Шаг 3. Передайте пакет

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

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

После обработки пакета существующие пользователи будут связаны с профилями внутри вашего проекта.

Шаг 4. Проверьте результат

После завершения обработки рекомендуется проверить:

вход существующих пользователей;
получение ID Token и Access Token;
дополнительные claims;
работу приложения с импортированными пользователями.

При необходимости перенос можно повторить после исправления замечаний.

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

После успешной проверки приложение можно полностью переключить на Авторизу.

Новые пользователи будут регистрироваться уже через Авторизу.

Существующие пользователи при первом входе:

подтверждают владение своей учетной записью;
устанавливают пароль Авторизы;
продолжают использовать приложение без создания новой учетной записи.

Что происходит с паролями

Авториза не принимает пароли существующих систем и не импортирует их.

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

Благодаря этому пароли никогда не передаются между различными системами.