Быстрый старт - 5 этапов

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

Что получится в итоге

После интеграции:

пользователь нажимает «Войти» в вашем приложении;
Авториза выполняет авторизацию и возвращает пользователя обратно в приложение;
ваше приложение получает информацию о пользователе из токенов и может использовать её для создания или поиска учётной записи.

При этом вашему приложению не нужно самостоятельно реализовывать авторизацию через внешние сервисы — этим занимается Авториза.

Основные этапы

1. Создайте проект в Авторизе

Самый быстрый способ начать — нажать «Создать демо-проект» в Авторизе (доступно только если у вас ещё нет ни одного проекта).

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

Результат этапа:

Созданы требуемые для последующего подключения объекты.

Больше деталей:

2. Настройте Redirect URI

В кабинете клиента Авторизы укажите в настройках приложения адрес, на который Авториза вернёт пользователя после успешной авторизации.

Это адрес вашего приложения, поэтому его необходимо указать самостоятельно. Для разработки можно использовать localhost, а для продакшена — публичный URL вашего сервиса.

Страница по указанному адресу должна будет уметь обрабатывать переданные GET-параметры для продолжения процедуры входа.

На странице приложения в кабинете клиента получите конфигурацию для подключения.

Результат этапа:

Получена действующая конфигурация настроек для подключения.

Больше деталей:

3. Подключите приложение

Настройте приложение на использование Авторизы как сервиса авторизации. Для быстрого подключения рекомендуется использование готовых библиотек OpenID Connect или ИИ-агента.

Для этого приложение перенаправляет пользователя в Авторизу, а после завершения авторизации получает результат обратно.

Для интеграции можно использовать готовые OIDC-библиотеки для вашего языка или фреймворка.

Результат этапа:

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

Больше деталей:

4. Обработайте результат авторизации

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

На этом этапе необходимо корректно обработать callback и получить необходимые токены.

Результат этапа:

Приложение получает access, id, refresh токены

Больше деталей:

5. Получайте данные пользователя

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

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

Результат этапа:

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

Больше деталей:

Токены

Готово

После выполнения этих шагов базовая интеграция Авторизы завершена: пользователь может войти в ваше приложение, а приложение получает подтверждённую информацию о нём.

Дальше можно настроить проект и изучить дополнительные возможности Авторизы, которые нужны именно вашему приложению.