Introduzione
Usher è un identity provider: fa accedere le persone alle tue app, protegge i loro account e dice alla tua app chi sono. Fa tutto questo con OpenID Connect e OAuth 2.1, quindi funziona con le librerie che usi già.
Cosa fa Usher
Un usher, la maschera all’ingresso di un teatro, svolge due compiti. Controlla il tuo biglietto e ti accompagna al tuo posto. Usher svolge gli stessi due compiti per la tua app:
- Autenticazione. Le persone dimostrano chi sono nella Lobby, la pagina di accesso ospitata da Usher, con una passkey, un codice via email, un magic link, un account social o una password.
- Autorizzazione. La tua app riceve dei token che dicono chi è la persona e cosa ha acconsentito a condividere, e la tua API può verificarli.
I componenti
| Componente | Che cos’è |
|---|---|
| La Lobby | La pagina di accesso ospitata. Indica sempre l’app verso cui la persona sta andando. |
| Account Usher | Ciò che ha una persona: la sua email, le passkey, i secondi fattori e i dispositivi su cui ha eseguito l’accesso. |
| Usher Console | Dove crei progetti e ambienti, registri le applicazioni e gestisci gli utenti. |
| SDK e componenti | @usher/nextjs, con <SignIn /> e <UserButton />. In arrivo con l’SDK. |
Come si inserisce nella tua app
Ogni ambiente che crei è un issuer OpenID Connect a sé, con un indirizzo tutto suo:
Issuer
https://<handle>.usherid.comLa tua app manda le persone a quell’issuer per accedere e le riceve di ritorno con un codice, che scambia con dei token. È il flusso standard del codice di autorizzazione con PKCE, e ogni suo passaggio è descritto dal documento di discovery dell’issuer:
Documento di discovery
https://<handle>.usherid.com/.well-known/openid-configurationDa dove iniziare
Guida rapida: Next.jsAggiungi l’accesso a un’app Next.js con l’App Router.
Guida rapida: qualsiasi libreria OIDCLe impostazioni di cui ha bisogno ogni client OpenID Connect.
ConcettiSpazi di lavoro, progetti, ambienti, issuer e token.
SicurezzaCome gli ambienti restano separati e come vengono sigillati i segreti.