Pengantar
Usher adalah penyedia identitas: Usher membantu orang masuk ke aplikasi Anda, menjaga akun mereka tetap aman, dan memberi tahu aplikasi Anda siapa mereka. Semua ini dilakukan dengan OpenID Connect dan OAuth 2.1, sehingga Usher bekerja dengan pustaka yang sudah Anda gunakan.
Apa yang dilakukan Usher
Seorang usher, penyambut tamu di pintu, punya dua tugas. Ia memeriksa tiket Anda, lalu mengantar Anda ke kursi. Usher melakukan dua tugas yang sama untuk aplikasi Anda:
- Autentikasi. Orang membuktikan siapa dirinya di Lobby, halaman masuk yang di-hosting Usher, dengan kunci sandi, kode lewat email, tautan ajaib, akun sosial, atau kata sandi.
- Otorisasi. Aplikasi Anda menerima token yang menyatakan siapa orang itu dan apa yang ia setujui untuk dibagikan, dan API Anda dapat memeriksanya.
Bagian-bagiannya
| Bagian | Apa itu |
|---|---|
| Lobby | Halaman masuk yang di-hosting. Lobby selalu menyebutkan aplikasi tujuan orang tersebut. |
| Akun Usher | Akun milik setiap orang: email, kunci sandi, faktor kedua, dan perangkat tempat mereka masuk. |
| Usher Console | Tempat Anda membuat proyek dan lingkungan, mendaftarkan aplikasi, dan mengelola pengguna. |
| SDK dan komponen | @usher/nextjs, dengan <SignIn /> dan <UserButton />. Hadir bersama SDK. |
Bagaimana Usher menyatu dengan aplikasi Anda
Setiap lingkungan yang Anda buat adalah penerbit (issuer) OpenID Connect tersendiri, dengan alamatnya sendiri:
https://<handle>.usherid.comAplikasi Anda mengarahkan orang ke penerbit itu untuk masuk, lalu menerima mereka kembali dengan kode yang ditukarnya dengan token. Itulah alur kode otorisasi standar dengan PKCE, dan setiap langkahnya dijelaskan dalam dokumen discovery milik penerbit:
https://<handle>.usherid.com/.well-known/openid-configuration