Bevezetés
Az Usher identitásszolgáltató: bejelentkezteti az embereket az appjaidba, biztonságban tartja a fiókjukat, és megmondja az appodnak, kik ők. Mindezt OpenID Connect és OAuth 2.1 alapon teszi, így működik a már használt könyvtáraiddal.
Mit csinál az Usher
Egy jegyszedőnek két dolga van az ajtóban. Ellenőrzi a jegyedet, és a helyedre kísér. Az Usher ugyanezt a két feladatot látja el az appodnak:
- Hitelesítés. Az emberek a Lobbyban, az Usher által hosztolt bejelentkezési oldalon igazolják, kik ők: jelkulccsal, e-mailben küldött kóddal, bejelentkezési linkkel, közösségi fiókkal vagy jelszóval.
- Engedélyezés. Az appod tokeneket kap, amelyek megmondják, ki az illető, és mit egyezett bele megosztani, az API-d pedig ellenőrizni tudja őket.
Az elemek
| Elem | Mi ez |
|---|---|
| A Lobby | A hosztolt bejelentkezési oldal. Mindig megnevezi az appot, ahová az illető tart. |
| Usher-fiók | Ami az embereknek van: az e-mail-címük, a jelkulcsaik, a második tényezőik és a bejelentkezett eszközeik. |
| Usher Console | Itt hozol létre projekteket és környezeteket, regisztrálsz alkalmazásokat és kezeled a felhasználókat. |
| SDK és komponensek | @usher/nextjs, a <SignIn /> és a <UserButton /> komponenssel. Az SDK-val érkezik. |
Hogyan illeszkedik az appodba
Minden létrehozott környezet önálló OpenID Connect-kibocsátó, saját címmel:
Kibocsátó
https://<handle>.usherid.comAz appod ehhez a kibocsátóhoz küldi az embereket bejelentkezni, és egy kóddal kapja vissza őket, amelyet tokenekre cserél. Ez a szabványos engedélyezési kódos folyamat PKCE-vel, és minden lépését leírja a kibocsátó felderítési dokumentuma:
Felderítési dokumentum
https://<handle>.usherid.com/.well-known/openid-configurationHol kezdj
Gyorsindítás: Next.jsBejelentkezés hozzáadása egy App Routert használó Next.js-apphoz.
Gyorsindítás: bármely OIDC-könyvtárA beállítások, amelyekre minden OpenID Connect-kliensnek szüksége van.
AlapfogalmakMunkaterületek, projektek, környezetek, kibocsátók és tokenek.
BiztonságHogyan különülnek el egymástól a környezetek, és hogyan pecsételjük le a titkokat.