
Somo fupi 11 kati ya 30 · Akaunti na ufikiaji
Elewa njia ya kuingia kwenye akaunti
Somo hili ni la nani?
Kwa watu wanaotaka kuingia kwenye akaunti kwenye tovuti ndogo. Huduma inayosimamiwa na programu iliyotolewa hushughulikia utekelezaji; unaweza kufanya kazi na msaidizi wa programu bila kuandika msimbo wa uthibitishaji.
Kupokea msimbo na kuwa umeingia kwenye akaunti ni nyakati tofauti.
Utakachojifunza katika somo hili
- Omba na utumie msimbo halisi wa kuingia kwenye akaunti.
- Hakiki hali za kuwa umeingia na umetoka kwenye akaunti.
- Hifadhi misimbo isiyo sahihi na ujumbe uliokosekana kama hitilafu za kweli.
Maelezo, mfano uliotatuliwa na zoezi
Kabla ya kuanza
Mradi wako wa Supabase wa mazoezi na kisanduku cha majaribio kinachoruhusiwa au mtumaji aliyesanidiwa. Tumia ukurasa uliotolewa kwa HTTP ya ndani ya kifaa au upangishaji wako wa HTTPS. Msaidizi wa programu anaweza kuongoza usanidi na kusanidi misimbo ya barua pepe.
Angalia ujuzi wa kuanzia
Huu ni ujuzi muhimu, si sharti la kumaliza kozi zilizofungwa. Ukiujua, anza hapa; la sivyo fungua maandalizi. Faili za kuanzia zimetolewa, kwa hiyo huhitaji tovuti yako ya awali.
- Jinsi ya kuchapisha tovuti yako kutoka GitHub
Unganisha hifadhi ya mazoezi na huduma ya upangishaji.
Muda unaokadiriwa: 20–32 dakika
Makadirio yanatumia faili za kuanzia zilizotolewa, huku akaunti na zana zinazohitajika zikiwa tayari. Usanidi, foleni za uchapishaji na kusubiri barua pepe au DNS huhitaji muda zaidi. Kufika kwa barua na usanidi wa akaunti vinaweza kuongeza kusubiri. Vizuizi vya mtoa huduma na muda wa vipindi lazima vikaguliwe kwenye akaunti ya zoezi.
Elewa wazo
Tumia ukurasa ulio tayari na msaidizi wako. Mtu anaingiza anwani, anapokea msimbo na anauwasilisha kabla ya huduma kuanzisha kipindi cha akaunti.
Ukurasa ukisema “Kagua kisanduku chako pokezi” unamaanisha ombi limefanywa, si kwamba mgeni amethibitishwa.
Mfano halisi
Anwani ya barua pepe pekee si ushahidi kwamba mwenyewe amekamilisha kuingia kwenye akaunti.
Tumia programu ya Supabase ya kuingia iliyotolewa. Niongoze kwenye usanidi wa misimbo ya barua pepe kwa mtoa huduma kwa kisanduku changu kinachoruhusiwa, weka thamani za mradi zinazochapishika pekee kwenye usanidi wa umma na uendeshe ukurasa kwa HTTP. Nisaidie kujaribu kuomba msimbo, kuuingiza, kupakia upya na kutoka. Msimbo usio halali au barua pepe iliyokosekana visigeuke kuwa hali ya kujifanya umeingia.Faili za hatua hii
Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.
Jaribu mwenyewe
Utakagua hali zipi zinazoonekana kati ya kuingiza anwani na kuingia kweli kwenye akaunti?
Onyesha mfano wa suluhisho
Jibu la mfano: “Baada ya Send sign-in code, natarajia ujumbe wa kukubaliwa kwa ombi. Halafu nipate barua. Baada ya Verify code kufaulu ndipo ukurasa utambue akaunti yangu.”
“Check your inbox” ni ujumbe wa hatua ya kuomba. Hauthibitishi kuwa barua imefika au kikao kipo.
Mambo yanayopaswa kuwamo katika jibu sahihi
- Anatofautisha kuomba ujumbe, kupokea msimbo wake na kuthibitisha kuingia akaunti.
- Anatambua kuonyeshwa kwa akaunti iliyothibitishwa kama ushahidi wa kikao, si kuingiza anwani pekee.
Jinsi inavyofanya kazi (si lazima)
Ongeza kipindi halisi cha kuingia
Uthibitishaji huhakikisha utambulisho; kuonyesha anwani ya barua pekee hakutoshi.
Tutatumia Supabase Auth kutuma msimbo wa mara moja kwa barua na kuanzisha kipindi cha kuingia baada ya kuuthibitisha. SDK ya kivinjari husimamia kuhifadhi na kusasisha kipindi; hatutengenezi hifadhidata ya nywila.
Ombi linalokubaliwa na endpoint ya barua halimaanishi mtumiaji ameingia. Kipindi huanza baada tu ya hatua sahihi ya uthibitishaji. Ruhusa ya data ya siri ni ukaguzi mwingine unaokuja baadaye.
Mfano uliotatuliwa
Kuandika barua ya mtu mwingine kwenye sehemu ya fomu hakupaswi kutoa ufikiaji wake. Msimbo unaotumwa kwenye kisanduku ndio hatua ya uthibitishaji.
Supabase: misimbo ya kuingia kwa barua pepe · Supabase: aina za funguo za API
Zoezi la ziada la utekelezaji
Ukurasa umekubali anwani ya barua na unasema “Check your inbox”. Je, mgeni amethibitishwa tayari?
Onyesha mfano wa suluhisho
Hapana. Ombi la kuingia limeanza. Thibitisha msimbo na ukague kipindi kilichopatikana kabla ya kuonyesha kuwa mtu ameingia.
- Anatenganisha hali ya kuomba na hali iliyothibitishwa.
- Anahitaji uthibitishaji uliofaulu na kipindi cha kuingia.

Hatua 1 · Jinsi ya kuwaruhusu watu kuingia kwenye tovuti yako
Andaa mtoa huduma na ukurasa
Chagua mtiririko wa msimbo unaotarajiwa na fomu iliyotolewa.
Maelezo, mfano uliotatuliwa na zoezi
Elewa wazo
Kabla ya kupima, msaidizi akague vitu vinne vya lazima: mradi sahihi wa Supabase, sanduku linaloruhusiwa na mipangilio ya mtumaji, kiolezo cha barua chenye msimbo na ukurasa unaoendeshwa kwa HTTP. Kiolezo kilingane na fomu hii ya kuingiza msimbo, si kiungo cha kuingia pekee.
URL ya mradi na ufunguo wa kuchapishwa pekee vinawekwa public/config.js. Siri au funguo za service-role zisiwe kwenye kivinjari. Ukaguzi huu wa mtoa huduma na programu ni wa lazima; kusoma au kuandika upya uthibitishaji wa akaunti ni hiari.
Mfano halisi
Kiungo cha barua pepe kinachofanya kazi bado kinaweza kuwa njia isiyo sahihi kwa ukurasa unaokuomba kuandika msimbo.
Faili za hatua hii
Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.
Jaribu mwenyewe
Usanidi wa mtoa huduma na ujumbe uliopokelewa vililingana na fomu ya kuingiza msimbo?
Onyesha mfano wa suluhisho
Rekodi ya mfano: “Mradi sahihi umechaguliwa; kiolezo cha barua kina msimbo; public/config.js ina URL na ufunguo wa kuchapishwa tu; ukurasa unafunguka kwa HTTP ya ndani.”
Rekodi iliyokwama inaweza kusema: “Ukurasa unafunguka, lakini barua ina kiungo pekee. Jaribio la msimbo limesimama hadi msaidizi asaidie kurekebisha kiolezo.” Hakuna rekodi inayojumuisha ufunguo au msimbo unaoweza kutumika tena.
Mambo yanayopaswa kuwamo katika jibu sahihi
- Anataja mradi wa zoezi, kiolezo chenye msimbo na utayari wa mwonekano wa HTTP.
- Anatofautisha mipangilio ya umma na siri, akitaja hatua yoyote iliyokwama.
Jinsi inavyofanya kazi (si lazima)
Sanidi mtoa huduma na programu ya kivinjari
Kiolezo cha barua na aina ya ufunguo lazima vilingane na mtiririko wa msimbo uliotolewa.
Katika mradi tofauti wa Supabase, washa uthibitishaji wa Email. Kagua kama mtumaji wake anaweza kufikisha kwa kisanduku chako; sanidi SMTP inayoungwa mkono inapohitajika. Katika kiolezo cha Magic Link, ongeza {{ .Token }} ili ujumbe utoe msimbo unaotarajiwa na ukurasa huu.
Weka URL ya mradi na ufunguo wa publishable katika config.js. Ufunguo huo hutambua programu; si kipindi cha mtumiaji wala siri ya usimamizi. Usiweke kamwe ufunguo wa siri/service-role kwenye faili hili la kivinjari. Tumikia public/ kupitia HTTP/HTTPS ili uagizaji wa moduli ufanye kazi.
Ukurasa unatarajia msimbo wa barua unaoandikwa (OTP). Katika kiolezo cha mtoa huduma, {{ .Token }} huonyesha msimbo huo; kiolezo chenye kigezo cha kiungo cha uthibitisho pekee hakitatoa msimbo unaoombwa na kiolesura. Tumia mwongozo wa sasa wa barua bila nenosiri kupata kiolezo badala ya kukisia jina la mpangilio.
Mwongozo rasmi wa Supabase “With OTP” unaeleza wazi kuwa misimbo ya barua hutumia utekelezaji uleule wa Magic Link: badilisha kiolezo cha barua cha Magic Link kijumuishe {{ .Token }}. Jina halimaanishi ukurasa upokee ujumbe wa kiungo pekee. Fuata mwongozo huo lebo za dashibodi zikitofautiana; usibuni mpangilio mwingine wa kiolezo.
Mfano uliotatuliwa
Mbinu ya SDK inaitwa signInWithOtp, lakini barua inaweza kuwa na kiungo au msimbo kulingana na kiolezo. Kiolesura chetu kinatarajia toleo la msimbo.
Zoezi la ziada la utekelezaji
Ukurasa unaomba msimbo lakini barua ina magic link pekee. Ukague nini?
Onyesha mfano wa suluhisho
Kagua kiolezo kilichosanidiwa kwa thamani ya Token na urudie ombi baada ya kukilinganisha na kiolesura cha msimbo. Fuata nyaraka za sasa za mtoa huduma kwa mradi wako.
- Anakagua kiolezo cha barua na mtiririko unaokusudiwa.
- Habuni msimbo wala kudai ujumbe umethibitishwa.

Hatua 2 · Jinsi ya kuwaruhusu watu kuingia kwenye tovuti yako
Kamilisha kuingia halisi kwenye akaunti
Tumia ujumbe wa barua pepe badala ya msimbo uliobuniwa.
Maelezo, mfano uliotatuliwa na zoezi
Elewa wazo
Anza bila kuingia akaunti katika kikao kipya cha faragha. Omba msimbo kwa sanduku lako na uanze kwa kuingiza usio sahihi kwa makusudi. Hakiki unakataliwa na ukurasa bado unasema hakuna akaunti iliyoingia. Omba msimbo mpya, tumia halisi uliopokea na ukague akaunti iliyotambuliwa.
Msimbo uliokataliwa usiunde kikao. Ukianza ukiwa umeingia tayari, msimbo batili unaweza kuacha kikao kile cha zamani; hiyo ni hali tofauti, haijaribu kuzuia kikao kipya. Barua isipofika, andika hatua hiyo kamili iliyokwama.
Mfano halisi
Alama nzuri ya mafanikio baada ya msimbo uliokataliwa ingepotosha hali ya akaunti.
Faili za hatua hii
Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.
Jaribu mwenyewe
Katika kikao kipya bila kuingia, nini kilitokea kwa msimbo batili na kisha msimbo mpya halisi wa barua?
Onyesha mfano wa suluhisho
Rekodi ya mfano: “Katika kikao kipya cha faragha, msimbo batili ulionyesha Code was not accepted na ukurasa ukaendelea kusema No signed-in account. Kisha niliomba msimbo mpya, nikathibitisha na kuona akaunti yangu ya jaribio ikitambuliwa.”
Barua isipofika kabisa, rekodi halali ni “Ombi limekubaliwa; hakuna msimbo katika sanduku linaloruhusiwa au spam; uthibitisho uliofaulu haujajaribiwa.” Kupima msimbo batili ukiwa umeingia tayari hakuthibitishi kuwa kikao kipya kilizuiwa.
Mambo yanayopaswa kuwamo katika jibu sahihi
- Anapima msimbo batili bila kikao cha akaunti na kuandika kuwa kuingia hakukufanikiwa.
- Anatumia msimbo mpya halisi baadaye na kukagua utambulisho wa akaunti uliotokana.
Jinsi inavyofanya kazi (si lazima)
Omba na uthibitishe msimbo
Kila kitufe kinalingana na mabadiliko tofauti ya hali.
Soma public/app.js. Kitendo cha kwanza huita signInWithOtp kwa barua iliyoingizwa; cha pili huita verifyOtp kwa barua hiyo na tokeni iliyopokelewa. Matokeo yaliyofaulu yanajumuisha kipindi.
Tumia kisanduku chako na unakili msimbo wa sasa kwa usahihi. Msimbo usio sahihi, ulioisha muda au uliokwisha kutumika unapaswa kumwacha mtumiaji bila kuingia. Usiandike misimbo au tokeni za ufikiaji kwenye ripoti inayoshirikiwa.
Mfano uliotatuliwa
Kiolesura hutumia textContent kwa maandishi ya hali na akaunti. Hakitafsiri anwani ya barua kuwa HTML.
const {data,error}=await client.auth.verifyOtp({email,token,type:'email'});
if(error || !data.session) { /* keep the unverified state */ }Zoezi la ziada la utekelezaji
Msimbo usio sahihi unarudisha kosa, lakini programu bado inaonyesha “Signed in”. Ni sharti lipi lazima libadilike?
Onyesha mfano wa suluhisho
Onyesha hali ya kuingia baada tu ya uthibitishaji kufaulu na kipindi kuwepo. Usitumie kubofya kitufe yenyewe kuwa ushahidi.
- Anakagua kosa na kipindi vilivyorudishwa.
- Anatenganisha kushindwa na uthibitishaji uliofaulu.

Hatua 3 · Jinsi ya kuwaruhusu watu kuingia kwenye tovuti yako
Kagua kupakia upya na kutoka
Hakikisha hali inayoonekana inafuata kipindi halisi cha akaunti.
Maelezo, mfano uliotatuliwa na zoezi
Elewa wazo
Pakia tena baada ya kuingia na ukague akaunti inayoonyeshwa. Tumia Sign out na uangalie utambulisho tena. Kwa kikao huru, tumia wasifu mwingine wa kivinjari au funga madirisha yote ya faragha kabla ya kufungua jipya: madirisha ya ziada yanaweza kushiriki kikao kilichopo.
Mfano uliotolewa unaonyesha hali ya akaunti; hauna hati binafsi ya kujaribu. Ukiongeza maudhui binafsi baadaye, seva ihakiki ruhusa kabla ya kuyatoa. Kitufe kilichofichwa pekee hakitoi ulinzi huo.
Mfano halisi
Ukurasa uliotoka kwenye akaunti usiendelee kutenda kama akaunti ya awali kwa sababu tu jina limebaki.
Faili za hatua hii
Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.
Jaribu mwenyewe
Hali gani ya akaunti ilionekana baada ya kupakia tena, kuondoka na katika kikao kipya cha faragha?
Onyesha mfano wa suluhisho
Rekodi ya mfano: “Kupakia tena bado kulitambua akaunti A. Sign out ilibadili utambulisho kuwa No signed-in account. Wasifu mwingine wa kivinjari pia haukuonyesha akaunti.”
Mfano huu unaonyesha hali ya akaunti, si hati binafsi. Kikao kikibaki baada ya kutoka, andika kosa hilo; kupima maudhui binafsi ni kazi ya somo private-page.
Mambo yanayopaswa kuwamo katika jibu sahihi
- Anaandika hali ya akaunti baada ya kupakia tena na baada ya kuondoka.
- Anakagua wasifu tofauti au kikao kipya kweli cha faragha badala ya kudhani dirisha jingine ni huru.
Jinsi inavyofanya kazi (si lazima)
Kagua kuendelea kwa kipindi na kutoka
Jaribu zaidi ya msimbo wa kwanza uliofaulu.
Baada ya kuingia, onyesha ukurasa upya na ukague hali ya akaunti. Kisha toka na uonyeshe upya tena. Tumia dirisha la faragha kuhakikisha kivinjari kingine hakipati kipindi hicho moja kwa moja.
Kutoka huondoa kipindi cha programu hii; hakumaanishi kila tokeni ya ufikiaji iliyokopiwa mahali popote inaacha kufanya kazi papo hapo. Muda wa tokeni na tabia ya kubatilisha ni muhimu unapojenga endpoint za seva zinazolindwa.
Mfano uliotatuliwa
Kiolesura baada ya kutoka hakipaswi kubakiza maelezo ya siri ya akaunti wala kuambatisha tokeni ya zamani kiotomatiki kwa ombi jipya. Endpoint za siri bado zinahitaji uthibitishaji wa seva.
Zoezi la ziada la utekelezaji
Je, kuficha kitufe cha Sign in kungetosha kulinda hati ya siri?
Onyesha mfano wa suluhisho
Hapana. Seva lazima ithibitishe mwombaji kabla ya kurudisha maudhui yanayolindwa. Somo linalofuata la ukurasa wa siri linatekeleza mpaka huo.
- Anatenganisha hali ya kiolesura na ukaguzi wa ruhusa kwenye seva.
- Anahitaji ukaguzi wa ufikiaji kwenye ombi la hati.

Hatua 4 · Jinsi ya kuwaruhusu watu kuingia kwenye tovuti yako
Rekodi njia kamili ya akaunti
Malizia kwa uchunguzi unaoweza kurudiwa, si picha ya mafanikio pekee.
Maelezo, mfano uliotatuliwa na zoezi
Elewa wazo
Rudia njia ya anwani, barua pepe na msimbo baada ya marekebisho yoyote. Hifadhi rekodi iliyofichwa taarifa nyeti ya kuingia, kupakia upya, kutoka na jaribio moja lenye maana lililoshindwa.
Vizuizi vya mtumaji au mipaka ya akaunti vikizuia jaribio, ripoti hatua hiyo kwa usahihi. Usitumie uigaji wa ndani ya kifaa badala ya msimbo uliowasilishwa kweli.
Mfano halisi
Ripoti yenye manufaa hutofautisha barua pepe kutokufika, msimbo usio sahihi na uthibitishaji uliofaulu.
Faili za hatua hii
Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.
Jaribu mwenyewe
Toa ukaguzi wako wa njia ya akaunti na chochote ambacho bado kimekwama.
Unachopaswa kuandaa: Rekodi fupi ya njia ya akaunti inayohusisha kufika halisi kwa msimbo, kuingia, kupakia upya, kutoka na jaribio lililoshindwa.
Onyesha mfano wa suluhisho
Rekodi kamili ya mfano: “Sanduku langu lilipokea msimbo; batili bila kikao ulikataliwa; mpya halali ulitambua A; kupakia tena kulihifadhi A; kuondoka kuliondoa utambulisho; wasifu huru haukuwa na kikao.”
Rekodi isiyokamilika ya mfano: “Ombi la msimbo lilishindwa kwa masharti ya mtumaji. Kufika na kuthibitisha hakukujaribiwa; hatua inayofuata: mpokeaji na usanidi wa mtumaji.” Njia iliyokwama ibaki haijakamilika, isibadilishwe na kuingia kwa kuigiza ndani.
Mambo yanayopaswa kuwamo katika jibu sahihi
- Anatoa kwa mfuatano matokeo ya ombi, barua, msimbo batili, halali, kupakia tena na kuondoka.
- Anataja hatua ya barua/mtoa huduma iliyokosekana bila kuweka misimbo au token za kikao kwenye rekodi.
Jinsi inavyofanya kazi (si lazima)
Kazi yako: hakikisha safari nzima ya akaunti
Andika hali za kuombwa, kushindwa, kuingia na kutoka.
Jaribu msimbo usio sahihi kabla ya kuingia kwa usahihi. Kagua kuonyesha upya, kutoka na dirisha la faragha. Tumia visanduku unavyodhibiti pekee.
Boresha ujumbe mmoja usio wazi bila kubadilisha ukweli wake: msimbo ulioombwa unasubiri, na kosa si kipindi kilichofanikiwa.
Mfano uliotatuliwa
Ripoti itambue hali zilizochunguzwa bila kufichua msimbo uliopokelewa, bearer token au maelezo ya siri ya wasifu.
Maelezo kamili ya hatua za suluhisho yanapatikana katika reference/assignment-walkthrough.txt. Linganisha hatua zake na matokeo yako; jaza rekodi ya majaribio kwa ulichokiona katika mradi wako mwenyewe.
Zoezi la ziada la utekelezaji
Kamilisha safari ya akaunti na ueleze kila hali uliyoona inathibitisha nini.
Onyesha mfano wa suluhisho
Sanidi URL ya mradi na ufunguo wa publishable, kisha kiolezo chenye {{ .Token }} ili ujumbe uwe na msimbo ukurasa unatarajia. Omba msimbo kwa kisanduku chako. Barua iliyoombwa si kipindi kilichothibitishwa.
Ingiza msimbo usio sahihi na uhakikishe hakuna kipindi cha mtumiaji kinachoundwa. Tumia msimbo mpya sahihi, hakikisha utambulisho unaoonyeshwa, pakia upya na uchunguze kipindi. Toka na uhakikishe kichupo hakiripoti tena kipindi.
Rudia katika dirisha la faragha: lisirithi hali ya kuingia ya dirisha la kwanza. Kuficha kitufe hakulindi hati; seva lazima ikague ruhusa kabla ya kurudisha maudhui ya siri.
- Hali ya msimbo usio sahihi na ya kutoka zinabaki bila uthibitishaji.
- Kipindi sahihi kinaendelea kama kilivyosanidiwa, na kutoka upande wa kivinjari kunahakikishwa kwa uaminifu.
Somo hili lilikufaa?
Bonyeza kupenda au mshirikishe mtu anayeweza kufaidika nalo.