מבוא
Usher הוא ספק זהויות: הוא מחבר אנשים לאפליקציות שלך, שומר על החשבונות שלהם, ואומר לאפליקציה שלך מי הם. הוא עושה את כל זה עם OpenID Connect ו-OAuth 2.1, כך שהוא עובד עם הספריות שכבר משמשות אותך.
מה Usher עושה
לסדרן בכניסה יש שני תפקידים. הוא בודק את הכרטיס, ומוביל אותך למושב. Usher עושה את אותם שני תפקידים עבור האפליקציה שלך:
- אימות. אנשים מוכיחים מי הם ב-Lobby, דף ההתחברות ש-Usher מארח, עם מפתח גישה, קוד בדוא״ל, קישור קסם, חשבון ברשת חברתית או סיסמה.
- הרשאה. האפליקציה שלך מקבלת אסימונים שאומרים מי האדם ומה הוא הסכים לשתף, וה-API שלך יכול לבדוק אותם.
החלקים
| חלק | מה זה |
|---|---|
| ה-Lobby | דף ההתחברות המתארח. הוא תמיד מציין את האפליקציה שאליה האדם ממשיך. |
| חשבון Usher | מה שיש לאדם: כתובת הדוא״ל, מפתחות הגישה, הגורמים השניים והמכשירים המחוברים שלו. |
| Usher Console | המקום שבו יוצרים פרויקטים וסביבות, רושמים אפליקציות ומנהלים משתמשים. |
| SDK ורכיבים | @usher/nextjs, עם <SignIn /> ו-<UserButton />. יגיע עם ה-SDK. |
איך הוא משתלב באפליקציה שלך
כל סביבה שיוצרים היא מנפיק OpenID Connect בפני עצמו, בכתובת משלה:
מנפיק
https://<handle>.usherid.comהאפליקציה שלך שולחת אנשים למנפיק הזה כדי להתחבר, ומקבלת אותם בחזרה עם קוד שהיא מחליפה באסימונים. זו זרימת קוד ההרשאה הסטנדרטית עם PKCE, וכל שלב בה מתואר במסמך הגילוי של המנפיק:
מסמך הגילוי
https://<handle>.usherid.com/.well-known/openid-configuration