Įvadas
Usher yra tapatybės teikėjas: jis prijungia žmones prie jūsų programų, saugo jų paskyras ir praneša jūsų programai, kas jie yra. Visa tai jis daro pagal OpenID Connect ir OAuth 2.1, todėl veikia su bibliotekomis, kurias jau naudojate.
Ką daro Usher
Angliškai „usher“ – tai teatro tarnautojas, kuris prie durų atlieka du darbus: patikrina jūsų bilietą ir palydi jus iki vietos. Usher atlieka tuos pačius du darbus jūsų programai:
- Autentifikavimas. Žmonės įrodo, kas jie yra, Lobby – Usher talpinamame prisijungimo puslapyje – slaptaraktiu, el. paštu atsiųstu kodu, magiškąja nuoroda, socialinio tinklo paskyra arba slaptažodžiu.
- Autorizacija. Jūsų programa gauna žetonus, nurodančius, kas yra žmogus ir kuo jis sutiko dalytis, o jūsų API gali juos patikrinti.
Sudedamosios dalys
| Dalis | Kas tai |
|---|---|
| Lobby | Talpinamas prisijungimo puslapis. Jis visada nurodo programą, į kurią žmogus keliauja. |
| Usher paskyra | Tai, ką turi žmogus: el. pašto adresas, slaptaraktai, antrieji veiksniai ir prisijungę įrenginiai. |
| Usher Console | Čia kuriate projektus ir aplinkas, registruojate programas ir tvarkote naudotojus. |
| SDK ir komponentai | @usher/nextjs su <SignIn /> ir <UserButton />. Pasirodys kartu su SDK. |
Kaip jis įsilieja į jūsų programą
Kiekviena jūsų sukurta aplinka yra atskiras OpenID Connect išdavėjas su savo adresu:
Išdavėjas
https://<handle>.usherid.comJūsų programa siunčia žmones prisijungti pas tą išdavėją ir gauna juos atgal su kodu, kurį iškeičia į žetonus. Tai standartinis autorizacijos kodo srautas su PKCE, o kiekvienas jo žingsnis aprašytas išdavėjo aptikimo dokumente:
Aptikimo dokumentas
https://<handle>.usherid.com/.well-known/openid-configurationNuo ko pradėti
Greita pradžia: Next.jsPridėkite prisijungimą prie Next.js programos su App Router.
Greita pradžia: bet kuri OIDC bibliotekaNustatymai, kurių reikia kiekvienam OpenID Connect klientui.
SąvokosDarbo sritys, projektai, aplinkos, išdavėjai ir žetonai.
SaugaKaip aplinkos atskiriamos viena nuo kitos ir kaip užsandarinamos paslaptys.