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.

Anza somo shirikishiSoma maelezo ya somo

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.

Faili za mazoezi

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

Start hereFaili za mazoezi

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.

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.

Faili za hatua hii

Start hereFaili za mazoezi

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.

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.

Faili za hatua hii

Start hereFaili za mazoezi

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.

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.

Faili za hatua hii

Start hereFaili za mazoezi

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.

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.

Faili za hatua hii

Start hereFaili za mazoezi

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.

Somo hili lilikufaa?

Bonyeza kupenda au mshirikishe mtu anayeweza kufaidika nalo.

Endelea kujifunza

Angalia masomo mengine