Introduktion
Usher är en identitetsleverantör: den loggar in människor i dina appar, skyddar deras konton och talar om för din app vilka de är. Allt detta sker med OpenID Connect och OAuth 2.1, så den fungerar med de bibliotek du redan använder.
Vad Usher gör
En platsanvisare har två uppgifter vid dörren: att kontrollera din biljett och att visa dig till din plats. Usher gör samma två saker för din app:
- Autentisering. Människor bevisar vilka de är i Lobbyn, Ushers inloggningssida, med en lösennyckel, en kod via e-post, en magisk länk, ett socialt konto eller ett lösenord.
- Auktorisering. Din app får tokens som säger vem personen är och vad den har godkänt att dela, och ditt API kan kontrollera dem.
Delarna
| Del | Vad det är |
|---|---|
| Lobbyn | Inloggningssidan som Usher står värd för. Den nämner alltid appen personen är på väg till. |
| Usher-konto | Det en person har: e-postadress, lösennycklar, andra faktorer och inloggade enheter. |
| Usher Console | Där du skapar projekt och miljöer, registrerar appar och hanterar användare. |
| SDK och komponenter | @usher/nextjs, med <SignIn /> och <UserButton />. Kommer med SDK:t. |
Så passar det in i din app
Varje miljö du skapar är sin egen OpenID Connect-utfärdare, på en egen adress:
Utfärdare
https://<handle>.usherid.comDin app skickar människor till den utfärdaren för att logga in och får tillbaka dem med en kod som den byter mot tokens. Det är det vanliga auktoriseringskodflödet med PKCE, och varje steg i det beskrivs av utfärdarens discovery-dokument:
Discovery-dokument
https://<handle>.usherid.com/.well-known/openid-configuration