Вступ
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.
Основні поняттяРобочі простори, проєкти, середовища, видавці й токени.
БезпекаЯк середовища відокремлено одне від одного і як запечатано секрети.