
Somo fupi · Kiswahili
Jinsi ya kuwaruhusu watu kuingia kwenye tovuti yako
Unganisha ukurasa tayari wa kuingia kwenye akaunti na huduma inayosimamiwa ya akaunti na ujaribu misimbo ya barua pepe, kutoka na majaribio yanayoshindwa.
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.
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.
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.
Utakachojifunza
- 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.
Hatua 1
Elewa njia ya kuingia kwenye akaunti
Kupokea msimbo na kuwa umeingia kwenye akaunti ni nyakati tofauti.
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.Supabase: misimbo ya kuingia kwa barua pepe · Supabase: aina za funguo za API
Faili za hatua hii
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
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
Extra implementation exercise
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.
Kosa linalofanywa mara nyingi
Kuchukulia sehemu ya barua au jina la kuonyesha lililohifadhiwa kuwa ushahidi wa utambulisho.
Hatua 2
Andaa mtoa huduma na ukurasa
Chagua mtiririko wa msimbo unaotarajiwa na fomu iliyotolewa.
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.
Jaribu mwenyewe
Usanidi wa mtoa huduma na ujumbe uliopokelewa vililingana na fomu ya kuingiza msimbo?
Jadili jibu lako na msaidizi wa somo
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.
- Anataja mradi wa zoezi, kiolezo chenye msimbo na utayari wa mwonekano wa HTTP.
- Anatofautisha mipangilio ya umma na siri, akitaja hatua yoyote iliyokwama.
Faili za hatua hii
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
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.
Extra implementation exercise
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.
Kosa linalofanywa mara nyingi
Kutumia ufunguo wa seva wenye mamlaka ya juu kwa sababu unaonekana kufanikisha maombi mengi zaidi.
Hatua 3
Kamilisha kuingia halisi kwenye akaunti
Tumia ujumbe wa barua pepe badala ya msimbo uliobuniwa.
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.
Jaribu mwenyewe
Katika kikao kipya bila kuingia, nini kilitokea kwa msimbo batili na kisha msimbo mpya halisi wa barua?
Jadili jibu lako na msaidizi wa somo
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.
- Anapima msimbo batili bila kikao cha akaunti na kuandika kuwa kuingia hakukufanikiwa.
- Anatumia msimbo mpya halisi baadaye na kukagua utambulisho wa akaunti uliotokana.
Faili za hatua hii
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
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 */ }Extra implementation exercise
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.
Kosa linalofanywa mara nyingi
Kutumia tena ujumbe wa mafanikio wa ombi la awali baada ya uthibitishaji kushindwa.
Hatua 4
Kagua kupakia upya na kutoka
Hakikisha hali inayoonekana inafuata kipindi halisi cha akaunti.
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.
Jaribu mwenyewe
Hali gani ya akaunti ilionekana baada ya kupakia tena, kuondoka na katika kikao kipya cha faragha?
Jadili jibu lako na msaidizi wa somo
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.
- 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.
Faili za hatua hii
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
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.
Extra implementation exercise
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.
Kosa linalofanywa mara nyingi
Kudhani kanuni za kuonyesha upande wa kivinjari zinalinda data yenyewe.
Hatua 5
Rekodi njia kamili ya akaunti
Malizia kwa uchunguzi unaoweza kurudiwa, si picha ya mafanikio pekee.
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.
Jaribu mwenyewe
Vifaa vya kuanzia
Faili na maudhui ya majaribio yametolewa. Uthibitishaji halisi bado unahitaji akaunti, barua au kikoa chako kama masharti yanavyoeleza. Unaweza kuchunguza ndani ya kompyuta; andika hatua za mtandaoni ambazo hujafanya kama hazijajaribiwa.
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.
Jadili jibu lako na msaidizi wa somo
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.
- 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.
Faili za hatua hii
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
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.
Extra implementation exercise
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.
Kosa linalofanywa mara nyingi
Kuwasilisha picha ya skrini yenye tokeni ya kipindi inayoweza kutumika tena.
Somo hili lilikufaa?
Bonyeza kupenda au mshirikishe mtu anayeweza kufaidika nalo.
Endelea kujifunza
- Jinsi ya kutengeneza tovuti yako binafsi ya kwanza
- Jinsi ya kuchapisha tovuti yako kutoka GitHub
- Jinsi ya kuunganisha kikoa chako na tovuti yako
- Jinsi ya kusanidi barua pepe kwenye kikoa chako
- Jinsi ya kufanya tovuti yako itumike vizuri kwenye simu
- Jinsi ya kufanya picha za tovuti zipakie haraka zaidi
- Jinsi ya kupokea maoni ya tovuti kwenye kikasha chako
- Jinsi ya kuongeza usajili wa barua pepe kwenye tovuti yako
- Jinsi ya kutuma barua pepe za kiotomatiki kutoka tovuti yako
- Jinsi ya kuhifadhi ujumbe wa fomu kwenye hifadhidata
- Jinsi ya kuweka ukurasa kuwa wa siri
- Jinsi ya kuwaruhusu watumiaji kuhariri taarifa za wasifu wao
- Jinsi ya kuwaruhusu watumiaji kupakia picha
- Jinsi ya kuweka funguo za API nje ya msimbo wa kivinjari
- Jinsi ya kuonyesha data kutoka API ya huduma nyingine kwenye tovuti yako
- Jinsi ya kuongeza chatbot ya AI kwenye tovuti yako
- Jinsi ya kufanya chatbot ijibu kwa maudhui yako
- Jinsi ya kuongeza blogu kwenye tovuti yako
- Jinsi ya kuongeza utafutaji kwenye tovuti yako
- Jinsi ya kuongeza lugha nyingine kwenye tovuti yako
- Jinsi ya kusaidia Google ipate tovuti yako
- Jinsi ya kurekebisha hakiki ya tovuti yako unaposhiriki kiungo
- Jinsi ya kupima ziara na vitendo vyenye manufaa kwenye tovuti yako
- Jinsi ya kuwawezesha wageni kuweka miadi
- Jinsi ya kupokea malipo kwenye tovuti yako
- Jinsi ya kuhakiki mabadiliko ya tovuti kabla ya kuchapisha
- Jinsi ya kutengua uchapishaji wa tovuti ulioharibika
- Jinsi ya kuhifadhi nakala rudufu na kurejesha data ya tovuti yako
- Jinsi ya kupata na kurekebisha makosa kwenye tovuti yako ya umma