Pengenalan
Usher ialah penyedia identiti: ia mendaftar masuk orang ke aplikasi anda, memastikan akaun mereka selamat, dan memberitahu aplikasi anda siapa mereka. Semua ini dilakukan dengan OpenID Connect dan OAuth 2.1, jadi ia berfungsi dengan pustaka yang sudah anda gunakan.
Apa yang dilakukan oleh Usher
Seorang pengiring (usher) melakukan dua tugas di pintu. Mereka menyemak tiket anda, dan mereka mengiringi anda ke tempat duduk. Usher melakukan dua tugas yang sama untuk aplikasi anda:
- Pengesahan. Orang membuktikan siapa mereka di Lobby, halaman daftar masuk yang dihoskan oleh Usher, dengan kunci laluan, kod melalui e-mel, pautan ajaib, akaun sosial atau kata laluan.
- Kebenaran. Aplikasi anda menerima token yang menyatakan siapa orang itu dan apa yang dipersetujuinya untuk dikongsi, dan API anda boleh menyemaknya.
Bahagian-bahagiannya
| Bahagian | Apakah ia |
|---|---|
| Lobby | Halaman daftar masuk yang dihoskan. Ia sentiasa menamakan aplikasi yang dituju oleh orang itu. |
| Akaun Usher | Apa yang dimiliki oleh seseorang: e-mel, kunci laluan, faktor kedua dan peranti yang didaftar masuk. |
| Usher Console | Tempat anda mencipta projek dan persekitaran, mendaftarkan aplikasi dan mengurus pengguna. |
| SDK dan komponen | @usher/nextjs, dengan <SignIn /> dan <UserButton />. Akan datang bersama SDK. |
Bagaimana ia sesuai dengan aplikasi anda
Setiap persekitaran yang anda cipta ialah pengeluar (issuer) OpenID Connect tersendiri, di alamatnya sendiri:
https://<handle>.usherid.comAplikasi anda menghantar orang ke pengeluar itu untuk daftar masuk, dan menerima mereka kembali dengan kod yang ditukarnya dengan token. Itulah aliran kod kebenaran standard dengan PKCE, dan setiap langkahnya diterangkan oleh dokumen penemuan pengeluar itu:
https://<handle>.usherid.com/.well-known/openid-configuration