Salt la conținut
Documentație · Introducere

Introducere

Usher este un furnizor de identitate: conectează oamenii la aplicațiile dvs., le păstrează conturile în siguranță și îi spune aplicației cine sunt. Face toate acestea cu OpenID Connect și OAuth 2.1, așa că funcționează cu bibliotecile pe care le folosiți deja.

Ce face Usher

Un plasator are două sarcini la intrarea în sală: vă verifică biletul și vă conduce la locul dvs. Usher face aceleași două lucruri pentru aplicația dvs.:

  • Autentificare. Oamenii dovedesc cine sunt în Lobby, pagina de conectare găzduită de Usher, cu o cheie de acces, un cod primit prin e-mail, un link magic, un cont social sau o parolă.
  • Autorizare. Aplicația dvs. primește tokenuri care spun cine este persoana și ce a acceptat să partajeze, iar API-ul dvs. le poate verifica.

Piesele

PiesaCe este
Lobby-ulPagina de conectare găzduită. Numește întotdeauna aplicația spre care merge persoana.
Contul UsherCe are o persoană: adresa de e-mail, cheile de acces, factorii secundari și dispozitivele conectate.
Usher ConsoleLocul în care creați proiecte și medii, înregistrați aplicații și gestionați utilizatori.
SDK și componente@usher/nextjs, cu <SignIn /> și <UserButton />. Vin odată cu SDK-ul.

Cum se integrează în aplicația dvs.

Fiecare mediu pe care îl creați este un emitent OpenID Connect separat, cu propria adresă:

Emitent
https://<handle>.usherid.com

Aplicația dvs. trimite oamenii la acest emitent ca să se conecteze și îi primește înapoi cu un cod pe care îl schimbă pe tokenuri. Acesta este fluxul standard cu cod de autorizare și PKCE, iar fiecare pas al lui este descris de documentul de descoperire al emitentului:

Documentul de descoperire
https://<handle>.usherid.com/.well-known/openid-configuration

De unde să începeți