MasomoJinsi ya kuwaruhusu watumiaji kupakia picha

Somo fupi 14 kati ya 30 · Akaunti na ufikiaji

Elewa mwonekano wa awali unathibitisha nini

Somo hili ni la nani?

Kwa watu wanaotaka wageni wapakie picha. Unaweza kutumia mradi ulio tayari na msaidizi wa programu bila kuandika sera za hifadhi au msimbo wa kupakia.

Jina la faili lililochaguliwa, upload iliyohifadhiwa na picha inayosomeka ni matokeo matatu tofauti.

Utakachojifunza katika somo hili

  • Tofautisha mwonekano wa awali wa ndani ya kifaa na faili iliyopakiwa na kuhifadhiwa.
  • Jaribu faili zilizotolewa zinazokubaliwa na zinazokataliwa.
  • Kagua ufutaji wa mwenye akaunti pekee na mipaka ya akaunti nyingine.
Maelezo, mfano uliotatuliwa na zoezi

Kabla ya kuanza

Mradi tofauti wa Supabase wa mazoezi wenye akaunti mbili za majaribio unazodhibiti. Faili ndogo, kubwa kupita kiasi na isiyokubaliwa zimetolewa. Mwombe msaidizi aandae hifadhi binafsi ya avatars na sera zilizotolewa kwenye mradi huu wa kutupwa.

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.

  1. Jinsi ya kuwaruhusu watu kuingia kwenye tovuti yako

    Omba na utumie msimbo halisi wa kuingia kwenye akaunti.

Muda unaokadiriwa: 25–42 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. Zoezi linahusu hifadhi ya picha yenye mipaka na umiliki. Ukaguzi wa kivinjari na mipangilio ya MIME si mfumo kamili wa kukagua programu hasidi/maudhui kwa faili yoyote inayopakiwa na umma.

Elewa wazo

Fungua programu na msaidizi na chagua fixtures/avatar-small.webp. Kabla ya kubofya Upload image, kichagua faili kinaonyesha jina ulilochagua. Mfano huu hauonyeshi picha ya ndani wakati wa kuchagua; picha huonekana baada ya upload na ufikiaji uliosainiwa kufaulu.

Programu nyingine zinaweza kuonyesha picha ya ndani bila kuihifadhi. Hapa pia kuchagua jina pekee hakuthibitishi upload ya mbali. Tofautisha kuchagua, kuhifadhi kwa mtoa huduma na kusoma picha baadaye.

Mfano halisi

Kuchagua avatar-small.webp kunaweza kuonyesha jina kabla ya akaunti ya hifadhi kusanidiwa. Kuthibitisha hifadhi ya mbali baadaye, pata object kwa mtoa huduma na uhakiki mwonekano uliosainiwa unaoisoma.

Tumia warsha kamili ya kupakia picha na mradi wangu wa Supabase wa kutupwa. Nisaidie kusanidi kuingia, bucket binafsi ya avatars, kikomo kilichotajwa cha MB 2 na miundo ya picha inayoruhusiwa kwa sera zilizotolewa. Usiweke funguo binafsi kwenye faili za umma. Endesha ukurasa na uniongoze kwenye majaribio ya faili ndogo, kubwa kupita kiasi na isiyokubaliwa na ukaguzi wa kufuta kwa akaunti tofauti. Shughulikia mabadiliko ya msimbo kwa ajili yangu.

Faili za hatua hii

fixtures/avatar-small.webp
fixtures/avatar-small.webpPakua faili hii

Anza hapaFaili za mazoezi

Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.

Jaribu mwenyewe

Chagua picha ndogo iliyotolewa bila kuipakia. Kichagua faili kinaonyesha nini, na ushahidi gani wa kuhifadhi/kusoma bado haupo?

Onyesha mfano wa suluhisho

Matokeo ya mfano kabla ya upload: “Kuchagua avatar-small.webp kulionyesha jina lake katika kichagua faili. Bado hakuna picha iliyopakiwa iliyoonekana. Sijabofya Upload image wala kupata object iliyohifadhiwa.”

Bado nahitaji kupakia, kupata object kwa mtoa huduma na kukagua mwonekano wake wa muda mfupi. Programu nyingine zinaweza kuonyesha picha ya ndani kabla ya upload; hilo pia halithibitishi kuhifadhi mbali.

Mambo yanayopaswa kuwamo katika jibu sahihi

  • Anaripoti jina lililochaguliwa tofauti na picha inayoonyeshwa baada ya upload.
  • Anataja object ya mtoa huduma na usomaji uliofaulu baadaye kama ushahidi unaohitajika.
Jinsi inavyofanya kazi (si lazima)

Hifadhi picha, si hakiki ya ndani pekee

Hakiki inayotengenezwa kutoka faili lililochaguliwa haithibitishi huduma ya kuhifadhi imelipokea.

Kivinjari hushikilia kwanza faili lililochaguliwa. Kupakia hutuma baiti zake kwenye huduma ya kuhifadhi faili kama objects, ambayo hulipa njia na kutekeleza kanuni za ufikiaji.

Tutatumia bucket ya siri ya Supabase yenye folda moja ya mmiliki kwa kila akaunti. Programu hupakia faili, kisha huomba URL iliyosainiwa ya hakiki ya muda mfupi. Haifanyi kila picha iliyopakiwa isomeke na umma.

Mfano uliotatuliwa

Hakiki ya blob: ya ndani inaweza kufanya kazi bila ombi lolote la mtandao. Jaribio letu litakagua faili lililohifadhiwa kweli na kulipata kupitia njia yenye ruhusa.

Zoezi la ziada la utekelezaji

Picha iliyochaguliwa inaonekana mara moja kwa URL ya blob. Je, lazima upakiaji uwe umefanyika?

Onyesha mfano wa suluhisho

Hapana. Hakikisha kitendo cha kuhifadhi na faili linalolingana kabla ya kudai limepakiwa.

  • Anatenganisha hakiki ya ndani na hifadhi ya mbali.
  • Anakagua matokeo ya kupakia na faili lililohifadhiwa.

Hatua 1 · Jinsi ya kuwaruhusu watumiaji kupakia picha

Andaa hifadhi binafsi ya majaribio

Tumia mipangilio iliyotolewa na msaidizi kwa usanidi.

Maelezo, mfano uliotatuliwa na zoezi

Elewa wazo

Katika mradi wako wa kutupwa, mwombe msaidizi asanidi bucket binafsi ya avatars, mipaka ya ukubwa na umbizo na policies.sql. Anzisha programu kamili ya kuingia na kupakia kwa HTTP.

Thibitisha bucket ni ya faragha na akaunti na mradi ni vilivyokusudiwa. Usiondoe ulinzi wa hifadhi ili ombi lililoshindwa lifanikiwe.

Mfano halisi

Kiolesura cha mgeni kinaweza kusaidia kukataa faili, lakini huduma ya hifadhi lazima itekeleze kanuni zake pia.

Faili za hatua hii

Anza hapaFaili za mazoezi

Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.

Jaribu mwenyewe

Mipangilio ipi ya hifadhi imetekelezwa, na akaunti yako ya majaribio inaweza kufungua programu inayoendeshwa?

Onyesha mfano wa suluhisho

Rekodi ya mfano: “Msaidizi aliandaa bucket binafsi avatars kwenye mradi wa kufutika, akaweka kikomo cha 2 MB na aina PNG/JPEG/WebP pamoja na sheria za kabrasha la mwenyewe. Programu ya HTTP inafunguka na A anaingia.”

Upload ikishindwa kabla ya ukaguzi huu kukamilika, andika hatua inayokosekana. Kufanya bucket ya umma au kuondoa sheria za umiliki si njia sahihi ya mkato.

Mambo yanayopaswa kuwamo katika jibu sahihi

  • Anataja mradi wa kufutika, bucket binafsi avatars na mipaka ya aina/ukubwa iliyowekwa.
  • Anaandika programu ya kuingia/upload inayoendeshwa na kikwazo cha usanidi bila kudhoofisha ulinzi wa hifadhi.
Jinsi inavyofanya kazi (si lazima)

Unda bucket ya siri na kanuni za mmiliki

Mipangilio ya bucket na sera za ufikiaji hutekeleza sehemu tofauti za kazi.

Unda bucket ya avatars kuwa ya siri. Weka kikomo cha 2MB na aina za MIME zinazoruhusiwa, kisha tumia policies.sql. Majukumu ya kivinjari yaruhusiwe kuingiza na kusoma tu njia zilizo chini ya ID yake iliyothibitishwa ya mtumiaji.

Sifa ya accept kwenye kivinjari hurahisisha uchaguzi, si ukaguzi wa usalama. Kanuni za ukubwa/aina na sera za umiliki za huduma bado hutumika kwa maombi ya moja kwa moja. Lebo za MIME pekee hazithibitishi maudhui yoyote ya faili ni salama; usiwasilishe zoezi hili kuwa huduma kamili ya kuchanganua usalama.

Kwa faili linaloitwa USER_A/avatar-1.webp, storage.foldername(name) hurudisha sehemu za folda; [1] huchagua ya kwanza katika array hii ya PostgreSQL. Lazima ilingane na ID ya mtumiaji aliyethibitishwa. USER_B/avatar-1.webp hushindwa kwa A. Kanuni hii ya hifadhi ni tofauti na chaguo la faili na ukaguzi wa awali wa MIME wa kivinjari.

Sehemu ya kwanza ya njia hubaki ID ya mtumiaji hata kukiwa na folda ndani ya nyingine: USER_A/subfolder/avatar.webp bado ina USER_A kama sehemu ya folda [1]. Njia inayoanza subfolder/USER_A/... haitalingana. Weka ID ya mmiliki kwanza; usilegeze sera ili kukubali njia iliyokosewa.

Mfano uliotatuliwa

Mwanzo wa njia ya folda hutoka kwa mtumiaji aliyeingia, na sera ya hifadhidata huulinganisha na auth.uid(). Kubadilisha njia ya kivinjari kwenda folda ya mtu mwingine hakupaswi kutoa ruhusa.

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: udhibiti wa ufikiaji wa hifadhi

Zoezi la ziada la utekelezaji

Kwa nini kukagua kiendelezi cha faili kwa JavaScript pekee hakutoshi?

Onyesha mfano wa suluhisho

Mwombaji anaweza kutuma ombi la moja kwa moja lenye taarifa tofauti au njia nyingine. Tekeleza bucket inayokusudiwa na kanuni za mmiliki kwenye mpaka wa huduma.

  • Anatambua mwombaji anaweza kupita JavaScript.
  • Anahitaji vizuizi na ukaguzi wa ruhusa kwenye huduma ya hifadhi.

Hatua 2 · Jinsi ya kuwaruhusu watumiaji kupakia picha

Pakia picha ndogo ya jaribio

Kagua kitu kilichohifadhiwa pamoja na picha inayoonekana.

Maelezo, mfano uliotatuliwa na zoezi

Elewa wazo

Ingia kama akaunti A na upakie picha ndogo iliyotolewa. Tafuta kitu chake kwa mtoa huduma na utumie mwonekano wa awali unaotokana nacho au njia ya ufikiaji iliyotiwa saini.

Uhifadhi ukifaulu lakini mwonekano wa awali ukishindwa, chunguza kusoma na mwonekano wa awali kabla ya kupakia nakala nyingine. Hifadhi rejea ya kitu uliyorekodi.

Mfano halisi

Kukosekana kwa mwonekano wa awali hakumaanishi lazima upakiaji wenyewe umeshindwa.

Faili za hatua hii

Anza hapaFaili za mazoezi

Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.

Jaribu mwenyewe

Picha ndogo ilihifadhiwa, na iliweza kusomwa baadaye?

Onyesha mfano wa suluhisho

Rekodi ya mfano: “A alipakia avatar-small.webp. Mtoa huduma alionyesha object chini ya kabrasha la A; nilihifadhi rejea bila siri. Picha ilionekana baadaye kupitia mwonekano uliosainiwa wa muda mfupi.”

Matokeo ya sehemu yanaweza kusema: “Object ipo, lakini mwonekano umeshindwa kufikiwa.” Hilo linahitaji kukagua kusoma/ufikiaji wa object ileile, si kupakia nakala nyingi bila kujua kama hifadhi ilifaulu.

Mambo yanayopaswa kuwamo katika jibu sahihi

  • Anaunganisha upload ya A iliyofaulu na rejea halisi ya object iliyohifadhiwa.
  • Anaandika tofauti kama mwonekano uliosainiwa uliweza kusoma object hiyo.
Jinsi inavyofanya kazi (si lazima)

Pakia kwa njia ya kipekee ya mmiliki

Tumia jina lililotengenezwa badala ya kuamini njia ya mwombaji au kuandika juu ya faili lililopo.

Baada ya kuingia, programu huchagua njia kwa ID iliyothibitishwa na jina la faili la nasibu. Hukagua ukubwa/aina kabla ya kuomba kupakia, lakini huo si mbadala wa udhibiti wa mtoa huduma.

Upakiaji hauwashi upsert. Kuhifadhi kukifaulu lakini kutengeneza URL iliyosainiwa kukishindwa, kiolesura huripoti uchunguzi huo tofauti. Hakisemi “hakuna kilichopakiwa” wakati faili linaweza kuwa tayari lipo.

Mfano uliotatuliwa

Jina lililotengenezwa huepusha kugongana kwa bahati na picha nyingine inayoitwa photo.jpg. Lenyewe si mfumo wa ruhusa.

Zoezi la ziada la utekelezaji

Faili lipo lakini kutengeneza hakiki kumeshindwa. Je, upakie nakala nyingine mara moja?

Onyesha mfano wa suluhisho

Kagua kwanza njia ya faili na sera ya kusoma. Kupakia tena kunaweza kuunda nakala za ziada bila kurekebisha tatizo la hakiki.

  • Anatenganisha mafanikio ya kupakia na ruhusa ya hakiki.
  • Anachunguza sera ya kusoma/njia kabla ya kuunda nakala rudufu.

Hatua 3 · Jinsi ya kuwaruhusu watumiaji kupakia picha

Jaribu hali za kushindwa zilizotolewa

Zoezi lina faili ambazo hazipaswi kupakiwa.

Maelezo, mfano uliotatuliwa na zoezi

Elewa wazo

Tumia fixtures/avatar-too-large.png na fixtures/not-an-image.txt. Rekodi namna ukurasa na hifadhi zinavyojibu. Mwombe msaidizi achunguze kukataliwa kunakochanganya au faili isiyo halali iliyopita.

Faili zilizokataliwa zisigeuke kuwa vitu vilivyohifadhiwa. URL halali iliyotiwa saini inaweza kuruhusu mwenye kiungo kuona picha kwa muda wa uhalali wake; hilo pekee halithibitishi bucket imekuwa ya umma.

Mfano halisi

Kizuizi cha kichaguzi cha faili na utekelezaji halisi wa hifadhi ni ukaguzi tofauti.

Faili za hatua hii

fixtures/avatar-small.webp
fixtures/avatar-small.webpPakua faili hii

Anza hapaFaili za mazoezi

Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.

Jaribu mwenyewe

Nini kilitokea kwa faili kubwa kupita kiasi na zisizokubaliwa, na ulijaribu njia ipi halisi ya ufikiaji?

Onyesha mfano wa suluhisho

Rekodi ya mfano: “PNG kubwa mno ilikataliwa na hakuna object mpya. Faili ya maandishi pia ilikataliwa; msaidizi alisaidia kuijaribu ikiwa kichagua kilificha aina zisizoruhusiwa.”

“URL iliyosainiwa ya picha halali ilifunguka katika muda wake mfupi. Ilionyesha ufikiaji kupitia URL hiyo, si kwamba bucket binafsi imekuwa ya umma.” Kichujio cha kichagua faili pekee si jaribio la moja kwa moja la mipaka ya hifadhi.

Mambo yanayopaswa kuwamo katika jibu sahihi

  • Anaandika tofauti kukataliwa na hali ya hifadhi kwa faili zote mbili batili zilizotolewa.
  • Anatofautisha kusoma kwa muda kupitia kiungo kilichosainiwa na ufikiaji wa umma usio na mipaka.
Jinsi inavyofanya kazi (si lazima)

Hakikisha kukataliwa na ufikiaji wa muda

Jaribu kanuni za huduma na uelewe ruhusa inayotolewa na kiungo kilichosainiwa.

Pakia fixtures/avatar-small.webp kwa akaunti A. Kagua njia yake ya kuhifadhi na ufungue onyesho lililoidhinishwa kwa kiungo kilichosainiwa. Kisha jaribu fixtures/avatar-too-large.png inayozidi 2MiB na fixtures/not-an-image.txt ya aina isiyoruhusiwa; zote zikatazwe. Faili zote tatu zimetolewa.

Tumia B kuomba kiungo kilichosainiwa kwa njia ya A; sera ya mmiliki ikatae. URL iliyosainiwa iliyopewa A kihalali inaweza bado kutumiwa na yeyote anayeipata hadi iishe muda. Kutoka kwenye kivinjari hakubatilishi kila URL iliyotolewa papo hapo.

Mfano uliotatuliwa

Ripoti yenye manufaa huweka njia iliyofichwa taarifa nyeti na muda wa kuisha, si URL nzima ya ufikiaji wa muda.

Zoezi la ziada la utekelezaji

Mtu mwenye URL sahihi iliyosainiwa anafungua picha bila kuingia. Je, hilo pekee linathibitisha sera ya bucket ya siri imeshindwa?

Onyesha mfano wa suluhisho

Hapana. Jaribu kama akaunti isiyo na ruhusa inaweza kutengeneza URL au kusoma bila ruhusa iliyoidhinishwa. Chukulia URL zilizotolewa kuwa nyeti hadi ziishe muda.

  • Anatambua URL zilizosainiwa kuwa ruhusa za muda kwa anayezishikilia.
  • Anatofautisha kutumia URL na ruhusa ya kuitengeneza.

Hatua 4 · Jinsi ya kuwaruhusu watumiaji kupakia picha

Ongeza ufutaji wa mwenye akaunti pekee

Hakiki anayeweza kuondoa kitu kilichopakiwa.

Maelezo, mfano uliotatuliwa na zoezi

Elewa wazo

Mwombe msaidizi aongeze kufuta kwa mwenyewe kama zoezi linavyoeleza. Kama A, futa object X ya kwanza na uhakiki haipo. Pakia Y mpya kama A; weka rejea yake bila siri kwa ukaguzi unaofuata.

Katika kikao tofauti cha B, msaidizi ajaribu kufuta Y moja kwa moja. Andika mtendaji B, lengwa Y na matokeo, kisha hakiki Y ya A bado ipo. Kukagua kitufe kilichofichwa tu au kujaribu kufuta X iliyokwishaondoka hakuthibitishi mpaka wa umiliki.

Mfano halisi

Kuondoa picha kwenye skrini si sawa na kufuta kitu kilichohifadhiwa.

Faili za hatua hii

fixtures/avatar-small.webp
fixtures/avatar-small.webpPakua faili hii

Anza hapaFaili za mazoezi

Fungua au pakua faili zilizo hapa chini. Unapohifadhi mradi, hifadhi muundo wa folda unaoonyeshwa katika majina ya faili.

Jaribu mwenyewe

Toa ufutaji wa mwenye akaunti na jaribio la akaunti ya pili pamoja na matokeo halisi ya vitu.

Unachopaswa kuandaa: Matokeo ya kupakia na kufuta na ukaguzi halisi wa faili halali, kubwa kupita kiasi, isiyokubaliwa na kati ya akaunti.

Onyesha mfano wa suluhisho

Rekodi ya mfano: “A alifuta X na mtoa huduma akathibitisha haipo. A akapakia Y mpya. Kikao tofauti cha B kilijaribu kufuta Y; A alihakiki Y bado ipo.”

Msaidizi ataje mtendaji B na lengwa Y kabla ya kuendesha jaribio lililotengwa. Kufuta X tena kungejaribu object ambayo tayari haipo, si ulinzi wa mwenyewe pekee.

Mambo yanayopaswa kuwamo katika jibu sahihi

  • Anafuta object ya kwanza ya A kama mwenyewe na kuthibitisha object hiyo kamili haipo.
  • Anapakia object mpya ya A, anaijaribu kutoka B na kuhakiki bado imehifadhiwa.
Jinsi inavyofanya kazi (si lazima)

Kazi yako: ongeza kufuta kwa mmiliki pekee

Kitendo kipya kinahitaji sera yake na majaribio yake ya kukataliwa.

Ongeza kidhibiti cha kufuta faili lililopakiwa na sera ya DELETE yenye mipaka ya folda ya mmiliki. Usipanue bucket iwe sehemu ya pamoja ya umma.

Hakikisha A anaweza kufuta faili lake na B hawezi. Weka hali ya hifadhi ilingane na kiolesura baada ya kufuta kushindwa.

Mfano uliotatuliwa

Sera za awali huruhusu kuingiza/kusoma pekee kimakusudi. Ruhusa ya kupakia haitoi moja kwa moja ruhusa ya kufuta.

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

Tekeleza kufuta kwa mmiliki pekee na uonyeshe majaribio yanayoruhusiwa na yanayokatazwa.

Onyesha mfano wa suluhisho

Tumia bucket ya siri ya avatars yenye mipangilio ya ukubwa/aina ya huduma na sera za folda ya mmiliki. Pakia picha inayoruhusiwa kama A; kagua matokeo ya hifadhi, kisha ufungue hakiki iliyosainiwa ya muda mfupi. Hakiki ya blob pekee haithibitishi kupakia kwa mbali.

Jaribu faili lisiloruhusiwa au kubwa mno na ujaribu kupakia/kusoma chini ya folda ya B. A asipate ruhusa kwa kubadilisha tu njia kwenye zana za msanidi. URL zilizosainiwa hutoa kwa makusudi ufikiaji wa muda hadi ziishe.

Kwa kufuta, ongeza sera ya DELETE yenye sharti lilelile la bucket/folda ya mmiliki na uite remove kwa njia halisi iliyohifadhiwa. Hakikisha faili halipo baadaye na kufuta kutoka akaunti nyingine hakuondoi faili la mmiliki wake. Moduli ya marejeo ya kufuta imetenganishwa ili ukague njia na sera kabla ya kuiunganisha.

  • Ruhusa ya kufuta hukagua bucket na folda ya mmiliki aliyethibitishwa.
  • Majaribio yanayoshindwa hayafuti faili la akaunti nyingine wala kuondoa kwa uongo taarifa kwenye kiolesura.

Somo hili lilikufaa?

Bonyeza kupenda au mshirikishe mtu anayeweza kufaidika nalo.