Úvod
Usher je poskytovatel identity: přihlašuje lidi do vašich aplikací, chrání jejich účty a říká vaší aplikaci, kdo jsou. To všechno dělá přes OpenID Connect a OAuth 2.1, takže funguje s knihovnami, které už používáte.
Co Usher dělá
Uvaděč u dveří má dvě práce. Zkontroluje vám vstupenku a uvede vás na vaše místo. Usher dělá pro vaši aplikaci stejné dvě věci:
- Ověření (autentizace). Lidé v Lobby, hostované přihlašovací stránce služby Usher, prokážou, kdo jsou: přístupovým klíčem, kódem zaslaným e-mailem, magickým odkazem, účtem sociální sítě nebo heslem.
- Autorizace. Vaše aplikace dostane tokeny, které říkají, kdo daný člověk je a co souhlasil sdílet, a vaše API je může zkontrolovat.
Jednotlivé části
| Část | Co to je |
|---|---|
| Lobby | Hostovaná přihlašovací stránka. Vždy uvede aplikaci, do které člověk míří. |
| Účet Usher | To, co má člověk: jeho e-mail, přístupové klíče, druhé faktory a přihlášená zařízení. |
| Usher Console | Tady vytváříte projekty a prostředí, registrujete aplikace a spravujete uživatele. |
| Sada SDK a komponenty | @usher/nextjs s <SignIn /> a <UserButton />. Přijde se sadou SDK. |
Jak zapadá do vaší aplikace
Každé prostředí, které vytvoříte, je samostatný vydavatel OpenID Connect s vlastní adresou:
Vydavatel
https://<handle>.usherid.comVaše aplikace posílá lidi k tomuto vydavateli, aby se přihlásili, a dostane je zpátky s kódem, který vymění za tokeny. To je standardní tok autorizačního kódu s PKCE a každý jeho krok popisuje dokument discovery vydavatele:
Dokument discovery
https://<handle>.usherid.com/.well-known/openid-configurationKde začít
Rychlý start: Next.jsPřidejte přihlášení do aplikace Next.js, která používá App Router.
Rychlý start: jakákoli knihovna OIDCNastavení, která potřebuje každý klient OpenID Connect.
Základní pojmyPracovní prostory, projekty, prostředí, vydavatelé a tokeny.
ZabezpečeníJak jsou prostředí od sebe oddělená a jak se pečetí tajné údaje.