
Somo fupi 12 kati ya 30 · Akaunti na ufikiaji
Chagua kinachohitaji ulinzi
Somo hili ni la nani?
Kwa watu wanaotaka ukurasa au dokezo lipatikane baada ya kuingia tu. Msaidizi wa programu anaweza kuunganisha ulinzi uliotolewa; kuandika programu ya seva si hitaji la kujifunza.
Faragha inamaanisha kutopatikana kwa mgeni asiyeidhinishwa, si kufichwa tu.
Utakachojifunza katika somo hili
- Weka maudhui binafsi nje ya ukurasa wa umma.
- Jaribu njia ileile ukiwa umetoka na umeingia kwenye akaunti.
- Kagua kushindwa kwa ufikiaji bila kufichua dokezo.
Maelezo, mfano uliotatuliwa na zoezi
Kabla ya kuanza
Usanidi wa kuingia uliotolewa au ufikiaji wa Supabase unaolingana, mradi tofauti wa upangishaji wa function na msaidizi wa programu. Tumia PRIVATE_NOTE ya kubuni iliyowekwa kwenye mazingira ya seva pekee, si maudhui halisi binafsi.
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 kuwaruhusu watu kuingia kwenye tovuti yako
Omba na utumie msimbo halisi wa kuingia kwenye akaunti.
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. Mfano huu unaruhusu watumiaji wote halali wa mradi wa mazoezi. Rekodi za kila mtumiaji na majukumu vinahitaji kanuni nyingine za ruhusa.
Elewa wazo
Tumia dokezo la kubuni lililotolewa na mradi ulio tayari. Mwombe msaidizi aweke dokezo kwenye seva badala ya ukurasa wa umma unaopakuliwa.
Mgeni anaweza kuchunguza faili za umma hata wakati kipengele kimefichwa. Usiweke taarifa halisi binafsi kwenye zoezi.
Mfano halisi
Aya iliyofichwa kwa mtindo wa ukurasa bado ni sehemu ya faili ya umma.
Tumia warsha hii kamili ya dokezo binafsi na mradi wangu wa mazoezi wa kuingia unaosimamiwa. Weka PRIVATE_NOTE kwenye mazingira binafsi ya seva pekee na uhifadhi ukaguzi wa ufikiaji uliotolewa. Nisaidie kuendesha programu, kisha linganisha ufikiaji wa moja kwa moja bila kuingia na kuingia kulikothibitishwa. Usichukulie kuficha aya kama ulinzi au kufichua data ya mtu mwingine.Faili za hatua hii
Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.
Jaribu mwenyewe
Unajaribu dokezo gani, na utakaguaje kwamba wageni wasioingia hawawezi kulipata?
Onyesha mfano wa suluhisho
Mpango wa mfano: “Maelezo yangu ya kubuni ni kumbusho la mkutano wa zoezi. Kila mtumiaji wa jaribio aliyeingia na kuthibitishwa anaweza kuyasoma hapa. Nitaomba maelezo hayo katika kikao tofauti kisichoingia na kuhakiki jibu halina maelezo.”
Maelezo yasikae kwenye faili za umma. Kuficha aya kwa mwonekano hakumzuii mgeni kusoma chanzo alichopakua.
Mambo yanayopaswa kuwamo katika jibu sahihi
- Anatumia maelezo ya kubuni ya seva pekee na kutaja watumiaji walioingia wanaoruhusiwa katika zoezi.
- Anapanga ombi la moja kwa moja bila kikao, badala ya kutegemea sehemu ya ukurasa iliyofichwa.
Jinsi inavyofanya kazi (si lazima)
Linda jibu, si kitufe pekee
Maudhui ya siri yasitumwe kabisa kwa kivinjari kisicho na ruhusa.
Kuficha kwa CSS na kuzima vitufe hubadilisha kiolesura, si jibu. Mtu yeyote anaweza kukagua faili za umma na kutuma ombi la moja kwa moja kwenye endpoint.
Seva yetu husoma dokezo kutoka mazingira yake na kulirudisha baada tu ya kuthibitisha tokeni ya mtumiaji. Dokezo la kubuni ni la mazoezi; data halisi ya siri iwe kwenye chanzo kinacholindwa, si repository ya umma.
Mfano uliotatuliwa
Faili la JavaScript la umma lenye dokezo “lililofichwa” bado ni nakala ya umma. Badala yake, mfano huweka thamani nje ya public/.
Zoezi la ziada la utekelezaji
Ukurasa unaficha aya hadi mtu aingie lakini aya iko kwenye chanzo cha HTML. Je, ni ya siri?
Onyesha mfano wa suluhisho
Hapana. Kagua ruhusa kwenye jibu la seva kabla ya kutuma maudhui. Kuficha thamani iliyopokelewa hakuifanyi siri.
- Anatambua kivinjari tayari kimeipokea.
- Anaweka ukaguzi wa ufikiaji kabla ya jibu lenye maudhui yanayolindwa.

Hatua 1 · Jinsi ya kuweka ukurasa kuwa wa siri
Unganisha ulinzi ulio tayari
Mruhusu msaidizi asanidi ukaguzi uliopo wa seva.
Maelezo, mfano uliotatuliwa na zoezi
Elewa wazo
Fuata run-locally.txt na msaidizi. Kabla ya kupima, hakiki mradi wa uthibitishaji, thamani zake za umma, mipangilio binafsi ya seva na PRIVATE_NOTE ya kubuni. Anza mradi kamili na fungua URL halisi ya proxy; mwonekano wa faili pekee hauendeshi ulinzi huu.
Ukaguzi wa utayari wa akaunti/seva ni wa lazima. Kusoma utekelezaji wa function ni hiari. Huduma ihakiki kikao kabla ya kutoa maelezo; mtu kuandika ID ya akaunti nyingine kwenye ombi si ushahidi wa utambulisho.
Mfano halisi
Utambulisho unaotolewa na mtumiaji si sawa na kipindi cha akaunti kilichothibitishwa.
Faili za hatua hii
Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.
Jaribu mwenyewe
Ni hatua ipi ya usanidi imekamilika, na unaweza kujaribu URL ipi halisi ya programu?
Onyesha mfano wa suluhisho
Rekodi ya mfano: “Programu inatumika kwenye URL ya proxy iliyotolewa na seva. Mradi wa uthibitishaji na maelezo ya kubuni ya seva vimesanidiwa. Maelezo hayapo katika faili za umma.”
Rekodi iliyokwama inaweza kusema: “Ukurasa unafunguka, lakini seva inasema Auth not configured; msaidizi akague mazingira binafsi kabla ya jaribio la ufikiaji.” Kufunguka kwa ukurasa pekee hakuthibitishi ulinzi wa seva.
Mambo yanayopaswa kuwamo katika jibu sahihi
- Anatambua anwani ya programu inayoendeshwa na usanidi wa seva/mtoa huduma uliokamilika.
- Anaripoti kikwazo maalumu bila kuchapisha maelezo binafsi au siri za akaunti.
Jinsi inavyofanya kazi (si lazima)
Tuma tokeni ya kipindi kwa seva
Programu ya kivinjari hutoa bearer token; seva huithibitisha yenyewe.
Sanidi faili za kuingia na mazingira ya seva kama START-HERE.txt inavyoeleza. Programu hupata kipindi chake cha sasa na kutuma tokeni yake ya ufikiaji kwenye kichwa cha Authorization inapoomba endpoint ya siri.
Seva huita endpoint ya mtumiaji ya mtoa huduma kwa tokeni hiyo na ufunguo wa publishable wa programu. Hukataa tokeni zinazokosekana au zisizo sahihi na hutofautisha hitilafu ya huduma na utambulisho uliokubaliwa. Kusoma yaliyomo kwenye tokeni bila kuithibitisha hakutoshi.
Fuata ombi kwa mpangilio: kivinjari hutuma tokeni ya ufikiaji ya mtumiaji → seva huuliza huduma ya utambulisho kama tokeni hiyo inawakilisha mtumiaji → matokeo yaliyothibitishwa tu huruhusu kurudisha dokezo. Ufunguo wa publishable wa mradi hutambua programu; wenyewe hautambui wala kumpa mtu ruhusa.
Kwa mfuatano wote wa ndani, fungua run-locally.txt: andaa mazingira ya siri kwenye mzizi, unganisha mradi wa mazoezi pekee na uanzishe wakala wa functions wa Netlify. server-env.example.txt huorodhesha majina ya vigezo bila siri halisi. Kufungua HTML pekee hakuwezi kuendesha seva.
Mfano uliotatuliwa
Sehemu ya userId iliyotolewa na mwombaji haithibitishi kuwa ID hiyo ni yake. Tumia utambulisho uliorudishwa na uthibitishaji.
const r=await fetch('/.netlify/functions/mini-private-note', {
headers:{Authorization:'Bearer '+session.access_token}
});Supabase: kupata mtumiaji aliyethibitishwa · Node.js: hali ya usaidizi wa matoleo
Zoezi la ziada la utekelezaji
Je, seva inaweza kuruhusu ombi kwa kuamini userId kwenye JSON ya kivinjari?
Onyesha mfano wa suluhisho
Hapana. Kivinjari kinaweza kubadilisha sehemu hiyo. Thibitisha taarifa ya ufikiaji na utumie utambulisho uliothibitishwa.
- Hayaamini madai ya utambulisho ya programu ya kivinjari.
- Anatumia tokeni iliyothibitishwa na utambulisho unaotokana nayo.

Hatua 2 · Jinsi ya kuweka ukurasa kuwa wa siri
Jaribu kundi linaloruhusiwa
Amua anayepaswa kuweza kusoma kipengele hiki maalumu.
Maelezo, mfano uliotatuliwa na zoezi
Elewa wazo
Ingia kwa akaunti yako ya majaribio unayoidhibiti na uombe dokezo la kubuni. Kwa maabara hii, kanuni ni mtumiaji yeyote aliyeingia na kuthibitishwa; mwombe msaidizi ahifadhi upeo huo uliotajwa.
Ukihifadhi data ya akaunti ya mtu mmoja baadaye, kanuni hiyo pana haitoshi. Taja kundi badala ya kudhani data zote binafsi zina ruhusa zinazofanana.
Mfano halisi
Dokezo la pamoja la wanachama na rekodi ya akaunti ya mtu mmoja zinahitaji maamuzi tofauti ya ufikiaji.
Faili za hatua hii
Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.
Jaribu mwenyewe
Nani anaruhusiwa kusoma dokezo lako la mazoezi, na ombi la aliyeingia lililingana na kanuni hiyo?
Onyesha mfano wa suluhisho
Rekodi ya mfano: “A imethibitishwa na kupokea maelezo ya kubuni ya wanachama. Sheria inaruhusu kila mtumiaji aliyeingia na kuthibitishwa, hivyo mwanachama mwingine wa jaribio pia yuko kwenye kundi halali.”
Hii ni sheria ya maudhui ya pamoja ya wanachama. Haitoshi kwa wasifu binafsi wa A, ambao unapaswa kuwa wa A tu; mpaka huo tofauti unahitaji ukaguzi wa umiliki.
Mambo yanayopaswa kuwamo katika jibu sahihi
- Anaeleza kuwa zoezi linaruhusu kila mtumiaji aliyeingia na kuthibitishwa, si mmiliki mmoja wa maelezo tu.
- Anaandika matokeo ya akaunti halali bila kupanua sheria hii kwa data binafsi ya kila akaunti.
Jinsi inavyofanya kazi (si lazima)
Rudisha data inayolindwa inayokusudiwa pekee
Utambulisho sahihi hautoi moja kwa moja ufikiaji wa rekodi za kila mtumiaji.
Mfano huu mdogo unaruhusu kila mtumiaji halali wa mradi wa mazoezi kufikia dokezo moja la pamoja. Hii ni kanuni ya ruhusa iliyo wazi, si maana ya jumla ya maudhui ya siri.
Jibu hutumia private, no-store ili cache ya pamoja isihifadhi dokezo. Somo la wasifu baadaye hutumia kanuni za umiliki kwa rekodi za kila mtumiaji. Usipanue function hii iwe njia ya kupakua hifadhidata yote.
Mfano uliotatuliwa
viewerId ya seva hutokana na uthibitishaji. Dokezo linatoka kwenye mazingira yake, si data iliyotumwa katika ombi.
Zoezi la ziada la utekelezaji
Ikiwa dokezo lingebadilishwa kuwa maelezo ya akaunti ya mtumiaji mwingine, je, “mtumiaji yeyote aliyeingia” ingebaki kanuni inayofaa?
Onyesha mfano wa suluhisho
Hapana. Ongeza kanuni inayolinganisha utambulisho uliothibitishwa na rekodi au jukumu linaloombwa. Kuingia pekee hakutoi ufikiaji wa akaunti nyingine.
- Anatofautisha uthibitishaji wa utambulisho na ruhusa ya kila rekodi.
- Anahitaji umiliki au jukumu linalofaa kwa data ya kila mtumiaji.

Hatua 3 · Jinsi ya kuweka ukurasa kuwa wa siri
Jaribu njia ileile bila kuingia kwenye akaunti
Ombi la moja kwa moja lina umuhimu sawa na kitufe cha kawaida.
Maelezo, mfano uliotatuliwa na zoezi
Elewa wazo
Tumia wasifu wa kivinjari ambao kweli haujaingia, au ondoka na uhakiki hali; kisha msaidizi aombe maelezo yale moja kwa moja. Dirisha la ziada la faragha linaweza kushiriki kikao kilichopo. Rudia ombi ukiwa umeingia na kuthibitishwa.
Matokeo bila kuingia yasiwe na dokezo; kipindi kinachoruhusiwa kikipokee. Ombi likishindwa libaki kuwa hitilafu bila kuvuja maudhui.
Mfano halisi
Kuondoa kiungo cha menyu hakulindi anwani iliyokuwa inafunguliwa nacho.
Faili za hatua hii
Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.
Jaribu mwenyewe
Majaribio ya moja kwa moja bila kuingia na baada ya kuingia yalirudisha nini kila moja?
Onyesha mfano wa suluhisho
Rekodi ya mfano ya ombi la moja kwa moja: “Bila kikao: njia ilirudisha Sign in required bila maelezo. Nikiwa A: njia ileile ilirudisha maelezo ya kubuni. Msaidizi alisaidia kukagua majibu bila kushiriki token.”
Jibu lisilo na kikao likiwa na maelezo, ulinzi umeshindwa hata ukurasa ukiyaficha. Huduma ya uthibitishaji isipatikane, andika kosa hilo tofauti na ombi la kawaida lililokataliwa.
Mambo yanayopaswa kuwamo katika jibu sahihi
- Analinganisha njia ileile ya maelezo bila kikao na kwa kikao halali kilichoingia.
- Anahakiki majibu yaliyokataliwa au kushindwa hayana maandishi binafsi ya maelezo.
Jinsi inavyofanya kazi (si lazima)
Jaribu endpoint bila kiolesura
Jaribio halisi la ufikiaji hulenga ombi la data moja kwa moja.
Omba URL ya function katika dirisha jipya bila kichwa cha Authorization; isirudishe dokezo. Jaribu bearer token yenye muundo usio sahihi, kisha utumie kiolesura kilichoingia kutuma ombi linaloruhusiwa.
Toka na ukague kuwa programu inaondoa dokezo linaloonyeshwa na haitumi tena tokeni ya kipindi. Tokeni iliyotolewa awali inaweza kubaki halali hadi muda wake uliosanidiwa uishe; kubatilisha kila mahali papo hapo ni hitaji tofauti.
Mfano uliotatuliwa
Ombi la moja kwa moja lililokataliwa huthibitisha zaidi ya picha ya kitufe cha kuingia. Hifadhi hali ya jibu na kama maudhui yaliyolindwa yalikuwepo kwenye rekodi yako.
Zoezi la ziada la utekelezaji
Ombi la moja kwa moja linarudisha 401 bila dokezo, lakini kipindi kilichothibitishwa kinapata dokezo. Umejaribu mpaka upi?
Onyesha mfano wa suluhisho
Umejaribu kuwa endpoint hii huthibitisha utambulisho kabla ya kurudisha dokezo la pamoja. Endpoint nyingine na kanuni za umiliki zinahitaji majaribio yake.
- Anatambua mpaka wa jibu la seva.
- Hadai tokeni zote zimebatilishwa au ruhusa ya kila mtu imejaribiwa zaidi ya mfano.

Hatua 4 · Jinsi ya kuweka ukurasa kuwa wa siri
Linda thamani moja zaidi ya jaribio
Rudia ukaguzi uleule baada ya badiliko dogo.
Maelezo, mfano uliotatuliwa na zoezi
Elewa wazo
Mwombe msaidizi aongeze thamani ya pili ya kubuni ya seva pekee kwa kanuni ileile ya kundi lililokusudiwa. Usihamishe thamani yoyote kwenda faili za umma kwa urahisi tu.
Rudia uchunguzi wa kuruhusiwa, kukataliwa na kushindwa. Ficha taarifa nyeti kwenye makabidhiano na utaje jaribio lolote ambalo halikufanywa.
Mfano halisi
Kuongeza sehemu nyingine kusifanye dokezo la awali binafsi kuwa la umma kwa bahati mbaya.
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 ulinzi wa thamani mpya na matokeo ya ufikiaji uliyoyaona.
Unachopaswa kuandaa: Njia ya mazoezi inayofanya kazi na matokeo ya ukaguzi uliyoyaona wa ufikiaji bila kuingia, baada ya kuingia na wa hitilafu.
Onyesha mfano wa suluhisho
Rekodi ya mfano: “Nimeongeza mahali pa mkutano pa kubuni karibu na maelezo ya awali. Mwanachama aliyethibitishwa alipokea vyote; ombi bila kikao halikupokea chochote. Nikiifanya huduma ya uthibitishaji isipatikane kwa makusudi katika mradi wa kufutika, jibu lilibaki kosa lisilo na thamani hizo.”
Makabidhiano yanaweza kutaja sehemu hizo mbili na matokeo bila kuonyesha yaliyomo. Kesi ya kosa isipojaribiwa, iandike hivyo badala ya kuchukulia ukaguzi mmoja wa kikao halali kama ushahidi wa mipaka yote.
Mambo yanayopaswa kuwamo katika jibu sahihi
- Anahifadhi thamani zote mbili za kubuni kwenye seva pekee chini ya sheria iliyotajwa ya wanachama.
- Anarudia majibu ya kuruhusiwa, kukataliwa na kushindwa kwa huduma kwa thamani mpya.
Jinsi inavyofanya kazi (si lazima)
Kazi yako: ongeza thamani ya pili inayolindwa
Weka thamani mpya nje ya faili za umma na utumie ukaguzi uleule wa seva.
Ongeza thamani nyingine ya mazoezi kwenye mazingira ya seva, irudishe baada tu ya uthibitishaji na uionyeshe salama kama maandishi. Jibu lisiruhusiwe kuhifadhiwa kwenye cache.
Rudia majaribio ya tokeni inayokosekana, tokeni isiyo sahihi na kipindi halali. Tafuta katika msimbo wa umma kuhakikisha hakuna thamani yoyote ya siri iliyowekwa humo.
Mfano uliotatuliwa
Kazi inapanua jibu linalolindwa, si kiasi cha data kinachotumwa kabla ya kuingia.
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
Linda thamani ya pili na utoe ushahidi wa ufikiaji unaofaulu na unaokataliwa.
Onyesha mfano wa suluhisho
Ita endpoint ya private-note moja kwa moja bila kichwa cha Authorization: tarajia 401 bila dokezo. Bearer token ya kubuni lazima ishindwe pia. userId ya kivinjari au kitufe kilichofichwa havitimizi ukaguzi wa utambulisho wa seva.
Kwa tokeni halisi iliyothibitishwa ya kipindi chako katika mradi wako wa mazoezi, tarajia dokezo la seva lililosanidiwa na Cache-Control: private, no-store. Usitie dokezo kwenye HTML/JavaScript ya umma. Usibandike bearer token halisi kwenye ripoti inayoshirikiwa.
Baada ya kutoka, kiolesura kiondoe maudhui ya siri na kiache kutuma maombi yenye uthibitishaji. Tokeni ya ufikiaji iliyokwisha kunakiliwa inaweza kutumika hadi iishe muda: tabia ya kiolesura cha kutoka haihakikishi ubatilishaji wa papo hapo. Zoezi la dokezo la pamoja huruhusu watumiaji walioingia; umiliki wa kila mtu ni zoezi tofauti la wasifu.
- Thamani zote mbili zinabaki kwenye seva hadi ruhusa ithibitishwe.
- Maombi ya moja kwa moja yasiyo na ruhusa hayana thamani yoyote; ufikiaji halali na no-store vimekaguliwa.
Somo hili lilikufaa?
Bonyeza kupenda au mshirikishe mtu anayeweza kufaidika nalo.