Úvod
Usher je poskytovateľ identity: prihlasuje ľudí do vašich aplikácií, chráni ich účty a hovorí vašej aplikácii, kto sú. Všetko to robí cez OpenID Connect a OAuth 2.1, takže funguje s knižnicami, ktoré už používate.
Čo Usher robí
Uvádzač (usher) má pri dverách dve úlohy. Skontroluje vašu vstupenku a odprevadí vás na vaše miesto. Usher robí pre vašu aplikáciu tie isté dve veci:
- Autentifikácia. Ľudia v Lobby, hostovanej prihlasovacej stránke služby Usher, preukážu, kto sú: prístupovým kľúčom, kódom poslaným e-mailom, magickým odkazom, účtom sociálnej siete alebo heslom.
- Autorizácia. Vaša aplikácia dostane tokeny, ktoré hovoria, kto človek je a čo súhlasil zdieľať, a vaše API ich môže overiť.
Jednotlivé časti
| Časť | Čo to je |
|---|---|
| Lobby | Hostovaná prihlasovacia stránka. Vždy uvedie aplikáciu, do ktorej človek ide. |
| Účet Usher | To, čo má človek: e-mail, prístupové kľúče, druhé faktory a prihlásené zariadenia. |
| Usher Console | Tu vytvárate projekty a prostredia, registrujete aplikácie a spravujete používateľov. |
| SDK a komponenty | @usher/nextjs s <SignIn /> a <UserButton />. Príde spolu s SDK. |
Ako to zapadá do vašej aplikácie
Každé prostredie, ktoré vytvoríte, je samostatný vydavateľ OpenID Connect na vlastnej adrese:
Vydavateľ
https://<handle>.usherid.comVaša aplikácia pošle ľudí na prihlásenie k tomuto vydavateľovi a dostane ich späť s kódom, ktorý vymení za tokeny. To je štandardný tok s autorizačným kódom a PKCE a každý jeho krok opisuje dokument zisťovania vydavateľa:
Dokument zisťovania
https://<handle>.usherid.com/.well-known/openid-configurationKde začať
Rýchly štart: Next.jsPridajte prihlásenie do aplikácie Next.js s App Routerom.
Rýchly štart: akákoľvek knižnica OIDCNastavenia, ktoré potrebuje každý klient OpenID Connect.
KonceptyPracovné priestory, projekty, prostredia, vydavatelia a tokeny.
BezpečnosťAko sú prostredia od seba oddelené a ako sa pečatia tajné údaje.