Isomo rigufi · Kinyarwanda

Uko wagumisha urupapuro ari ibanga

Koresha umushinga wo kwinjira witeguye ugumane inyandiko y'umwitozo mu ibanga, ugerageze kuyigeraho byemewe n'ibyanzwe.

Tangira isomo rikorwamo imyitozoSoma inyandiko z’isomo

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.

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.

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.

Ibyo uziga

  • Ntushyire ibirimo by'ibanga mu rupapuro rusange.
  • Gerageza inzira imwe utinjiye muri konti n'igihe winjiye.
  • Genzura kwangwa ko kugera ku makuru utagaragaje inyandiko.

Dosiye z'imyitozo

Intambwe 1

Hitamo igikeneye kurindwa

Ibanga risobanura ko umushyitsi utabifitiye uburenganzira atabibona, si ukubihisha gusa.

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

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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

Extra implementation exercise

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 2

Huza uburinzi bwiteguye

Reka umufasha ashyireho amagenzura ya seriveri asanzweho.

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.

Supabase: kubona ukoresha wemejwe · Node.js: imimerere y'uburyo busohotse bushyigikiwe

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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

Extra implementation exercise

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 3

Gerageza abagenewe uburenganzira

Hitamo abakwiriye kwemererwa gusoma iki kintu cyihariye.

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

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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.

Extra implementation exercise

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 4

Gerageza inzira imwe utinjiye muri konti

Ubusabe butaziguye bufite akamaro kimwe na buto isanzwe.

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

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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.

Extra implementation exercise

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 5

Rinda akandi gaciro kamwe k'igerageza

Subiramo amagenzura amwe nyuma y'impinduka nto.

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

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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.

Extra implementation exercise

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.

Komeza kwiga

Reba andi masomo