Въведение
Usher е доставчик на идентичност: осигурява вход на хората във вашите приложения, пази акаунтите им и казва на приложението ви кои са те. Прави всичко това с OpenID Connect и OAuth 2.1, така че работи с библиотеките, които вече използвате.
Какво прави Usher
Разпоредителят (на английски usher) има две задачи на входа. Проверява билета ви и ви отвежда до мястото ви. Usher върши същите две задачи за вашето приложение:
- Удостоверяване. Хората доказват кои са в Lobby – хостваната от Usher страница за вход – с ключ за достъп, код по имейл, магическа връзка, социален акаунт или парола.
- Оторизация. Приложението ви получава токени, които казват кой е човекът и какво се е съгласил да сподели, а вашият API може да ги проверява.
Частите
| Част | Какво представлява |
|---|---|
| Lobby | Хостваната страница за вход. Винаги назовава приложението, към което отива човекът. |
| Акаунт в Usher | Това, което има всеки човек: имейлът му, ключовете за достъп, вторите фактори и устройствата, на които е влязъл. |
| Usher Console | Мястото, където създавате проекти и среди, регистрирате приложения и управлявате потребители. |
| SDK и компоненти | @usher/nextjs, с <SignIn /> и <UserButton />. Идва със SDK. |
Как се вписва в приложението ви
Всяка среда, която създадете, е отделен издател на OpenID Connect със собствен адрес:
Издател
https://<handle>.usherid.comПриложението ви изпраща хората към този издател, за да влязат, и ги получава обратно с код, който разменя срещу токени. Това е стандартният поток с код за оторизация и PKCE, а всяка негова стъпка е описана в документа за откриване на издателя:
Документ за откриване
https://<handle>.usherid.com/.well-known/openid-configurationОткъде да започнете
Бързо начало: Next.jsДобавете вход в приложение на Next.js с App Router.
Бързо начало: всяка OIDC библиотекаНастройките, от които има нужда всеки клиент на OpenID Connect.
Основни понятияРаботни пространства, проекти, среди, издатели и токени.
СигурностКак средите се държат отделени и как се запечатват тайните.