Uvod
Usher je ponudnik identitete: prijavlja ljudi v vaše aplikacije, varuje njihove račune in vaši aplikaciji pove, kdo so. Vse to počne z OpenID Connect in OAuth 2.1, zato deluje s knjižnicami, ki jih že uporabljate.
Kaj počne Usher
Vratar pri vratih opravlja dve nalogi: preveri vašo vstopnico in vas pospremi do sedeža. Usher za vašo aplikacijo opravlja isti dve nalogi:
- Preverjanje pristnosti. Ljudje v Lobbyju, Usherjevi gostovani strani za prijavo, dokažejo, kdo so, s ključem za dostop, kodo po e-pošti, čarobno povezavo, računom družbenega omrežja ali geslom.
- Avtorizacija. Vaša aplikacija prejme žetone, ki povedo, kdo je oseba in kaj je privolila deliti, vaš API pa jih lahko preveri.
Deli
| Del | Kaj je |
|---|---|
| Lobby | Gostovana stran za prijavo. Vedno imenuje aplikacijo, v katero gre oseba. |
| Račun Usher | Kar ima oseba: svoj e-poštni naslov, ključe za dostop, druge dejavnike in prijavljene naprave. |
| Usher Console | Kjer ustvarjate projekte in okolja, registrirate aplikacije in upravljate uporabnike. |
| SDK in komponente | @usher/nextjs, z <SignIn /> in <UserButton />. Prihaja s SDK-jem. |
Kako se vključi v vašo aplikacijo
Vsako okolje, ki ga ustvarite, je samostojen izdajatelj OpenID Connect, na svojem naslovu:
Izdajatelj
https://<handle>.usherid.comVaša aplikacija pošlje ljudi k temu izdajatelju, da se prijavijo, in jih dobi nazaj s kodo, ki jo zamenja za žetone. To je standardni potek z avtorizacijsko kodo in PKCE, vsak njegov korak pa opisuje izdajateljev dokument za odkrivanje:
Dokument za odkrivanje
https://<handle>.usherid.com/.well-known/openid-configurationKje začeti
Hitri začetek: Next.jsDodajte prijavo v aplikacijo Next.js z App Routerjem.
Hitri začetek: katera koli knjižnica OIDCNastavitve, ki jih potrebuje vsak odjemalec OpenID Connect.
KonceptiDelovni prostori, projekti, okolja, izdajatelji in žetoni.
VarnostKako so okolja ločena med seboj in kako so skrivnosti zapečatene.