
Isomo rigufi 12 kuri 30 · Konti n'uburenganzira bwo kugera ku makuru
Hitamo igikeneye kurindwa
Ibi bigenewe nde?
Abashaka urupapuro cyangwa inyandiko iboneka gusa nyuma yo kwinjira. Umufasha wo kwandika kode ashobora guhuza uburinzi bwatanzwe; kwandika porogaramu ya seriveri si igisabwa kugira ngo wige.
Ibanga risobanura ko umushyitsi utabifitiye uburenganzira atabibona, si ukubihisha gusa.
Intego y'iri somo
- Ntushyire ibirimo by'ibanga mu rupapuro rusange.
- Gerageza inzira imwe utinjiye muri konti n'igihe winjiye.
- Genzura kwangwa ko kugera ku makuru utagaragaje inyandiko.
Ibisobanuro, urugero rusobanuye n'imyitozo
Mbere yo gutangira
Igenamiterere ryo kwinjira watanzwe cyangwa ubundi burenganzira bwa Supabase bihwanye, umushinga utandukanye wakira functions n'umufasha wo kwandika kode. Koresha PRIVATE_NOTE y'impimbano ibikwa mu bidukikije bya seriveri gusa, ntukoreshe ibirimo nyabyo by'ibanga.
Reba ubumenyi bwo gutangiriraho
Ni ubumenyi bw’ingirakamaro, si amasomo utegetswe kubanza kurangiza. Niba ubuzi, tangirira hano; niba utabwuzi, fungura amasomo y’imyiteguro. Dosiye zo gutangira ziratanzwe; ntukeneye urubuga rwawe wari usanganywe.
- Uko wakwemerera abantu kwinjira muri konti ku rubuga rwawe
Saba ukoreshe kode nyayo yo kwinjira.
Igihe kigereranyijwe: 20–32 min
Igihe kigereranyijwe ukoresheje dosiye zo gutangiriraho zatanzwe, konti n’ibikoresho bikenewe byamaze gutegurwa. Gutegura, gutegereza gushyira urubuga kuri interineti, imeli cyangwa DNS bishobora gufata ikindi gihe. Uru rugero rwemerera abakoresha bose bemewe b'umushinga wo kwitoza. Inyandiko za buri ukoresha n'uruhare bisaba andi mategeko y'uburenganzira.
Sobanukirwa igitekerezo
Koresha inyandiko y'impimbano n'umushinga witeguye watanzwe. Saba umufasha kugumana inyandiko kuri seriveri aho kuyishyira mu rupapuro rusange rumanurwa.
Umushyitsi ashobora gusuzuma dosiye rusange nubwo igice cyahishwe. Ntushyire amakuru nyayo y'ibanga mu mwitozo.
Urugero rufatika
Igika gihishwe n'imyambarire y'urupapuro kikiri igice cya dosiye rusange.
Koresha uyu mwitozo wuzuye w'inyandiko y'ibanga n'umushinga wanjye w'umwitozo wo kwinjira ucungwa na serivisi. Gumana PRIVATE_NOTE mu bidukikije by'ibanga bya seriveri gusa kandi ugumane amagenzura y'uburenganzira yatanzwe. Mfasha gukoresha porogaramu, hanyuma tugereranye kugeraho bitaziguye utinjiye no kwinjira byemejwe. Ntufate guhisha igika nk'uburinzi cyangwa ngo ugaragaze amakuru y'undi muntu.Dosiye z'iyi ntambwe
Tangirira hanoDosiye z'imyitozo
Fungura cyangwa umanure dosiye zikurikira. Iyo ubika umushinga, komeza imiterere y’ububiko igaragazwa mu mazina ya dosiye.
Gerageza ubwawe
Ni iyihe nyandiko uri kugerageza, kandi uzagenzura ute ko abashyitsi batinjiye batayibona?
Erekana igisubizo gisobanuye
Gahunda y’icyitegererezo: “Inyandiko yanjye y’impimbano ni urwibutso rw’inama y’umwitozo. Umukoresha w’igerageza wese winjiye yemejwe ashobora kuyisoma hano. Ndagerageza inzira y’iyo nyandiko mu idirishya ryihariye ntinjiye muri konti, nemeze ko igisubizo kitarimo iyo nyandiko.”
Inyandiko igomba kuguma hanze ya dosiye rusange z’urupapuro. Guhisha paragrafu mu myerekano ntibibuza umushyitsi gusoma kode yamanuriwe.
Ibigize igisubizo gikwiye
- Akoresha inyandiko y’impimbano iba kuri seriveri gusa akavuga abo konti zinjiye zemerewe muri uyu mwitozo.
- Ateganya gusaba amakuru atinjiye muri konti mu buryo butaziguye aho kwishingikiriza ku gice cy’urupapuro gihishwe.
Uko bikora (si itegeko)
Rinda igisubizo, aho kurinda buto gusa
Ibirimo by'ibanga ntibigomba kubanza koherezwa muri mushakisha itemerewe.
Guhisha muri CSS na buto zazimijwe bihindura imigaragarire, si igisubizo. Uwo ari we wese ashobora gusuzuma dosiye za rusange kandi agatanga icyifuzo kitaziguye kuri endpoint.
Seriveri yacu isoma inyandiko mu igenamiterere ryayo ry'ibanga, nka PRIVATE_NOTE yashyizwe kuri seriveri cyangwa muri .env y'ibanga iri mu bubiko shingiro bw'umushinga, kandi ikayisubiza gusa nyuma yo kwemeza token y'ukoresha. Inyandiko y'igihimbano ni iy'umwitozo; amakuru nyayo y'ibanga agomba kuba mu nkomoko y'amakuru irinzwe, aho kuba mu bubiko bwa kode bwa rusange.
Urugero rusobanuye
Dosiye ya JavaScript ya rusange irimo inyandiko «ihishe» iracyari kopi ya rusange. Ahubwo uru rugero rugumisha agaciro hanze ya public/.
Undi mwitozo wa tekiniki
Urupapuro ruhisha igika kugeza winjiye, ariko icyo gika kiri muri kode ya HTML y'umwimerere. Ni ibanga?
Erekana igisubizo gisobanuye
Oya. Banza ugenzure igisubizo cya seriveri mbere yo kohereza ibirimo. Guhisha agaciro kamaze kwakirwa ntibishobora kukagira ibanga.
- Hamenyekana ko mushakisha yamaze kucyakira.
- Igenzura ry'uburenganzira ryimurirwa mbere y'igisubizo kirinzwe.

Intambwe 1 · Uko wagumisha urupapuro ari ibanga
Huza uburinzi bwiteguye
Reka umufasha ashyireho amagenzura ya seriveri asanzweho.
Ibisobanuro, urugero rusobanuye n'imyitozo
Sobanukirwa igitekerezo
Kurikiza run-locally.txt ufashijwe n’umufasha. Mbere yo kugerageza, emeza umushinga wo kwemeza konti ugamijwe, indangagaciro rusange za mushakisha, igenamiterere ry’ibanga rya seriveri na PRIVATE_NOTE y’impimbano. Tangiza umushinga wose ufungure URL nyayo ya proxy; kurebera dosiye gusa ntibishobora gukoresha uburinzi bwawo.
Aya magenzura yo gutegura konti na seriveri arasabwa. Gusoma uburyo function yanditswe ni ubushake. Serivisi igomba kwemeza session ya konti mbere yo gusubiza inyandiko; uwandika ID y’indi konti mu busabe si gihamya y’umwirondoro.
Urugero rufatika
Umwirondoro watanzwe n'umukoresha si kimwe n'igihe cyo kwinjira muri konti cyemejwe.
Dosiye z'iyi ntambwe
Tangirira hanoDosiye z'imyitozo
Fungura cyangwa umanure dosiye zikurikira. Iyo ubika umushinga, komeza imiterere y’ububiko igaragazwa mu mazina ya dosiye.
Gerageza ubwawe
Ni iyihe ntambwe yo gutegura yarangiye, kandi ni iyihe URL nyayo ya porogaramu ushobora kugerageza?
Erekana igisubizo gisobanuye
Inyandiko y’imyiteguro y’icyitegererezo: “Porogaramu yatanzwe iri gukora kuri URL ya proxy yo kuri mudasobwa yerekanywe na seriveri. Umushinga wo kwemeza konti n’inyandiko y’impimbano yo kuri seriveri byateguwe. Iyo nyandiko ntiri muri dosiye rusange z’urupapuro.”
Inyandiko y’inzitizi ishobora kuvuga iti: “Urupapuro rurafunguka, ariko seriveri ivuga Auth not configured; umufasha agomba kugenzura ibidukikije by’ibanga bya serivisi mbere yo kugerageza uburenganzira.” Gufunguka k’urupapuro byonyine ntibyemeza uburinzi bwa seriveri.
Ibigize igisubizo gikwiye
- Agaragaza aderesi ya porogaramu ikora n’igenamiterere rya seriveri na serivisi ryarangiye.
- Avuga inzitizi ifatika yo gutegura atashyize ku karubanda inyandiko y’ibanga cyangwa amabanga ya konti.
Uko bikora (si itegeko)
Ohereza token ya session kuri seriveri
Client itanga bearer token; seriveri ikayigenzura yigenga.
Tegura dosiye zo kwinjira n'ibidukikije bya seriveri muri START-HERE.txt. Client ibona session yayo iriho kandi ikohereza access token yayo muri Authorization header igihe isaba endpoint y'ibanga.
Seriveri ihamagara user endpoint ya serivisi ifite iyo token n'urufunguzo rwa porogaramu rw'umushinga rwemerewe gutangazwa. Yanga tokens zibura cyangwa zitemewe kandi igatandukanya kubura serivisi n'umwirondoro wakiriwe. Gusoma ibiri muri token uyisobanuye (decode), utagenzuye kuri serivisi ko yemewe, ntibihagije.
Kurikira icyifuzo uko gikurikirana: mushakisha yohereza access token y'ukoresha → seriveri ibaza serivisi y'umwirondoro niba iyo token ihagarariye ukoresha → igisubizo cyemejwe cyonyine ni cyo cyemerera gusubiza inyandiko. Urufunguzo rw'umushinga rwemerewe gutangazwa ruranga porogaramu; rwo rwonyine ntiruranga cyangwa ngo ruhe umuntu uburenganzira.
Ku ruhererekane rwuzuye rwo kuri mudasobwa yawe, fungura run-locally.txt: tegura igenamiterere ry'ibanga rya seriveri muri dosiye .env iri mu bubiko shingiro bw'umushinga, hanze ya public/ kandi idakurikiranwa na Git; huza gusa umushinga wo kwitoza kandi utangize proxy ya Netlify functions. server-env.example.txt itondeka amazina ya variables idafite amabanga nyayo. Gufungura HTML gusa ntibishobora gukoresha seriveri.
Urugero rusobanuye
Umwanya wa userId watanzwe n'usaba si ikimenyetso ko usaba ari nyir'iyo ID. Koresha umwirondoro wasubijwe n'igenzura.
const r=await fetch('/.netlify/functions/mini-private-note', {
headers:{Authorization:'Bearer '+session.access_token}
});Supabase: kubona ukoresha wemejwe · Node.js: imimerere y'uburyo busohotse bushyigikiwe
Undi mwitozo wa tekiniki
Seriveri yakwemerera icyifuzo yizeye userId iva muri JSON ya mushakisha?
Erekana igisubizo gisobanuye
Oya. Mushakisha ishobora guhindura uwo mwanya. Emeza icyangombwa kandi ukoreshe umwirondoro wemejwe.
- Ibyo client yivugaho ku mwirondoro bifatwa nk'ibitizerwa.
- Hakoreshwa token yemejwe n'umwirondoro ivuyemo.

Intambwe 2 · Uko wagumisha urupapuro ari ibanga
Gerageza abagenewe uburenganzira
Hitamo abakwiriye kwemererwa gusoma iki kintu cyihariye.
Ibisobanuro, urugero rusobanuye n'imyitozo
Sobanukirwa igitekerezo
Injira ukoresheje konti yawe y'igerageza ugenzura usabe inyandiko y'impimbano. Muri uyu mwitozo, itegeko ni uko umuntu wese winjiye akemezwa ayibona; saba umufasha kugumana iyo mbibi yasobanuwe.
Nyuma nubika amakuru ya konti y'umuntu umwe, iryo tegeko ryagutse ntirizaba rihagije. Vuga abagenewe amakuru aho gufata ko amakuru yose y'ibanga afite uburenganzira bumwe.
Urugero rufatika
Inyandiko isangiwe n'abanyamuryango n'inyandiko ya konti y'umuntu umwe bisaba ibyemezo bitandukanye byo kugeraho.
Dosiye z'iyi ntambwe
Tangirira hanoDosiye z'imyitozo
Fungura cyangwa umanure dosiye zikurikira. Iyo ubika umushinga, komeza imiterere y’ububiko igaragazwa mu mazina ya dosiye.
Gerageza ubwawe
Ni nde wemerewe gusoma inyandiko yawe y'umwitozo, kandi ubusabe wakoze winjiye bwahuye n'iryo tegeko?
Erekana igisubizo gisobanuye
Inyandiko y’uburenganzira y’icyitegererezo: “Konti y’igerageza A yaremejwe kandi yakiriye inyandiko y’impimbano y’abanyamuryango. Itegeko ry’umwitozo ni umukoresha wese winjiye yemejwe, bityo undi munyamuryango w’igerageza wemejwe na we ari mu bemerewe.”
Iri ni itegeko ry’inyandiko rusange y’abanyamuryango. Ntiryaba rihagije ku mwirondoro bwite wa A, ugomba kuba uwa A gusa; uwo mupaka utandukanye usaba igenzura rya nyirawo.
Ibigize igisubizo gikwiye
- Avuga ko umwitozo wemerera umukoresha wese winjiye yemejwe, atari nyir’inyandiko umwe gusa.
- Yandika igisubizo cya konti yemerewe ataguye iri tegeko ku makuru bwite ya konti.
Uko bikora (si itegeko)
Subiza gusa amakuru arinzwe yari agenewe
Umwirondoro wemewe ntuhita utanga uburenganzira ku nyandiko za buri ukoresha.
Uru rugero ruto ruha buri ukoresha wemewe mu mushinga wo kwitoza uburenganzira ku nyandiko imwe isangiwe. Iryo ni itegeko ry'uburenganzira ryasobanuwe mu buryo bweruye, si igisobanuro rusange cy'ibirimo by'ibanga.
Igisubizo gikoresha cache ya private, no-store kugira ngo cache isangiwe itagumana inyandiko. Isomo ry'umwirondoro rikurikiraho rikoresha amategeko ya nyir'amakuru ku nyandiko za buri ukoresha. Ntukagure iyi handler ngo ibe iyo gusohora ububiko bw'amakuru bwose.
Urugero rusobanuye
viewerId ya seriveri iva mu kwemeza. Inyandiko iva mu bidukikije byayo, aho kuva mu makuru yatanzwe mu cyifuzo.
Undi mwitozo wa tekiniki
Niba inyandiko yasimbujwe amakuru ya konti y'undi ukoresha, itegeko ryo «buri muntu winjiye» ryakomeza kuba rikwiye?
Erekana igisubizo gisobanuye
Oya. Ongeraho itegeko rihuza umwirondoro wemejwe n'inyandiko yasabwe cyangwa uruhare. Kwinjira byonyine ntibitanga uburenganzira ku yindi konti.
- Kwemeza umwirondoro bitandukanywa n'uburenganzira ku rwego rw'inyandiko.
- Hasabwa nyir'amakuru cyangwa uruhare rukwiye ku makuru ya buri ukoresha.

Intambwe 3 · Uko wagumisha urupapuro ari ibanga
Gerageza inzira imwe utinjiye muri konti
Ubusabe butaziguye bufite akamaro kimwe na buto isanzwe.
Ibisobanuro, urugero rusobanuye n'imyitozo
Sobanukirwa igitekerezo
Koresha browser profile itinjiyemo koko, cyangwa usohoke wemeze imimerere ya konti, hanyuma usabe umufasha gusaba ya nyandiko imwe mu buryo butaziguye. Irindi dirishya ry’ibanga rishobora gusangira session isanzwe. Subiramo ubusabe bw’inyandiko winjiye wemejwe.
Igisubizo cy'utarinjira ntikigomba kubamo inyandiko; uwinjiye wemewe agomba kuyakira. Ubusabe bwananiranye bugomba kuguma ari ikosa ritamena ibirimo.
Urugero rufatika
Gukuraho ihuza ryo muri menu ntibirinda aderesi ryafunguraga.
Dosiye z'iyi ntambwe
Tangirira hanoDosiye z'imyitozo
Fungura cyangwa umanure dosiye zikurikira. Iyo ubika umushinga, komeza imiterere y’ububiko igaragazwa mu mazina ya dosiye.
Gerageza ubwawe
Igerageza ritaziguye utinjiye n'iryo winjiye, buri rimwe ryasubije iki?
Erekana igisubizo gisobanuye
Inyandiko y’ubusabe butaziguye y’icyitegererezo: “Ntinjiye: inzira y’inyandiko yagaruye Sign in required nta nyandiko. Ninjiye nka A: inzira imwe yagaruye inyandiko y’impimbano. Umufasha yafashije kureba ibikubiye muri ibyo bisubizo tutasangije tokens.”
Niba igisubizo cy’utinjiye kirimo inyandiko, uburinzi bwo kugeraho bwatsinzwe n’iyo urupapuro rwayihishe. Niba serivisi yo kwemeza konti itaboneka, andika icyo kibazo gitandukanye n’ubusabe busanzwe bwanzwe.
Ibigize igisubizo gikwiye
- Agereranya inzira imwe y’inyandiko mu busabe butinjiyemo no mu busabe bw’uwinjiye wemerewe.
- Agenzura ko ibisubizo byanze uburenganzira cyangwa byabiranye bitarimo inyandiko y’ibanga.
Uko bikora (si itegeko)
Gerageza endpoint utanyuze mu migaragarire
Igerageza nyaryo ry'uburenganzira ryerekeza ku cyifuzo cy'amakuru mu buryo butaziguye.
Saba URL ya function mu idirishya rishya nta Authorization header; ntigomba gusubiza inyandiko. Gerageza bearer token yanditse nabi, hanyuma ukoreshe UI y'uwinjiye utange icyifuzo cyemewe.
Sohoka kandi urebe ko porogaramu isiba inyandiko yagaragazwaga kandi ntiyongere kohereza token ya session. Token yatanzwe mbere ishobora gukomeza kwemerwa kugeza igihe cyayo cyagenwe kirangiye; kuyitesha agaciro ako kanya hose ni ikindi cyifuzo gitandukanye.
Urugero rusobanuye
Icyifuzo kitaziguye cyanzwe cyerekana ibirenze ifoto ya ekara y'ubuto yo kwinjira. Bika muri ya nyandiko status y'igisubizo n'uko inyandiko irinzwe yari irimo cyangwa itarimo.
Undi mwitozo wa tekiniki
Icyifuzo kitaziguye gisubiza 401 nta nyandiko, mu gihe session yemejwe yakira inyandiko. Ni uwuhe mupaka wagerageje?
Erekana igisubizo gisobanuye
Wagerageje ko iyi endpoint yemeza umwirondoro mbere yo gusubiza inyandiko isangiwe. Izindi endpoints n'amategeko ya nyir'amakuru bikenera ibizamini byabyo.
- Hagaragazwa umupaka w'igisubizo cya seriveri.
- Ntihavugwa ko tokens ziteshwa agaciro hose cyangwa ko hari uburenganzira bwa buri ukoresha burenze uru rugero.

Intambwe 4 · Uko wagumisha urupapuro ari ibanga
Rinda akandi gaciro kamwe k'igerageza
Subiramo amagenzura amwe nyuma y'impinduka nto.
Ibisobanuro, urugero rusobanuye n'imyitozo
Sobanukirwa igitekerezo
Saba umufasha kongeramo agaciro ka kabiri k'impimbano kaguma kuri seriveri gusa akoresheje itegeko rimwe ry'abagenewe amakuru. Ntujyane kimwe muri ibyo byombi muri dosiye rusange ugamije korohereza gusa.
Subiramo ibyo wiboneye ku byemewe, ibyanzwe n'ibyananiranye. Kuramo amakuru y'ibanga mu byo uhererekanya ugaragaze igerageza ryose ritakozwe.
Urugero rufatika
Kongeramo undi mwanya ntibigomba gutuma inyandiko y'ibanga ya mbere ijya ku karubanda ku bw'impanuka.
Dosiye z'iyi ntambwe
Tangirira hanoDosiye z'imyitozo
Fungura cyangwa umanure dosiye zikurikira. Iyo ubika umushinga, komeza imiterere y’ububiko igaragazwa mu mazina ya dosiye.
Gerageza ubwawe
Tanga uburinzi bw'agaciro gashya n'ibisubizo wiboneye byo kukageraho.
Ibyo ugomba gukora: Inzira y'umwitozo ikora n'amagenzura wiboneye yo kugeraho utinjiye, winjiye no mu gihe cy'ikosa.
Erekana igisubizo gisobanuye
Inyandiko y’inyongera y’icyitegererezo: “Nongeye ahantu h’inama h’impimbano iruhande rw’inyandiko ya mbere y’abanyamuryango. Umunyamuryango w’igerageza wemejwe yakiriye byombi; ubusabe butaziguye ntinjiye muri konti ntibwakiriye na kimwe. Nateje nkana kutaboneka k’iyemeza muri uyu mushinga ushobora gusibwa, igisubizo kiguma ari ikosa kitarimo na kimwe.”
Inyandiko y’ibyakozwe ishobora kuvuga imyanya ibiri n’ibyavuyemo idasubiyemo ibiyirimo. Niba ikibazo gishoboka kitageragejwe, cyandike nk’ikitageragejwe aho gufata igisubizo kimwe cy’uwinjiye nk’icyemeza buri mupaka.
Ibigize igisubizo gikwiye
- Agumana indangagaciro zombi z’impimbano kuri seriveri gusa, akurikije itegeko ry’abanyamuryango basangira ryavuzwe.
- Asubiramo ibisubizo by’uwemerewe, uwangiwe n’igihe serivisi itabonetse kuri ya gaciro gashya.
Uko bikora (si itegeko)
Umukoro wawe: ongeraho agaciro ka kabiri karinzwe
Gumisha agaciro gashya hanze ya dosiye za rusange kandi ukoreshe amagenzura amwe ya seriveri.
Ongeraho akandi gaciro ko kwitoza mu bidukikije bya seriveri, ugasubize gusa nyuma yo kwemeza kandi ukerekane mu buryo butekanye nk'inyandiko. Gumisha igisubizo kitabikwa muri cache.
Subiramo ibizamini bya token ibura, token itemewe na session yemewe. Shakisha muri kode ya rusange kugira ngo wemeze ko nta gaciro k'ibanga na kamwe kashyizwemo.
Urugero rusobanuye
Umukoro wagura igisubizo kirinzwe, aho kongera ubwinshi bw'amakuru yoherezwa mbere yo kwinjira.
Ubuyobozi bwuzuye bw'urugero buri muri reference/assignment-walkthrough.txt. Gereranya intambwe zabwo n'ibyo wakoze; uzuza inyandiko y'igerageza ukurikije ibyo wabonye mu mushinga wawe.
Undi mwitozo wa tekiniki
Rinda agaciro ka kabiri kandi utange ibimenyetso by'uburenganzira bwemewe n'ubwanzwe.
Erekana igisubizo gisobanuye
Hamagara endpoint ya private-note mu buryo butaziguye nta Authorization header: tegereza 401 nta nyandiko. Bearer token yahimbwe na yo igomba kwangwa. userId ya mushakisha cyangwa buto ihishe ntibyuzuza igenzura ry'umwirondoro rya seriveri.
Ukoresheje token ya session yawe nyayo yemejwe mu mushinga wawe wo kwitoza, tegereza inyandiko yagenwe kuri seriveri na Cache-Control: private, no-store. Gumisha inyandiko hanze ya HTML/JavaScript za rusange. Ntushyire bearer token nyayo muri raporo y'igerageza isangiwe.
Nyuma yo gusohoka, UI igomba gukuraho ibirimo by'ibanga no guhagarika ibyifuzo by'umwirondoro wemejwe. Access token yari yamaze gukopororwa ishobora gukomeza gukoreshwa kugeza irangiye: imyitwarire ya UI yo gusohoka si isezerano ryo gutesha token agaciro ako kanya. Iyi myitozo y'inyandiko isangiwe yemerera abinjiye; uburenganzira bwa buri ukoresha ni umwitozo wihariye w'umwirondoro.
- Agaciro kose kaguma kuri seriveri kugeza uburenganzira bwemejwe.
- Ibyifuzo bitaziguye bitemerewe ntibirimo agaciro na kamwe; uburenganzira bwemewe n'imikorere ya no-store biragenzurwa.
Iri somo ryagufashije?
Kanda ko urikunze, cyangwa urisangize uwo ryafasha.