Кіріспе
Usher — сәйкестендіру провайдері: ол адамдарды қолданбаларыңызға кіргізеді, олардың аккаунттарын қорғайды және қолданбаңызға олардың кім екенін айтады. Мұның бәрін OpenID Connect пен OAuth 2.1 арқылы жасайды, сондықтан өзіңіз қолданып жүрген кітапханалармен жұмыс істейді.
Usher не істейді
Ағылшынша «usher» — театрда есік алдында екі жұмыс атқаратын қызметкер: ол билетіңізді тексеріп, сізді орныңызға дейін шығарып салады. Usher қолданбаңыз үшін дәл осы екі жұмысты атқарады:
- Аутентификация. Адамдар өздерінің кім екенін Usher орналастырған кіру беті Lobby-де дәлелдейді: кіру кілтімен, электрондық поштаға келген кодпен, сиқырлы сілтемемен, әлеуметтік желі аккаунтымен немесе құпиясөзбен.
- Авторизация. Қолданбаңыз адамның кім екенін және ол нені бөлісуге келіскенін айтатын токендер алады, ал API-ыңыз оларды тексере алады.
Құрамдас бөліктер
| Бөлік | Бұл не |
|---|---|
| Lobby | Орналастырылған кіру беті. Ол адамның бара жатқан қолданбасын әрқашан атайды. |
| Usher аккаунты | Адамның өзінде бары: электрондық поштасы, кіру кілттері, екінші факторлары және кірілген құрылғылары. |
| Usher Console | Мұнда жобалар мен орталар жасайсыз, қолданбаларды тіркейсіз және пайдаланушыларды басқарасыз. |
| SDK және компоненттер | <SignIn /> және <UserButton /> бар @usher/nextjs. SDK-мен бірге шығады. |
Ол қолданбаңызға қалай енеді
Сіз жасаған әр орта — өз мекенжайы бар жеке OpenID Connect эмитенті:
Эмитент
https://<handle>.usherid.comҚолданбаңыз адамдарды кіру үшін сол эмитентке жібереді де, оларды токендерге айырбасталатын кодпен қайта алады. Бұл — PKCE бар стандартты авторизация коды ағыны, оның әр қадамы эмитенттің discovery құжатында сипатталған:
Discovery құжаты
https://<handle>.usherid.com/.well-known/openid-configurationНеден бастау керек
Жылдам бастау: Next.jsApp Router бар Next.js қолданбасына кіруді қосыңыз.
Жылдам бастау: кез келген OIDC кітапханасыӘр OpenID Connect клиентіне қажет параметрлер.
Негізгі ұғымдарЖұмыс кеңістіктері, жобалар, орталар, эмитенттер және токендер.
ҚауіпсіздікОрталар бір-бірінен қалай бөлек ұсталады және құпиялар қалай мөрленеді.