Introduksjon
Usher er en identitetsleverandør: den logger folk på appene dine, holder kontoene deres trygge og forteller appen din hvem de er. Alt dette skjer med OpenID Connect og OAuth 2.1, så den fungerer med bibliotekene du allerede bruker.
Hva Usher gjør
En plassanviser har to oppgaver ved døren: å sjekke billetten din og å vise deg til plassen din. Usher gjør de samme to oppgavene for appen din:
- Autentisering. Folk beviser hvem de er i Lobbyen, påloggingssiden Usher drifter, med en passnøkkel, en kode på e-post, en magisk lenke, en sosial konto eller et passord.
- Autorisasjon. Appen din får tokener som sier hvem personen er og hva den har godtatt å dele, og API-et ditt kan sjekke dem.
Delene
| Del | Hva det er |
|---|---|
| Lobbyen | Den driftede påloggingssiden. Den viser alltid navnet på appen personen skal til. |
| Usher-konto | Det en person har: e-postadressen, passnøklene, de ekstra påloggingstrinnene og de påloggede enhetene. |
| Usher Console | Der du oppretter prosjekter og miljøer, registrerer apper og administrerer brukere. |
| SDK og komponenter | @usher/nextjs, med <SignIn /> og <UserButton />. Kommer med SDK-en. |
Slik passer det inn i appen din
Hvert miljø du oppretter, er sin egen OpenID Connect-utsteder, på sin egen adresse:
Utsteder
https://<handle>.usherid.comAppen din sender folk til den utstederen for å logge på, og får dem tilbake med en kode som den bytter mot tokener. Det er standard autorisasjonskodeflyt med PKCE, og hvert trinn er beskrevet i utstederens discovery-dokument:
Discovery-dokument
https://<handle>.usherid.com/.well-known/openid-configurationHvor du begynner
Hurtigstart: Next.jsLegg til pålogging i en Next.js-app med App Router.
Hurtigstart: alle OIDC-bibliotekerInnstillingene alle OpenID Connect-klienter trenger.
KonsepterArbeidsområder, prosjekter, miljøer, utstedere og tokener.
SikkerhetHvordan miljøer holdes adskilt, og hvordan hemmeligheter forsegles.