Introduktion
Usher er en identitetsudbyder: Usher logger folk ind på dine apps, holder deres konti sikre og fortæller din app, hvem de er. Alt det sker med OpenID Connect og OAuth 2.1, så det virker med de biblioteker, du allerede bruger.
Hvad Usher gør
En usher – en kontrollør i teatret – har to opgaver ved døren. Kontrolløren tjekker din billet og viser dig hen til din plads. Usher gør de samme to ting for din app:
- Godkendelse. Folk beviser, hvem de er, i Lobbyen, Ushers hostede loginside, med en adgangsnøgle, en kode via e-mail, et magisk link, en social konto eller en adgangskode.
- Autorisation. Din app modtager tokens, der siger, hvem personen er, og hvad personen har sagt ja til at dele, og dit API kan tjekke dem.
Delene
| Del | Hvad det er |
|---|---|
| Lobbyen | Den hostede loginside. Den nævner altid den app, personen er på vej til. |
| Usher-konto | Det, en person har: e-mail, adgangsnøgler, anden faktor og enheder, der er logget ind. |
| Usher Console | Der, hvor du opretter projekter og miljøer, registrerer applikationer og administrerer brugere. |
| SDK og komponenter | @usher/nextjs med <SignIn /> og <UserButton />. Kommer med SDK’et. |
Sådan passer det ind i din app
Hvert miljø, du opretter, er sin egen OpenID Connect-udsteder med sin egen adresse:
Udsteder
https://<handle>.usherid.comDin app sender folk til udstederen for at logge ind og får dem tilbage med en kode, som den bytter til tokens. Det er det almindelige autorisationskodeflow med PKCE, og hvert trin i det er beskrevet i udstederens discovery-dokument:
Discovery-dokument
https://<handle>.usherid.com/.well-known/openid-configurationHvor du skal starte
Hurtig start: Next.jsFøj login til en Next.js-app med App Router.
Hurtig start: ethvert OIDC-bibliotekDe indstillinger, enhver OpenID Connect-klient har brug for.
BegreberArbejdsområder, projekter, miljøer, udstedere og tokens.
SikkerhedSådan holdes miljøer adskilt, og sådan forsegles hemmeligheder.