Somo fupi · Kiswahili

Jinsi ya kuweka ukurasa kuwa wa siri

Tumia mradi tayari wa kuingia kwenye akaunti kuweka dokezo la mazoezi kwa faragha na ujaribu ufikiaji unaoruhusiwa na unaokataliwa.

Anza somo shirikishiSoma maelezo ya somo

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.

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.

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.

Utakachojifunza

  • Weka maudhui binafsi nje ya ukurasa wa umma.
  • Jaribu njia ileile ukiwa umetoka na umeingia kwenye akaunti.
  • Kagua kushindwa kwa ufikiaji bila kufichua dokezo.

Faili za mazoezi

Hatua 1

Chagua kinachohitaji ulinzi

Faragha inamaanisha kutopatikana kwa mgeni asiyeidhinishwa, si kufichwa tu.

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

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)

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/.

Extra implementation exercise

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 2

Unganisha ulinzi ulio tayari

Mruhusu msaidizi asanidi ukaguzi uliopo wa seva.

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.

Supabase: kupata mtumiaji aliyethibitishwa · Node.js: hali ya usaidizi wa matoleo

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)

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

Extra implementation exercise

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 3

Jaribu kundi linaloruhusiwa

Amua anayepaswa kuweza kusoma kipengele hiki maalumu.

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

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)

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.

Extra implementation exercise

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 4

Jaribu njia ileile bila kuingia kwenye akaunti

Ombi la moja kwa moja lina umuhimu sawa na kitufe cha kawaida.

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

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)

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.

Extra implementation exercise

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 5

Linda thamani moja zaidi ya jaribio

Rudia ukaguzi uleule baada ya badiliko dogo.

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

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: 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.

Extra implementation exercise

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.

Endelea kujifunza

Angalia masomo mengine