Uvod
Usher je pružatelj identiteta: prijavljuje ljude u vaše aplikacije, čuva njihove račune i govori vašoj aplikaciji tko su. Sve to radi putem protokola OpenID Connect i OAuth 2.1, pa radi s bibliotekama koje već koristite.
Što Usher radi
Razvodnik na vratima obavlja dva posla: provjerava vašu ulaznicu i vodi vas do vašeg mjesta. Usher za vašu aplikaciju obavlja ista dva posla:
- Autentifikacija. Ljudi dokazuju tko su na stranici Lobby, hostiranoj stranici za prijavu platforme Usher, pristupnim ključem, kôdom poslanim e-poštom, čarobnom poveznicom, računom na društvenoj mreži ili lozinkom.
- Autorizacija. Vaša aplikacija dobiva tokene koji govore tko je osoba i što je pristala podijeliti, a vaš ih API može provjeriti.
Dijelovi
| Dio | Što je to |
|---|---|
| Lobby | Hostirana stranica za prijavu. Uvijek navodi aplikaciju u koju osoba ide. |
| Usher račun | Ono što osoba ima: adresa e-pošte, pristupni ključevi, drugi faktori i prijavljeni uređaji. |
| Usher Console | Ovdje izrađujete projekte i okruženja, registrirate aplikacije i upravljate korisnicima. |
| SDK i komponente | @usher/nextjs, sa <SignIn /> i <UserButton />. Stiže uz SDK. |
Kako se uklapa u vašu aplikaciju
Svako okruženje koje izradite zaseban je izdavatelj za OpenID Connect, na vlastitoj adresi:
Izdavatelj
https://<handle>.usherid.comVaša aplikacija šalje ljude tom izdavatelju na prijavu i vraća ih s kôdom koji mijenja za tokene. To je standardni tok autorizacijskog kôda uz PKCE, a svaki njegov korak opisan je u izdavateljevu dokumentu za otkrivanje:
Dokument za otkrivanje
https://<handle>.usherid.com/.well-known/openid-configurationOdakle početi
Brzi početak: Next.jsDodajte prijavu u aplikaciju Next.js koja koristi App Router.
Brzi početak: bilo koja OIDC bibliotekaPostavke koje treba svaki klijent za OpenID Connect.
KonceptiRadni prostori, projekti, okruženja, izdavatelji i tokeni.
SigurnostKako su okruženja međusobno odvojena i kako se tajne pečate.