परिचय
Usher एक आइडेंटिटी प्रोवाइडर है: यह लोगों को आपके ऐप में साइन इन कराता है, उनके खाते सुरक्षित रखता है, और आपके ऐप को बताता है कि वे कौन हैं। यह सब OpenID Connect और OAuth 2.1 से होता है, इसलिए यह उन्हीं लाइब्रेरी के साथ काम करता है जिन्हें आप पहले से इस्तेमाल करते हैं।
Usher क्या करता है
थिएटर के दरवाज़े पर खड़ा अशर (usher) दो काम करता है। वह आपका टिकट जाँचता है, और आपको आपकी सीट तक ले जाता है। Usher आपके ऐप के लिए यही दो काम करता है:
- ऑथेंटिकेशन। लोग Lobby में साबित करते हैं कि वे कौन हैं। 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कहाँ से शुरू करें
क्विकस्टार्ट: Next.jsApp Router वाले Next.js ऐप में साइन-इन जोड़ें।
क्विकस्टार्ट: कोई भी OIDC लाइब्रेरीवे सेटिंग्ज़ जो हर OpenID Connect क्लाइंट को चाहिए।
अवधारणाएँवर्कस्पेस, प्रोजेक्ट, एनवायरनमेंट, इश्यूअर और टोकन।
सुरक्षाएनवायरनमेंट एक-दूसरे से अलग कैसे रखे जाते हैं, और सीक्रेट कैसे सील किए जाते हैं।