Johdanto

Usher on identiteetintarjoaja: se kirjaa ihmiset sisään sovelluksiisi, pitää heidän tilinsä turvassa ja kertoo sovelluksellesi, keitä he ovat. Se tekee kaiken tämän OpenID Connectilla ja OAuth 2.1:llä, joten se toimii kirjastojen kanssa, joita jo käytät.

Mitä Usher tekee

Teatterin paikannäyttäjä (englanniksi usher) tekee ovella kaksi asiaa: tarkistaa lippusi ja saattaa sinut paikallesi. Usher tekee samat kaksi asiaa sovelluksellesi:

Todennus. Ihmiset todistavat henkilöllisyytensä Lobbyssa (Usherin ylläpitämä kirjautumissivu) pääsyavaimella, sähköpostikoodilla, taikalinkillä, sometilillä tai salasanalla.
Valtuutus. Sovelluksesi saa tunnuksia, jotka kertovat, kuka ihminen on ja mitä hän suostui jakamaan, ja API:si voi tarkistaa ne.

Osat

Osa	Mikä se on
Lobby	Ylläpidetty kirjautumissivu. Se nimeää aina sovelluksen, johon ihminen on menossa.
Usher-tili	Se, mitä ihmisellä on: sähköpostiosoite, pääsyavaimet, toisen vaiheen menetelmät ja laitteet, joilla hän on kirjautuneena.
Usher Console	Täällä luot projekteja ja ympäristöjä, rekisteröit sovelluksia ja hallitset käyttäjiä.
SDK ja komponentit	`@usher/nextjs`, mukana `<SignIn />` ja `<UserButton />`. Tulossa SDK:n mukana.

Miten se sopii sovellukseesi

Jokainen luomasi ympäristö on oma OpenID Connect -myöntäjänsä omassa osoitteessaan:

Myöntäjä

https://<handle>.usherid.com

Sovelluksesi lähettää ihmiset tälle myöntäjälle kirjautumaan ja saa heidät takaisin koodin kanssa, jonka se vaihtaa tunnuksiin. Tämä on standardi valtuutuskoodikulku PKCE:llä, ja myöntäjän discovery-dokumentti kuvaa sen jokaisen vaiheen:

Discovery-dokumentti

https://<handle>.usherid.com/.well-known/openid-configuration

Mistä aloittaa

Pika-aloitus: Next.jsLisää kirjautuminen App Routeria käyttävään Next.js-sovellukseen. Pika-aloitus: mikä tahansa OIDC-kirjastoAsetukset, joita jokainen OpenID Connect -asiakas tarvitsee. KäsitteetTyötilat, projektit, ympäristöt, myöntäjät ja tunnukset. TietoturvaMiten ympäristöt pidetään erillään ja miten salaisuudet sinetöidään.