Введение

Usher — это поставщик удостоверений: он впускает людей в ваши приложения, бережет их аккаунты и сообщает вашему приложению, кто они. Все это работает на OpenID Connect и OAuth 2.1, поэтому Usher совместим с библиотеками, которыми вы уже пользуетесь.

Что делает Usher

Билетер в театре — по-английски usher — делает у входа две вещи: проверяет ваш билет и провожает вас на место. Usher делает то же самое для вашего приложения:

Аутентификация. Люди подтверждают, кто они, в Lobby — странице входа, которую размещает Usher, — с помощью ключа входа, кода из письма, ссылки для входа, аккаунта в соцсети или пароля.
Авторизация. Ваше приложение получает токены, в которых сказано, кто этот человек и какими данными он согласился поделиться, а ваш API может их проверить.

Из чего состоит Usher

Часть	Что это
Lobby	Страница входа на стороне Usher. Она всегда называет приложение, в которое переходит человек.
Аккаунт Usher	То, что есть у человека: его e-mail, ключи входа, второй фактор и устройства, на которых выполнен вход.
Usher Console	Здесь вы создаете проекты и среды, регистрируете приложения и управляете пользователями.
SDK и компоненты	`@usher/nextjs` с `<SignIn />` и `<UserButton />`. Появится вместе с SDK.

Как Usher встраивается в ваше приложение

Каждая созданная вами среда — отдельный издатель OpenID Connect со своим собственным адресом:

Издатель

https://<handle>.usherid.com

Ваше приложение отправляет людей к этому издателю для входа и получает их обратно с кодом, который обменивает на токены. Это стандартный поток кода авторизации с PKCE, и каждый его шаг описан в документе обнаружения издателя:

Документ обнаружения

https://<handle>.usherid.com/.well-known/openid-configuration

С чего начать

Быстрый старт: Next.jsДобавьте вход в приложение Next.js с App Router. Быстрый старт: любая библиотека OIDCНастройки, которые нужны любому клиенту OpenID Connect. Основные понятияРабочие пространства, проекты, среды, издатели и токены. БезопасностьКак среды отделены друг от друга и как запечатываются секреты.