Isomo rigufi · Kinyarwanda

Uko wakwemerera abantu kwinjira muri konti ku rubuga rwawe

Huza urupapuro rwo kwinjira rwiteguye na serivisi icunga konti, ugerageze kode zo muri email, gusohoka n'amagerageza yanze.

Tangira isomo rikorwamo imyitozoSoma inyandiko z’isomo

Ibi bigenewe nde?

Abashaka uburyo bwo kwinjira muri konti ku rubuga ruto. Serivisi ibicunga na porogaramu yatanzwe bikora ishyirwa mu bikorwa; ushobora gukorana n'umufasha wo kwandika kode utanditse kode yo kwemeza umwirondoro.

Mbere yo gutangira

Umushinga wawe wa Supabase w'umwitozo n'agasanduku k'igerageza kemewe cyangwa umwohereza washyizweho. Koresha urupapuro watanzwe kuri HTTP yo kuri mudasobwa cyangwa kuri serivisi yawe ya HTTPS. Umufasha wo kwandika kode ashobora kukuyobora mu gutegura no gushyiraho kode za email.

Igihe kigereranyijwe: 20–32 min

Igihe kigereranyijwe ukoresheje dosiye zo gutangiriraho zatanzwe, konti n’ibikoresho bikenewe byamaze gutegurwa. Gutegura, gutegereza gushyira urubuga kuri interineti, imeli cyangwa DNS bishobora gufata ikindi gihe. Gutegura konti no gutegereza imeli bishobora kongera igihe. Imbogamizi za serivisi n'igihe session imara bigomba kugenzurwa muri konti ikoreshejwe mu mwitozo.

Ibyo uziga

  • Saba ukoreshe kode nyayo yo kwinjira.
  • Emeza uko ibintu bihagaze winjiye muri konti n'igihe wasohotse.
  • Kode zitari zo n'ubutumwa bwabuze bikomeze kugaragazwa mu kuri nk'ibyananiranye.

Dosiye z'imyitozo

Intambwe 1

Sobanukirwa inzira yo kwinjira muri konti

Kwakira kode no kuba winjiye muri konti ni ibihe bitandukanye.

Koresha urupapuro rwiteguye uri kumwe n'umufasha. Umuntu yinjiza aderesi, akakira kode akayohereza mbere y'uko serivisi imwinjiza muri konti.

Urupapuro ruvuga ngo «Reba mu gasanduku kawe» ruvuga ko ubusabe bwatanzwe, si uko umushyitsi yemejwe.

Urugero rufatika

Aderesi ya email yonyine si gihamya ko nyirayo yarangije kwinjira muri konti.

Koresha porogaramu ya Supabase yo kwinjira watanzwe. Nyobora mu gushyiraho kode za email muri serivisi nkoresheje agasanduku kanjye k'igerageza kemewe, shyira gusa indangagaciro z'umushinga zemewe gutangazwa mu igenamiterere rusange kandi ukoreshe urupapuro kuri HTTP. Mfasha kugerageza gusaba kode, kuyinjiza, kongera gupakira no gusohoka. Kode itemewe cyangwa email ibuze ntibigomba guhinduka kwinjira kw'impimbano.

Supabase: kode z'imeli zo kwinjira · Supabase: ubwoko bw'imfunguzo za API

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Ongeramo session nyayo yo kwinjira

Kwemeza umwirondoro bigenzura uwo umuntu ari we; kwerekana aderesi y'imeli ntibihagije.

Tuzakoresha Supabase Auth twohereze kode y'imeli ikoreshwa rimwe kandi dutangize session nyuma yo kuyemeza. SDK ya mushakisha icunga kubika session no kuyivugurura; ntidukora ububiko bw'amagambo y'ibanga.

Icyifuzo cyakiriwe na endpoint y'imeli ntikivuga ko ukoresha yinjiye. Session iboneka nyuma gusa y'intambwe yo kwemeza yemewe. Uburenganzira ku makuru y'ibanga ni irindi genzura rizakurikiraho.

Urugero rusobanuye

Kwandika imeli y'undi mu mwanya ntibigomba kuguha uburenganzira bwe. Kode yoherezwa mu gasanduku k'imeli ni yo ntambwe yo kwemeza.

Supabase: kode z'imeli zo kwinjira · Supabase: ubwoko bw'imfunguzo za API

Extra implementation exercise

Urupapuro rwakiriye aderesi y'imeli kandi ruvuga «Check your inbox», bisaba kureba mu gasanduku k'imeli. Umwirondoro w'usura wamaze kwemezwa?

Erekana igisubizo gisobanuye

Oya. Icyifuzo cyo kwinjira cyatangiye. Emeza kode kandi usuzume session ivuyemo mbere yo kwerekana ko yinjiye.

  • Gutandukanya igihe kode yasabwe ariko itaremezwa n'igihe yemejwe hakaboneka session.
  • Hasabwa kwemeza kwagenze neza na session.

Intambwe 2

Tegura serivisi n'urupapuro

Hitamo inzira ya kode ifishi watanzwe iteganya.

Mbere yo kugerageza, saba umufasha kugenzura ibisabwa bine: umushinga wa Supabase w’umwitozo ugamijwe, agasanduku kemererwa n’igenamiterere ry’uwohereza, icyitegererezo cy’imeri kirimo kode yo kwinjira n’urupapuro watanzwe rukorera kuri HTTP. Icyitegererezo kigomba guhuza n’iyi fomu yo kwandika kode, aho kugira ihuriro rya magic link gusa.

URL y’umushinga n’urufunguzo rwo gutangaza gusa ni byo bijya muri public/config.js. Imfunguzo z’ibanga cyangwa service-role ntizijye muri dosiye za mushakisha. Aya magenzura ya serivisi n’iya porogaramu ikora arasabwa; gusoma cyangwa kongera kwandika uburyo bwo kwemeza umwirondoro ni ubushake.

Urugero rufatika

Ihuza rya email rikora rishobora kuba inzira itari yo ku rupapuro rugusaba kwandika kode.

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Tegura serivisi na client ya mushakisha

Template y'imeli n'ubwoko bw'urufunguzo bigomba guhura n'inzira ya kode yatanzwe.

Mu mushinga wihariye wa Supabase, fungura Email authentication. Reba niba uwohereza ashobora kugeza ubutumwa mu gasanduku kawe ko kugerageza; tegura SMTP ishyigikiwe igihe bikenewe. Muri template y'imeli ya Magic Link, shyiramo {{ .Token }} kugira ngo ubutumwa butange kode uru rupapuro rwiteze.

Shyira URL y'umushinga n'urufunguzo rwemerewe gutangazwa muri config.js. Urwo rufunguzo ruranga porogaramu; si session y'ukoresha cyangwa ibanga ry'umuyobozi. Ntuzigere ushyira urufunguzo rwa secret/service-role muri iyi dosiye ya mushakisha. Tanga public/ kuri HTTP/HTTPS kugira ngo module imports zikore.

Urupapuro rwiteze kode y'imeli yandikwa (OTP). Muri template y'imeli ya serivisi, {{ .Token }} yerekana iyo kode; template irimo gusa variable y'umurongo wo kwemeza ntizatanga kode iyi UI isaba. Koresha ubuyobozi bugezweho bw'imeli idasaba ijambo ry'ibanga kugira ngo ubone template aho gukeka izina ry'igenamiterere.

Ubuyobozi bwemewe bwa Supabase bwitwa «With OTP» busobanura neza ko kode z'imeli zisangira uburyo bwa Magic Link: hindura template y'imeli ya Magic Link uyishyiremo {{ .Token }}. Iryo zina ntirivuga ko uru rupapuro rugomba kwakira ubutumwa burimo umurongo gusa. Kurikiza ubwo buyobozi niba amazina yo muri dashboard atandukanye; ntuhimbe igenamiterere rya template ridafitanye isano.

Urugero rusobanuye

Uburyo bwa SDK bwitwa signInWithOtp, ariko imeli ishobora kugira umurongo cyangwa kode bitewe na template. Imigaragarire yacu yiteze uburyo bwa kode.

Extra implementation exercise

Urupapuro rwawe rusaba kode, ariko imeli irimo magic link gusa. Ni iki ugomba kugenzura?

Erekana igisubizo gisobanuye

Suzuma template yagenwe urebe agaciro ka Token kandi usubiremo icyifuzo umaze kuyihuza n'imigaragarire isaba kode. Kurikiza inyandiko zigezweho za serivisi ku mushinga wawe.

  • Hasuzumwa template y'imeli n'inzira yari igamijwe.
  • Nta kode ihimbwa cyangwa kwemeza ko ubutumwa bwagenzuwe bitabaye.

Intambwe 3

Uzuza kwinjira nyako kumwe muri konti

Koresha ubutumwa bwa email aho gukoresha kode wihimbiye.

Tangira utinjiye muri konti mu idirishya rishya ry’ibanga. Saba kode y’agasanduku ugenzura ubanze wandike itari yo nkana. Emeza ko igerageza rikomeza kwangwa kandi urupapuro ruvuga ko nta konti yinjiyemo. Hanyuma saba kode nshya, wandike iyaje koko muri imeri, urebe konti yagaragajwe.

Kode yanze ntigomba gutangiza kwinjira. Niba utangiye usanzwe winjiyemo, kode itari yo ishobora gusiga session isanzwe ihari; ni ikindi kibazo kandi ntikigenzura gukumira session nshya. Niba imeri itageze, andika icyo cyiciro nyirizina cyahagaze.

Urugero rufatika

Ikimenyetso cyiza cyo gutsinda nyuma ya kode yanze cyaba kibeshya uko konti ihagaze.

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Saba kandi wemeze kode

Buri buto ihuye n'ihinduka ritandukanye ry'imimerere.

Soma public/app.js. Igikorwa cya mbere gihamagara signInWithOtp gifite imeli yinjijwe; icya kabiri gihamagara verifyOtp gifite iyo meli na token yakiriwe. Igisubizo cyagenze neza kirimo session.

Koresha agasanduku kawe k'imeli kandi ukoporore kode igezweho neza uko iri. Kode itari yo, yarangije igihe cyangwa yamaze gukoreshwa igomba gusiga ukoresha atarinjira. Ntukandike kode cyangwa access tokens muri raporo isangiwe.

Urugero rusobanuye

UI ikoresha textContent ku nyandiko y'imimerere n'iya konti. Ntifata aderesi y'imeli nka HTML.

const {data,error}=await client.auth.verifyOtp({email,token,type:'email'});
if(error || !data.session) { /* keep the unverified state */ }

Extra implementation exercise

Kode itari yo isubiza ikosa, ariko porogaramu yawe ikerekana «Signed in», bivuga ko winjiye, uko byagenda kose. Ni iyihe mimerere igomba guhinduka?

Erekana igisubizo gisobanuye

Erekana ko yinjiye gusa igihe kwemeza kwagenze neza kandi session ihari. Ntukoreshe gukanda buto ubwabyo nk'ikimenyetso.

  • Hasuzumwa ikosa na session byasubijwe.
  • Kunanirwa bigumishwa bitandukanye no kwemeza umwirondoro byagenze neza.

Intambwe 4

Genzura kongera gupakira no gusohoka

Menya ko uko bigaragara bihuye n'igihe nyacyo cyo kwinjira.

Ongera upakire nyuma yo kwinjira kwatsinze urebe konti yerekanwa. Hanyuma ukoreshe Sign out wongere urebe umwirondoro. Mu kugenzura session yigenga, koresha browser profile yihariye cyangwa ufunge amadirishya y’ibanga yose mbere yo gufungura irishya: amadirishya y’ibanga yongeweho ashobora gusangira session y’ibanga isanzwe.

Umushinga w’ibanze werekana uko konti ihagaze; nta nyandiko irinzwe urimo yo kugerageza. Nushyiramo ibirimo by’ibanga nyuma, seriveri igomba kwemeza uburenganzira mbere yo kubitanga. Buto ihishwe yonyine ntishobora kurinda ibyo.

Urugero rufatika

Urupapuro rwasohotse muri konti ntirugomba gukomeza gukora nk'urwa konti yabanje kubera gusa ko ikimenyetso kikiriho.

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Genzura kugumaho kwa session no gusohoka

Gerageza ibirenze kode ya mbere yagenze neza.

Umaze kwinjira ongera ufungure urupapuro usuzume imimerere ya konti. Hanyuma usohoke wongere ufungure na none. Koresha idirishya ry'ibanga kugira ngo wemeze ko indi mushakisha idahita iragwa session.

Gusohoka bikuraho session y'iyi client; ntibivuga ko buri access token yakoporowe ahantu hose ihita ihagarara gukora. Igihe access token imara n'uko ikurwaho bigira akamaro mu kubaka endpoints za seriveri zirinzwe.

Urugero rusobanuye

UI yo hanze ya konti ntigomba kugumana iyerekanwa rya konti y'ibanga cyangwa guhita yomeka token ishaje ku cyifuzo gishya. Endpoints z'ibanga ziracyakeneye igenzura rya seriveri.

Extra implementation exercise

Guhisha buto ya Sign in, yo kwinjira, byaba bihagije kurinda inyandiko y'ibanga?

Erekana igisubizo gisobanuye

Oya. Seriveri igomba kugenzura usaba mbere yo gusubiza ibirimo birinzwe. Isomo rikurikira rya private-page rishyira uwo mupaka mu bikorwa.

  • Imimerere ya UI itandukanywa n'uburenganzira butangwa na seriveri.
  • Hasabwa igenzura ry'uburenganzira ku cyifuzo cy'inyandiko.

Intambwe 5

Andika inzira yose ya konti

Soza ufite ibyo wiboneye bishobora gusubirwamo, aho kuba ifoto y'intsinzi gusa.

Subiramo inzira ya aderesi, email na kode nyuma yo gukosora. Bika inyandiko yakuwemo amakuru y'ibanga yo kwinjira, kongera gupakira, gusohoka n'igerageza rimwe ry'ingenzi ryananiranye.

Niba amategeko y'umwohereza cyangwa imipaka ya konti bibujije igerageza, vuga icyo cyiciro neza. Ntugasimbuze kode nyayo yageze urugero rw'impimbano rwo kuri mudasobwa.

Urugero rufatika

Raporo ifasha itandukanya email itageze, kode itari yo n'iyemezwa ryatsinze.

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Umukoro wawe: genzura urugendo rwose rwa konti

Andika uko bigenda igihe kode yasabwe ariko itaremezwa, igihe igerageza ryananiranye, igihe ukoresha yinjiye n'igihe yasohotse.

Gerageza kode itari yo mbere yo kurangiza kwinjira kwemewe. Suzuma uko bigenda iyo wongeye gufungura, gusohoka n'idirishya ry'ibanga. Koresha gusa udusanduku tw'imeli ugenzura.

Nonosora ubutumwa bumwe budasobanutse udahinduye ukuri kwabwo: kode yasabwe iracyategereje, kandi ikosa si session yagenze neza.

Urugero rusobanuye

Raporo igomba kugaragaza imimerere yabonetse itagaragaje kode yakiriwe, bearer token cyangwa amakuru y'umwirondoro y'ibanga.

Ubuyobozi bwuzuye bw'urugero buri muri reference/assignment-walkthrough.txt. Gereranya intambwe zabwo n'ibyo wakoze; uzuza inyandiko y'igerageza ukurikije ibyo wabonye mu mushinga wawe.

Extra implementation exercise

Rangiza urugendo rwa konti kandi usobanure icyo buri mimerere wabonye yemeza.

Erekana igisubizo gisobanuye

Tegura URL y'umushinga n'urufunguzo rwemerewe gutangazwa, hanyuma template irimo {{ .Token }} kugira ngo ubutumwa burimo kode uru rupapuro rwiteze. Saba kode ijye mu gasanduku kawe k'imeli. Imeli yasabwe si session yemejwe.

Injiza kode itari yo kandi wemeze ko nta session y'ukoresha ikorwa. Koresha kode nshya yemewe, ugenzure umwirondoro ugaragazwa, wongere ufungure kandi witegereze session. Sohoka kandi wemeze ko tab itakivuga ko hari session.

Subiramo mu idirishya ry'ibanga: ntirigomba kuragwa imimerere yo kwinjira y'idirishya rya mbere. Guhisha buto ntaho bihuriye no kurinda inyandiko; seriveri igomba kugenzura uburenganzira mbere yo gusubiza ibirimo by'ibanga.

  • Imimerere ya kode itari yo no kuba wasohotse iguma itaremeje umwirondoro.
  • Session yemewe igumaho nk'uko yagenwe, kandi gusohoka kwa client kugenzurwa mu kuri.

Iri somo ryagufashije?

Kanda ko urikunze, cyangwa urisangize uwo ryafasha.

Komeza kwiga

Reba andi masomo