Isomo rigufi · Kinyarwanda

Uko wakwemerera abakoresha kohereza amashusho

Ohereza amashusho y'igerageza watanzwe, wongere uyafungure uyasibe, ugenzure ingano ntarengwa na konti iyafite.

Tangira isomo rikorwamo imyitozoSoma inyandiko z’isomo

Ibi bigenewe nde?

Abashaka ko abashyitsi bohereza amashusho. Ushobora gukoresha umushinga witeguye n'umufasha wo kwandika kode utanditse politiki z'ububiko cyangwa kode yo kohereza.

Mbere yo gutangira

Umushinga utandukanye wa Supabase w'umwitozo ufite konti ebyiri z'igerageza ugenzura. Dosiye nto, irenze ingano n'itemewe biratanzwe. Saba umufasha gutegura ububiko bw'ibanga bwa avatars na politiki zatanzwe muri uyu mushinga ushobora kujugunywa.

Igihe kigereranyijwe: 25–42 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. Uyu mwitozo urebana no kubika amashusho mu buryo bugenzurwa n'uburenganzira bwa nyirayo. Igenzura ryo muri porogaramu y'umukoresha n'imiterere ya MIME ntibigize uburyo bwuzuye bwo gusuzuma virusi n'ibikubiye muri dosiye zose zoherezwa ku mugaragaro.

Ibyo uziga

  • Tandukanya kureba ishusho kuri mudasobwa n'iyoherezwa ryabitswe.
  • Gerageza dosiye zemewe n'izangwa watanzwe.
  • Genzura ko gusiba bigenewe nyirayo gusa n'imbibi z'indi konti.

Dosiye z'imyitozo

Intambwe 1

Sobanukirwa icyo kureba ishusho byemeza

Izina rya dosiye yahiswemo, dosiye yabitswe n’ishusho ishobora gusomwa ni ibintu bitatu bitandukanye.

Fungura porogaramu watanzwe ufashijwe n’umufasha uhitemo fixtures/avatar-small.webp. Mbere yo gukanda Upload image, umwanya wa dosiye werekana izina wahisemo. Uyu mushinga ntwerekana ishusho ya dosiye yo kuri mudasobwa igihe ihiswemo; ishusho iza nyuma yo kohereza no kuyigeraho hakoreshejwe uburenganzira bwashyizweho umukono.

Izindi porogaramu zishobora kwerekana ishusho yo kuri mudasobwa zitayibitse. No muri iyi, guhitamo izina ryonyine ntibyemeza kohereza kuri serivisi. Tandukanya guhitamo, kubika muri serivisi no gusoma ishusho nyuma.

Urugero rufatika

Guhitamo avatar-small.webp bishobora kwerekana izina rya dosiye mbere y’uko konti y’ububiko itegurwa. Mu kwemeza ububiko bwa kure nyuma, shakisha ikintu cyoherejwe muri serivisi urebe ishusho isomwa hakoreshejwe ihuriro ryashyizweho umukono.

Koresha umwitozo wuzuye wo kohereza amashusho n'umushinga wanjye wa Supabase ushobora kujugunywa. Mfasha gushyiraho kwinjira, bucket y'ibanga ya avatars, ingano ntarengwa yavuzwe ya 2 MB n'ubwoko bw'amashusho bwemewe ukoresheje politiki zatanzwe. Ntushyire imfunguzo z'ibanga muri dosiye rusange. Koresha urupapuro unyobore mu kugerageza dosiye nto, irenze ingano n'itemewe no mu kugenzura gusiba muri konti zitandukanye. Nkorera impinduka za kode.

Dosiye z'iyi ntambwe

fixtures/avatar-small.webp
fixtures/avatar-small.webpKuramo iyi dosiye

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)

Bika ishusho, ntugarukire ku kuyireba kuri mudasobwa yawe

Kureba dosiye watoranyije by'agateganyo si gihamya ko serivisi y'ububiko yayakiriye.

Mushakisha ibanza gufata dosiye yatoranyijwe. Kuyohereza bituma bytes zayo zijya muri serivisi y'ububiko bwa objects, ikayiha inzira kandi igashyira mu bikorwa amategeko y'uburenganzira.

Turakoresha bucket yihariye ya Supabase, ifite ububiko bwa nyirayo kuri buri konti. Porogaramu yohereza dosiye, hanyuma igasaba URL yo kuyireba yashyizweho umukono kandi imara igihe gito. Ntituma buri dosiye yoherejwe isomwa n'abantu bose.

Urugero rusobanuye

Ishusho yerekanwa hifashishijwe blob: yo kuri mudasobwa ishobora gukora nta busabe bwo ku muyoboro bubaye. Igerageza ryacu rirareba object yabitswe koko kandi riyigarure rinyuze mu nzira ifitiwe uburenganzira.

Extra implementation exercise

Ishusho watoranyije ihise igaragara binyuze muri blob URL. Ese byanze bikunze yamaze koherezwa?

Erekana igisubizo gisobanuye

Oya. Banza ugenzure igikorwa cyo kubika na object ihuye na cyo mbere yo kuvuga ko dosiye yoherejwe.

  • Atandukanya kureba dosiye kuri mudasobwa no kuyibika kure.
  • Agenzura igisubizo cyo kohereza na object yabitswe.

Intambwe 2

Tegura ububiko bw'ibanga bw'igerageza

Koresha igenamiterere watanzwe n'umufasha mu gutegura.

Mu mushinga wawe ushobora kujugunywa, saba umufasha gushyiraho bucket y'ibanga ya avatars, imbibi z'ingano n'ubwoko na policies.sql. Tangiza porogaramu yuzuye yo kwinjira no kohereza kuri HTTP.

Emeza ko bucket ari iy'ibanga kandi konti n'umushinga ari byo bigamijwe. Ntukureho uburinzi bw'ububiko kugira ngo ubusabe bwanze butsinde.

Urugero rufatika

Urupapuro rw'umushyitsi rushobora gufasha kwanga dosiye ariko serivisi y'ububiko na yo igomba kubahiriza amategeko yayo.

Supabase: kugenzura uburenganzira ku bubiko

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)

Kora bucket yihariye n'amategeko ya nyirayo

Imiterere ya bucket n'amategeko y'uburenganzira bishyira mu bikorwa ibice bitandukanye by'umurimo.

Kora bucket ya avatars ibe iy'ibanga. Shyiraho umupaka wa 2MB n'ubwoko bwa MIME bwemewe, hanyuma ukoreshe policies.sql. Uburenganzira bwa database bukoreshwa n'ibyifuzo biva muri mushakisha bugomba kwemerera gusa kwinjiza no gusoma inzira ziri munsi ya ID y'umukoresha yemejwe.

Attribute ya accept yo muri porogaramu y'umukoresha ni iyo korohereza gutoranya, si igenzura ry'umutekano. Amategeko ya serivisi ku ngano n'ubwoko hamwe n'amategeko ya nyirabyo agomba no gukurikizwa ku busabe bwoherejwe butaziguye. Ibirango bya MIME byonyine ntibyemeza ko ibikubiye muri dosiye iyo ari yo yose bitekanye; ntugaragaze uyu mwitozo nk'aho ari serivisi yuzuye yo gusikana dosiye.

Kuri object yitwa USER_A/avatar-1.webp, storage.foldername(name) igarura ibice by'ububiko; [1] ihitamo igice cya mbere muri iyi array ya PostgreSQL. Kigomba kungana na ID y'umukoresha winjiye muri konti. USER_B/avatar-1.webp yangwa kuri konti A. Iri tegeko ryo mu bubiko ritandukanye n'ihitamo rya dosiye rya mushakisha n'igenzura ribanza rya MIME.

Igice cya mbere cy'inzira kiguma ari ID y'umukoresha n'ubwo haba harimo ububiko bwimbikanye: USER_A/subfolder/avatar.webp iracyafite USER_A nk'igice cy'ububiko [1]. Inzira itangirira kuri subfolder/USER_A/... ntiyahura n'itegeko. Shyira ID ya nyirayo imbere; ntugabanye ubukana bw'itegeko gusa kugira ngo ryemere inzira yanditswe nabi.

Urugero rusobanuye

Intangiriro y'inzira y'ububiko ikomoka ku mukoresha winjiye muri konti, naho itegeko rya database rikayigereranya na auth.uid(). Guhindura inzira muri mushakisha ukayerekeza mu bubiko bw'undi mukoresha ntibigomba gutanga uburenganzira.

create policy "upload own avatar" on storage.objects for insert to authenticated
with check (bucket_id='avatars' and (storage.foldername(name))[1]=auth.uid()::text);
create policy "read own avatar" on storage.objects for select to authenticated
using (bucket_id='avatars' and (storage.foldername(name))[1]=auth.uid()::text);

Supabase: kugenzura uburenganzira ku bubiko

Extra implementation exercise

Kuki kugenzura umugereka w'izina rya dosiye muri JavaScript gusa bidahagije?

Erekana igisubizo gisobanuye

Usaba ashobora kohereza ubusabe butaziguye burimo metadata cyangwa inzira bitandukanye. Shyira mu bikorwa amategeko ya bucket na nyirayo ateganyijwe ku mupaka wa serivisi.

  • Amenya ko usaba ashobora kurenga JavaScript.
  • Asaba imipaka n'iyemezwa ry'uburenganzira byo ku ruhande rw'ububiko.

Intambwe 3

Ohereza ishusho nto y'igerageza

Genzura ikintu kibitswe kimwe n'ishusho igaragara.

Injira nka konti A wohereze ishusho nto watanzwe. Shaka ikintu cyayo kibitswe muri serivisi ukoreshe ukureba ishusho cyangwa inzira y'uburenganzira yashyizweho umukono yavuyeho.

Niba kubika byatsinze ariko kureba ishusho bikananirana, suzuma gusoma cyangwa kureba mbere yo kohereza indi kopi. Gumana ikiranga ikintu kibitswe wanditse.

Urugero rufatika

Kubura ishusho yo kureba ntibisobanura buri gihe ko kohereza ubwabyo byanze.

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 mu nzira yihariye ya nyirayo

Koresha izina ryakozwe na porogaramu aho kwizera inzira y'usaba cyangwa gusimbuza dosiye isanzwe.

Nyuma yo kwinjira muri konti, porogaramu ihitamo inzira ikoresheje ID y'umukoresha yemejwe n'izina rya dosiye ryatoranyijwe mu buryo bwa random. Igenzura ingano n'ubwoko bw'ishusho mbere yo gusaba kuyohereza, ariko iryo genzura ntirisimbura amategeko ya serivisi.

Kohereza ntibyemera upsert. Niba kubika byagenze neza ariko gukora signed URL bikanga, UI ibigaragaza nk'ibintu bibiri bitandukanye byabonetse. Ntivuga ngo “nta cyoherejwe” kandi object ishobora kuba isanzwe ihari.

Urugero rusobanuye

Izina rya dosiye ryakozwe na porogaramu ririnda kugongana ku bw'impanuka n'indi foto yitwa photo.jpg. Ryonyine si uburyo bwo gutanga uburenganzira.

Extra implementation exercise

Object irahari, ariko gukora uburyo bwo kuyireba byanze. Ese ugomba guhita wohereza indi kopi?

Erekana igisubizo gisobanuye

Banza ugenzure inzira ya object n'itegeko ryo kuyisoma. Kongera kuyohereza bishobora gukora kopi nyinshi bidakemuye ikibazo cyo kuyireba.

  • Atandukanya kohereza byagenze neza n'uburenganzira bwo kureba.
  • Asuzuma itegeko ryo gusoma n'inzira mbere yo gukora kopi nyinshi.

Intambwe 4

Gerageza ibibazo byo kunanirwa watanzwe

Umwitozo urimo dosiye zitagomba koherezwa.

Koresha fixtures/avatar-too-large.png na fixtures/not-an-image.txt. Andika uko urupapuro n'ububiko bisubiza. Saba umufasha gusuzuma iyangwa ritumvikana cyangwa dosiye itemewe yanyuze.

Dosiye zanzwe ntizigomba guhinduka ibintu bibitswe. URL yemewe yashyizweho umukono ishobora kwemerera uyifite kureba ishusho igihe ikiriho; ibyo byonyine si gihamya ko bucket yabaye rusange.

Urugero rufatika

Imbibi zo mu mwanya wo guhitamo dosiye n'amategeko nyayo y'ububiko ni amagenzura atandukanye.

Dosiye z'iyi ntambwe

fixtures/avatar-small.webp
fixtures/avatar-small.webpKuramo iyi dosiye

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)

Genzura kwangwa n'uburenganzira bw'igihe gito

Gerageza amategeko ya serivisi kandi usobanukirwe uburenganzira butangwa n'ihuriro ryashyizweho umukono.

Ohereza fixtures/avatar-small.webp ukoresheje konti A. Reba aho yabitswe maze ufungure ishusho ukoresheje ihuza ryashyizweho umukono ryemewe. Gerageza fixtures/avatar-too-large.png irenze 2MiB na fixtures/not-an-image.txt y’ubwoko butemewe; zombi zigomba kwangwa. Dosiye zose uko ari eshatu zatanzwe.

Koresha konti B usabe ihuriro ryashyizweho umukono ry'inzira ya A; itegeko rya nyirayo rigomba kubyanga. Signed URL yahawe A mu buryo bwemewe ishobora gukomeza gukoreshwa n'umuntu wese uyibonye kugeza irangiye. Gusohoka muri konti muri porogaramu ntibihita bivanaho buri URL yatanzwe.

Urugero rusobanuye

Raporo ifite akamaro yandika inzira yahishwemo amakuru y'ibanga n'igihe ihuriro rimara, aho kwandika URL yose itanga uburenganzira bw'igihe gito.

Extra implementation exercise

Umuntu ufite signed URL ikiri gukora afunguye ishusho atinjiye muri konti. Ese ibyo byonyine byemeza ko itegeko rya bucket yihariye ryananiwe?

Erekana igisubizo gisobanuye

Oya. Gerageza niba konti itabifitiye uburenganzira ishobora gukora URL cyangwa gusoma nta burenganzira bwemewe ifite. Fata URLs zatanzwe nk'amakuru y'ibanga kugeza igihe zirangiriye.

  • Amenya ko signed URLs ari uburenganzira bw'igihe gito bukoreshwa n'uwufite ihuriro.
  • Atandukanya gukoresha URL n'uburenganzira bwo kuyikora.

Intambwe 5

Ongeramo gusiba kwa nyir'ikintu gusa

Emeza uwashobora gukuraho ikintu cyoherejwe.

Saba umufasha kongeramo imyitwarire yo gusiba ya nyirayo yatanzwe. Nka A, siba ikintu cya mbere X wemeze ko kitakiri mu bubiko. Hanyuma A yohereze ikindi gishya Y; bika ikiranga cya Y gihishwe amakuru bwite ku genzura rikurikira.

Muri session yihariye ya B, saba umufasha kugerageza gusiba Y mu buryo butaziguye. Andika ukora B, ugamijwe Y n’igisubizo cya serivisi, hanyuma wemeze ko Y ya A igihari. Kureba buto yo gusiba ihishwe gusa, cyangwa kongera kugerageza gusiba X yamaze kubura, ntibyemeza uyu mupaka wa nyirayo.

Urugero rufatika

Gukuraho ishusho kuri ecran si kimwe no gusiba ikintu kibitswe.

Dosiye z'iyi ntambwe

fixtures/avatar-small.webp
fixtures/avatar-small.webpKuramo iyi dosiye

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: ongeramo gusiba byemewe kuri nyirayo gusa

Igikorwa gishya gikeneye itegeko ryacyo n'igerageza ry'ibitemewe.

Ongeramo uburyo bwo gusiba object yoherejwe n'itegeko rya DELETE rigarukira ku bubiko bwa nyirayo. Ntuhindure bucket isanzwe ngo ibe ahantu rusange basangira.

Emeza ko A ashobora gusiba object ya A kandi ko B atabishobora. Nyuma yo gusiba byanze, uko ibintu bimeze mu bubiko bigume guhuza na UI.

Urugero rusobanuye

Amategeko yatanzwe mbere yemera kwinjiza no gusoma gusa ku bushake. Uburenganzira bwo kohereza ntibuhita butanga ubwo gusiba.

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

Shyiraho gusiba byemewe kuri nyirayo gusa kandi werekane igerageza ry'ibyemewe n'ibibujijwe.

Erekana igisubizo gisobanuye

Koresha bucket yihariye ya avatars ifite imiterere y'ingano n'ubwoko ku ruhande rw'ububiko n'amategeko y'ububiko bwa nyirayo. Ohereza ishusho yemewe nka konti A; suzuma igisubizo cyavuye mu bubiko, hanyuma ufungure ishusho ukoresheje ihuriro ryashyizweho umukono rimara igihe gito. Kureba ishusho ya blob byonyine ntibyemeza ko hari icyoherejwe mu bubiko bwa kure.

Gerageza dosiye y'ubwoko butemewe cyangwa irengeje ingano, kandi ugerageze kohereza no gusoma munsi y'ububiko bwa konti B. A ntigomba kubona uburenganzira gusa ihinduye inzira mu bikoresho by'abatekinisiye. Signed URLs zitanga uburenganzira bw'igihe gito kugeza zirangiye nk'uko byateganyijwe.

Ku gusiba, ongeramo itegeko rya DELETE rikoresha igisabwa kimwe cya bucket n'ububiko bwa nyirayo, kandi uhamagare remove ukoresheje inzira nyayo yabitswe. Emeza nyuma ko object itakiriho kandi ko kugerageza gusiba iy'undi bituma object ya nyirayo wundi iguma uko yari iri. Module yo gusiba y'icyitegererezo iri ukwayo kugira ngo usuzume inzira n'itegeko mbere yo kuyihuza na porogaramu.

  • Uburenganzira bwo gusiba bugenzura bucket n'ububiko bwa nyirayo wemejwe.
  • Igerageza ryanze ntirisiba object y'indi konti cyangwa ngo rikureho amakuru muri UI bibeshya.

Iri somo ryagufashije?

Kanda ko urikunze, cyangwa urisangize uwo ryafasha.

Komeza kwiga

Reba andi masomo