مقدمة
يُعد Usher مزوّد هوية: يسجّل دخول الأشخاص إلى تطبيقاتك، ويحافظ على أمان حساباتهم، ويُخبر تطبيقك بهويتهم. ويفعل كل ذلك عبر OpenID Connect و OAuth 2.1، لذا يعمل مع المكتبات التي تستخدمها بالفعل.
ما الذي يفعله Usher
يؤدي مُرشد القاعة (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