Быстрый старт

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

Для базовой интеграции достаточно выполнить три шага:

создать и настроить проект;
подключить Авторизу к своему приложению;
проверить вход пользователя.

1. Создайте и настройте проект

В кабинете Авторизы нажмите «Создать проект».

Авториза автоматически создаст:

проект;
первое подключение для приложения.

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

Например:

https://example.com/auth/callback

Если приложение работает локально:

http://localhost:3000/auth/callback

После сохранения настроек проект готов к интеграции.

Результат: Авториза готова принять подключение вашего приложения.

Подробнее:

2. Подключите Авторизу к своему приложению

Выберите способ интеграции в зависимости от вашего приложения.

Coding Agent (AI-агент для разработки)

Если вы используете ИИ-агента для разработки программного обеспечения, который умеет работать с MCP, Авторизу можно подключить как MCP-сервер.

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

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

Подробнее:

Авториза для AI-чатов и coding agents

AI-чат

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

Например, можно попросить чат:

объяснить, как подключить Авторизу к проекту;
найти нужную информацию в документации;
создать проект;
настроить подключение;
проверить настройки проекта.

В этом случае ИИ-чат сможет не только отвечать на вопросы, но и выполнять доступные действия в Авторизе.

Подробнее:

Авториза для AI-чатов и coding agents

SDK

Если вы разрабатываете приложение на JavaScript или TypeScript, используйте SDK для фронтенда.

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

Установите пакет:

npm install @authoriza/sdk

Затем настройте SDK с параметрами созданного подключения.

Библиотека OpenID Connect

Если в вашем проекте уже используется библиотека для OpenID Connect (OIDC), вы можете подключить Авторизу напрямую.

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

Этот вариант также подходит, если вы хотите самостоятельно управлять процессом входа.

Подробнее:

Библиотеки OIDC.

Результат: ваше приложение готово использовать Авторизу для входа пользователей.

3. Проверьте вход пользователя

Запустите приложение и нажмите «Войти».

Пользователь будет перенаправлен в Авторизу, где сможет пройти вход.

После успешного входа Авториза вернёт пользователя в ваше приложение.

Ваше приложение получит информацию о вошедшем пользователе и сможет:

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

В упрощённом виде процесс выглядит так:

Ваше приложение
       │
       │  Войти
       ▼
   Авториза
       │
       │  Вход пользователя
       ▼
Ваше приложение
       │
       │  Пользователь вошёл
       ▼
  Ваш сервис

Подробнее:

Первый вход пользователя.