Pereiti prie turinio
Dokumentacija · Prisijungimas jūsų puslapyje

Prisijungimas jūsų puslapyje

Dauguma programų siunčia žmones prisijungti į savo aplinkos Lobby. Jei verčiau norite juos palikti savo puslapyje, <SignIn /> iš @usher/react prijungia juos ten pat ir užbaigia su OpenID Connect lygiai taip pat, kaip anksčiau: jūsų serveris vis tiek gauna žetonus iš Usher, o per jūsų puslapį nepraeina joks slaptažodis ar žetonas.

Leiskite savo programos kilmę

Usher Console atidarykite aplinką, tada Prisijungimas → Įterptas prisijungimas, ir pridėkite savo programos kilmę, pavyzdžiui, https://app.example.com. Tik nurodytos kilmės gali naudoti aplinkos Frontend API ir tik prisijungimui.

Pridėkite komponentą

TSX
import { SignIn } from '@usher/react'

export function SignInPage() {
  return <SignIn frontendApi="https://login.example.com" returnTo="/dashboard" />
}

Jis įdedamas į UsherProvider, kurį jau naudoja @usher/nextjs. frontendApi – tai jūsų aplinkos išdavėjas.

Kas vyksta

  • Pirmiausia el. paštas, tada slaptažodis arba el. paštu atsiųstas kodas, tada antrasis žingsnis, jei žmogus jį turi. Prisijungimas per socialinius tinklus ir „Tęsti su Usher“ nukreipia pas teikėją ir grąžina į jūsų programą.
  • Tada OpenID Connect. Prisijungęs jūsų aplinkoje, komponentas nusiunčia naršyklę į jūsų programos /auth/sign-in, kuris iškart pereina per Usher ir grįžta su kodu. Pirmą kartą Usher paprašo žmogaus leisti jūsų programai.
  • Apsauga nuo botų veikia kaip Lobby: kai Usher paprašo darbo įrodymo (proof of work), komponentas jį atlieka.
  • Visa kita (slaptaraktai, įmonių prisijungimas, paskyros kūrimas) yra nuoroda į jūsų Lobby.

Produkcinėje aplinkoje naudokite savo domeną

Komponentas laiko Usher sesiją jūsų aplinkos slapukuose. Produkcinėje aplinkoje jie turi būti pirmosios šalies: suteikite aplinkai savo domeną toje pačioje svetainėje kaip jūsų programa (login.example.com programai app.example.com). Kūrimo aplinkoje aplinka, leidžianti įterpimą, siunčia savo slapukus tarp svetainių, ir Chrome juos priima. Kai naršyklė jų nesaugo, komponentas perduoda darbą jūsų Lobby.