አጭር ትምህርት · አማርኛ

ገጽን የግል እንዴት ማድረግ ይችላሉ?

የልምምድ ማስታወሻን የግል ለማድረግ ዝግጁ የመግቢያ ፕሮጀክት ይጠቀሙ፣ የተፈቀደና የተከለከለ መዳረሻንም ይፈትሹ።

ተግባቦታዊውን ትምህርት ይጀምሩየትምህርቱን ማስታወሻዎች ያንብቡ

ይህ ለማን ነው?

ገጽ ወይም ማስታወሻ ከመግባት በኋላ ብቻ እንዲገኝ ለሚፈልጉ ሰዎች። የኮድ ጻፊ ረዳት የተሰጠውን ጥበቃ ማገናኘት ይችላል፤ የአገልጋይ ፕሮግራም መጻፍ የትምህርቱ መስፈርት አይደለም።

ከመጀመርዎ በፊት

የተሰጠው የመግቢያ ውቅር ወይም ተመጣጣኝ የSupabase መዳረሻ፣ የተለየ የfunction ማስተናገጃ ፕሮጀክትና የኮድ ጻፊ ረዳት። በአገልጋዩ አካባቢ ብቻ የሚቀመጥ የፈጠራ PRIVATE_NOTE ይጠቀሙ፣ እውነተኛ የግል ይዘት ፈጽሞ አይጠቀሙ።

ግምታዊ ጊዜ: 20–32 ደቂቃ

ግምቶቹ በተሰጡት መነሻ ፋይሎች፣ አስፈላጊ መለያዎችና መሣሪያዎች ተዘጋጅተው ሲሠራ የሚወስደውን ጊዜ ያመለክታሉ። ዝግጅት፣ የማሳተም ወረፋ፣ የኢሜይልና የDNS ጥበቃ ተጨማሪ ጊዜ ይፈልጋሉ። ይህ ምሳሌ የልምምድ ፕሮጀክቱን ሁሉንም ትክክለኛ ተጠቃሚዎች ይፈቅዳል። የእያንዳንዱ ተጠቃሚ መዝገቦችና ሚናዎች ተጨማሪ የፈቃድ ደንቦች ይፈልጋሉ።

ምን ይማራሉ?

  • የግል ይዘትን ከይፋዊው ገጽ ያርቁ።
  • ተመሳሳይ መንገድ ከመለያ ወጥተውና ገብተው ይፈትሹ።
  • ማስታወሻውን ሳያጋልጡ የመዳረሻ ስህተት ይፈትሹ።

የልምምድ ፋይሎች

ደረጃ 1

ጥበቃ የሚፈልገውን ይምረጡ

የግል ማለት ለያልተፈቀደለት ጎብኚ አለመገኘት ነው፣ መደበቅ ብቻ አይደለም።

የተሰጠውን የፈጠራ ማስታወሻና ዝግጁ ፕሮጀክት ይጠቀሙ። ማስታወሻውን በሚወርደው ይፋዊ ገጽ ውስጥ ሳይሆን በአገልጋዩ እንዲያስቀምጥ ረዳቱን ይጠይቁ።

ክፍል ቢደበቅም ጎብኚ ይፋዊ ፋይሎችን መመርመር ይችላል። በልምምዱ እውነተኛ የግል መረጃ አያስገቡ።

ተጨባጭ ምሳሌ

በገጽ ቅጥ የተደበቀ አንቀጽ አሁንም የይፋዊው ፋይል ክፍል ነው።

ይህን የተሟላ የግል ማስታወሻ ልምምድና የእኔን የሚተዳደር የመግቢያ የልምምድ ፕሮጀክት ተጠቀም። PRIVATE_NOTE በግል የአገልጋይ አካባቢ ብቻ አስቀምጥ፣ የተሰጡትንም የመዳረሻ ፍተሻዎች ጠብቅ። መተግበሪያውን ለማስኬድ እርዳኝ፣ ከዚያም ከመለያ ወጥቶ ቀጥታ መድረስን ከተረጋገጠ መግባት ጋር አነጻጽር። አንቀጽ መደበቅን እንደ ጥበቃ አትቁጠር ወይም የሌላ ሰው ውሂብ አታጋልጥ።

የዚህ ደረጃ ፋይሎች

Start hereየልምምድ ፋይሎች

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

How it works (optional)

አዝራሩን ብቻ ሳይሆን ምላሹን ይጠብቁ

የግል ይዘት ከመጀመሪያው ፈቃድ ወደ ሌለው አሳሽ መላክ የለበትም።

በCSS መደበቅና የተሰናከሉ አዝራሮች በይነገጹን ይቀይራሉ፣ ምላሹን አይደለም። ማንም ይፋዊ ፋይሎችን መመርመርና ወደ endpoint ቀጥታ ጥያቄ መላክ ይችላል።

አገልጋያችን ማስታወሻን ከግል የአገልጋይ ቅንብሮቹ ያነባል፣ ለምሳሌ በአገልጋዩ ላይ ወይም በፕሮጀክቱ ዋና አቃፊ ውስጥ ባለው የግል .env ፋይል ከተቀመጠው PRIVATE_NOTE። የተጠቃሚ token ካረጋገጠ በኋላ ብቻ ይመልሰዋል። የልቦለዱ ማስታወሻ ለልምምዱ ነው፤ እውነተኛ የግል ውሂብ በተጠበቀ የውሂብ ምንጭ እንጂ በይፋዊ የኮድ ማከማቻ መቀመጥ የለበትም።

የተሠራ ምሳሌ

«የተደበቀ» ማስታወሻ ያለበት ይፋዊ JavaScript ፋይል አሁንም ይፋዊ ቅጂ ነው። ምሳሌው በምትኩ እሴቱን ከpublic/ ውጭ ያቆያል።

Extra implementation exercise

ገጹ እስኪገቡ ድረስ አንቀጽ ይደብቃል፣ አንቀጹ ግን በHTML ምንጭ ውስጥ አለ። የግል ነው?

የተሠራ መፍትሔ ያሳዩ

አይደለም። ይዘቱን ከመላክዎ በፊት የአገልጋዩን ምላሽ በፈቃድ ይገድቡ። የተቀበለ እሴትን መደበቅ ሚስጥር ሊያደርገው አይችልም።

  • አሳሹ አስቀድሞ መቀበሉን ያውቃል።
  • የመዳረሻ ቁጥጥሩን ከተጠበቀው ምላሽ በፊት ያስቀምጣል።

ደረጃ 2

ዝግጁውን ጥበቃ ያገናኙ

ረዳቱ ያሉትን የአገልጋይ ፍተሻዎች እንዲያዋቅር ያድርጉ።

run-locally.txt ከረዳቱ ጋር ይከተሉ። ከመፈተሽ በፊት የታሰበውን የማንነት ማረጋገጫ ፕሮጀክት፣ ይፋዊ የአሳሽ እሴቶቹን፣ የግል የአገልጋይ ማረጋገጫ ቅንብሮችንና ምናባዊውን PRIVATE_NOTE ያረጋግጡ። ሙሉ ፕሮጀክቱን አስነስተው እውነተኛውን proxy URL ይክፈቱ፤ ተራ የፋይል ቅድመ እይታ ጥበቃውን ማስኬድ አይችልም።

እነዚህ የመለያ/አገልጋይ ዝግጁነት ፍተሻዎች የግድ ናቸው። የfunction አፈጻጸሙን ማንበብ አማራጭ ነው። አገልግሎቱ ማስታወሻውን ከመመለሱ በፊት የመለያውን session ማረጋገጥ አለበት፤ ጠያቂው በጥያቄ ሌላ የመለያ ID መጻፉ የማንነት ማስረጃ አይደለም።

ተጨባጭ ምሳሌ

በተጠቃሚ የተሰጠ ማንነት ከተረጋገጠ የመለያ ክፍለ ጊዜ ጋር አንድ አይደለም።

Supabase፦ የተረጋገጠ ተጠቃሚ ማግኘት · Node.js፦ የሚደገፉ ልቀቶች ሁኔታ

የዚህ ደረጃ ፋይሎች

Start hereየልምምድ ፋይሎች

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

How it works (optional)

የsession token ወደ አገልጋዩ ይላኩ

ደንበኛው bearer token ያቀርባል፤ አገልጋዩ ራሱን ችሎ ያረጋግጠዋል።

በSTART-HERE.txt የመግቢያ ፋይሎቹንና የአገልጋዩን አካባቢ ያዋቅሩ። ደንበኛው የአሁኑን session ያገኛል፣ የግል endpoint ሲጠይቅም የመዳረሻ tokenውን በAuthorization header ይልካል።

አገልጋዩ በዚያ token እና ሊታተም በሚችለው የፕሮጀክቱ የመተግበሪያ ቁልፍ የአቅራቢውን user endpoint ይጠራል። የጎደሉ ወይም የማይሰሩ tokens ይከለክላል፣ የአቅራቢ አለመገኘትንም ከተቀበለ ማንነት ይለያል። tokenን ሳያረጋግጡ መፍታት በቂ አይደለም።

ጥያቄውን በቅደም ተከተል ይከተሉ፦ አሳሹ የተጠቃሚውን የመዳረሻ token ይልካል → አገልጋዩ ያ token ተጠቃሚ ይወክላል ወይ ብሎ የማንነት አቅራቢውን ይጠይቃል → የተረጋገጠ ውጤት ብቻ ማስታወሻውን መመለስ ይፈቅዳል። ሊታተም የሚችለው የፕሮጀክት ቁልፍ መተግበሪያውን ይለያል፤ ብቻውን ሰውየውን አይለይም ወይም ፈቃድ አይሰጠውም።

ለሙሉው በኮምፒውተርዎ የማስኬድ ቅደም ተከተል run-locally.txt ይክፈቱ፦ በፕሮጀክቱ ዋና አቃፊ ውስጥ ባለው የግል .env ፋይል የአገልጋይ ቅንብሮችን ያዘጋጁ፣ ከpublic/ ውጭ እና በGit የማይከታተል መሆኑን ያረጋግጡ፣ የልምምድ ፕሮጀክቱን ብቻ ያገናኙ፣ የNetlify function proxyንም ያስነሱ። server-env.example.txt የተለዋዋጭ ስሞችን ያለ እውነተኛ ሚስጥሮች ይዘረዝራል። HTMLን ብቻ መክፈት አገልጋዩን ማስኬድ አይችልም።

የተሠራ ምሳሌ

በጠሪው የተሰጠ userId መስክ ጠሪው የዚያ ID ባለቤት መሆኑ ማስረጃ አይደለም። በማረጋገጫው የተመለሰውን ማንነት ይጠቀሙ።

const r=await fetch('/.netlify/functions/mini-private-note', {
 headers:{Authorization:'Bearer '+session.access_token}
});

Supabase፦ የተረጋገጠ ተጠቃሚ ማግኘት · Node.js፦ የሚደገፉ ልቀቶች ሁኔታ

Extra implementation exercise

አገልጋዩ ከአሳሽ JSON የመጣ userIdን በማመን ለጥያቄ ፈቃድ ሊሰጥ ይችላል?

የተሠራ መፍትሔ ያሳዩ

አይደለም። አሳሹ ያንን መስክ ሊቀይር ይችላል። የመግቢያ መረጃውን ያረጋግጡ፣ የተረጋገጠውንም ማንነት ይጠቀሙ።

  • የደንበኛ ማንነት መግለጫዎችን የማይታመኑ ይቆጥራል።
  • የተረጋገጠ token እና ከእሱ የመጣ ማንነት ይጠቀማል።

ደረጃ 3

የተፈቀደላቸውን ሰዎች ይፈትሹ

ይህን የተወሰነ ነገር ማን ማንበብ እንዳለበት ይወስኑ።

በሚቆጣጠሩት የሙከራ መለያ ይግቡና የፈጠራ ማስታወሻውን ይጠይቁ። ለዚህ ልምምድ ደንቡ ማንኛውም ማንነቱ ተረጋግጦ የገባ ተጠቃሚ ነው፤ ያንን የተገለጸ ወሰን እንዲጠብቅ ረዳቱን ይጠይቁ።

በኋላ የአንድ ሰው የመለያ ውሂብ ካስቀመጡ፣ ያ ሰፊ ደንብ በቂ አይደለም። ሁሉም የግል ውሂብ ተመሳሳይ ፈቃድ አለው ከማለት ይልቅ የታሰቡትን ሰዎች ይግለጹ።

ተጨባጭ ምሳሌ

የአባላት የጋራ ማስታወሻና የአንድ ሰው የመለያ መዝገብ የተለያዩ የመዳረሻ ውሳኔዎች ይፈልጋሉ።

የዚህ ደረጃ ፋይሎች

Start hereየልምምድ ፋይሎች

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

How it works (optional)

የታሰበውን የተጠበቀ ውሂብ ብቻ ይመልሱ

ትክክለኛ ማንነት የእያንዳንዱን ተጠቃሚ መዝገቦች በራሱ አይፈቅድም።

ይህ ትንሽ ምሳሌ በልምምድ ፕሮጀክቱ ያሉትን ሁሉንም ትክክለኛ ተጠቃሚዎች አንድ የጋራ ማስታወሻ እንዲያዩ ይፈቅዳል። ይህ ግልጽ የፈቃድ ደንብ ነው፣ የግል ይዘት ሁሉን አቀፍ ትርጉም አይደለም።

ምላሹ private, no-store cache ይጠቀማል፣ የጋራ cache ማስታወሻውን እንዳያቆይ። በኋላ ያለው የመገለጫ ትምህርት ለእያንዳንዱ ተጠቃሚ መዝገቦች የባለቤትነት ደንቦችን ይጠቀማል። ይህን handler ወደ ሙሉ የውሂብ ጎታ ማፍሰሻ አያስፉት።

የተሠራ ምሳሌ

የአገልጋዩ viewerId ከማረጋገጥ ይገኛል። ማስታወሻው ከአካባቢው እንጂ በጥያቄው ከተሰጠ ውሂብ አይመጣም።

Extra implementation exercise

ማስታወሻው በሌላ ተጠቃሚ የመለያ ዝርዝሮች ከተተካ፣ «ማንኛውም የገባ ተጠቃሚ» የሚለው ተገቢ ደንብ ሆኖ ይቀጥላል?

የተሠራ መፍትሔ ያሳዩ

አይደለም። የተረጋገጠውን ማንነት ከተጠየቀው መዝገብ ወይም ሚና ጋር የሚያዛምድ ደንብ ያክሉ። መግባት ብቻ ወደ ሌላ መለያ መዳረሻ አይሰጥም።

  • ማንነት ማረጋገጥን ከመዝገብ ደረጃ ፈቃድ ይለያል።
  • ለእያንዳንዱ ተጠቃሚ ውሂብ ባለቤትነት ወይም ተገቢ ሚና ይጠይቃል።

ደረጃ 4

ተመሳሳይ መንገድ ከመለያ ወጥተው ይሞክሩ

ቀጥታ ጥያቄ እንደ መደበኛው አዝራር እኩል አስፈላጊ ነው።

በእውነት ወደ መለያ ያልገባ የአሳሽ ፕሮፋይል ይጠቀሙ፣ ወይም ወጥተው የመለያውን ሁኔታ ያረጋግጡ፤ ከዚያ ረዳቱ ያንኑ ማስታወሻ በቀጥታ እንዲጠይቅ ይጠይቁ። ተጨማሪ የግል አሰሳ መስኮት ያለውን የግል አሰሳ ክፍለ ጊዜ ሊጋራ ይችላል። መግባቱ ከተረጋገጠ በኋላ የማስታወሻውን ጥያቄ ይድገሙ።

ከመለያ ወጥተው የሚያገኙት ውጤት ማስታወሻውን መያዝ የለበትም፤ የተፈቀደው ክፍለ ጊዜ ሊቀበለው ይገባል። ያልተሳካ ጥያቄ ይዘት ሳያፈስ ስህተት ሆኖ ይቆይ።

ተጨባጭ ምሳሌ

የምናሌ አገናኝን ማስወገድ ይከፍተው የነበረውን አድራሻ አይጠብቅም።

የዚህ ደረጃ ፋይሎች

Start hereየልምምድ ፋይሎች

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

How it works (optional)

Endpointን ያለ በይነገጹ ይሞክሩ

እውነተኛ የመዳረሻ ፍተሻ የውሂብ ጥያቄውን በቀጥታ ያነጣጥራል።

የfunction URLን በአዲስ መስኮት ያለ Authorization header ይጠይቁ፤ ማስታወሻውን መመለስ የለበትም። የተበላሸ bearer token ይሞክሩ፣ ከዚያ ወደ መለያ የገባውን UI ተጠቅመው የተፈቀደ ጥያቄ ያድርጉ።

ይውጡና መተግበሪያው የሚታየውን ማስታወሻ ማጽዳቱንና የsession token እንደገና አለመላኩን ይፈትሹ። አስቀድሞ የተሰጠ token የተዋቀረው ዕድሜው እስኪያልቅ ትክክለኛ ሆኖ ሊቀጥል ይችላል፤ ፈጣን ሁሉን አቀፍ ስረዛ የተለየ መስፈርት ነው።

የተሠራ ምሳሌ

የተከለከለ ቀጥታ ጥያቄ ከመግቢያ አዝራር የማያ ፎቶ የበለጠ ያሳያል። የምላሹን ሁኔታና የተጠበቀው ጽሑፍ ነበረ ወይ የሚለውን በመዝገብዎ ያቆዩ።

Extra implementation exercise

ቀጥታ ጥያቄ 401 እና ማስታወሻ የሌለው ምላሽ ይመልሳል፣ የተረጋገጠ session ግን ማስታወሻውን ያገኛል። የትኛውን ድንበር ፈተሹ?

የተሠራ መፍትሔ ያሳዩ

ይህ endpoint የጋራውን ማስታወሻ ከመመለሱ በፊት ማንነትን እንደሚያረጋግጥ ፈተሹ። ሌሎች endpoints እና የባለቤትነት ደንቦች የራሳቸውን ፍተሻዎች ይፈልጋሉ።

  • የአገልጋይ ምላሽ ድንበሩን ይለያል።
  • ከምሳሌው በላይ ሁሉን አቀፍ የtoken ስረዛ ወይም የእያንዳንዱ ተጠቃሚ ፈቃድ አለ አይልም።

ደረጃ 5

አንድ ተጨማሪ የሙከራ እሴት ይጠብቁ

ከትንሽ ለውጥ በኋላ ተመሳሳይ ፍተሻዎችን ይድገሙ።

በተመሳሳይ የታሰቡ ሰዎች ደንብ ሁለተኛ የፈጠራ እሴት በአገልጋይ ብቻ እንዲጨምር ረዳቱን ይጠይቁ። ለቀላልነት ሲሉ ሁለቱንም እሴቶች ወደ ይፋዊ ፋይሎች አያዛውሩ።

የተፈቀደ፣ የተከለከለና ያልተሳካ ምልከታዎችን ይድገሙ። ርክክቡ ሚስጥሩ የተሸፈነ ይሁን፣ ያልተከናወነ ሙከራም ይለዩ።

ተጨባጭ ምሳሌ

ሌላ መስክ መጨመር የቀድሞውን የግል ማስታወሻ በአጋጣሚ ይፋ ማድረግ የለበትም።

የዚህ ደረጃ ፋይሎች

Start hereየልምምድ ፋይሎች

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

How it works (optional)

ተግባርዎ፦ ሁለተኛ የተጠበቀ እሴት ያክሉ

አዲሱን እሴት ከይፋዊ ፋይሎች ያርቁ፣ ተመሳሳይ የአገልጋይ ፍተሻዎችንም ይተግብሩ።

ሌላ የልምምድ እሴት በአገልጋዩ አካባቢ ያክሉ፣ ከማረጋገጥ በኋላ ብቻ ይመልሱት፣ በደህንነትም እንደ ጽሑፍ ያሳዩት። ምላሹ በcache የማይያዝ ይቀጥል።

የጎደለ token፣ የማይሠራ token እና ትክክለኛ session ፍተሻዎችን ይድገሙ። ከሁለቱ የግል እሴቶች አንዱም እንዳልተካተተ ለማረጋገጥ ይፋዊውን ምንጭ ይፈልጉ።

የተሠራ ምሳሌ

ተግባሩ የተጠበቀውን ምላሽ ያስፋል፣ ከመግባት በፊት የሚላከውን ውሂብ መጠን አይደለም።

ሙሉው የማጣቀሻ መመሪያ በreference/assignment-walkthrough.txt ይገኛል። ደረጃዎቹን ከራስዎ ውጤት ጋር ያወዳድሩ፤ የፍተሻ መዝገቡን በራስዎ ፕሮጀክት ያዩትን ተጠቅመው ይሙሉ።

Extra implementation exercise

ሁለተኛ እሴት ይጠብቁ፣ ሁለቱንም የተፈቀደና የተከለከለ መዳረሻ ማስረጃ ይስጡ።

የተሠራ መፍትሔ ያሳዩ

የprivate-note endpointን በቀጥታ ያለ Authorization header ይጥሩ፦ 401 እና ማስታወሻ አለመኖር ይጠብቁ። ጠያቂው በራሱ የፈጠረው ወይም የገመተው ሐሰተኛ bearer tokenም መከልከል አለበት። የአሳሹ userId ወይም የተደበቀ አዝራር የአገልጋዩን የማንነት ፍተሻ አያሟላም።

በራስዎ የልምምድ ፕሮጀክት እውነተኛ የተረጋገጠ session tokenዎን ሲጠቀሙ፣ የተዋቀረውን የአገልጋይ ማስታወሻና Cache-Control: private, no-store ይጠብቁ። ማስታወሻውን ከይፋዊ HTML/JavaScript ያርቁ። እውነተኛ bearer token በጋራ የፍተሻ ሪፖርት አይለጥፉ።

ከወጡ በኋላ UIው የግል ይዘትን ማጽዳትና በማንነት የተረጋገጡ ጥያቄዎችን ማቆም አለበት። አስቀድሞ የተቀዳ የመዳረሻ token ጊዜው እስኪያልቅ ሊጠቅም ይችላል፦ የመውጣት UI ባህሪ ፈጣን የስረዛ ዋስትና አይደለም። ይህ የጋራ ማስታወሻ ልምምድ የገቡ ተጠቃሚዎችን ይፈቅዳል፤ የግል ባለቤትነት የተለየው የመገለጫ ልምምድ ነው።

  • ፈቃድ ማረጋገጥ እስኪሳካ ድረስ ሁለቱም እሴቶች በአገልጋይ ይቀጥላሉ።
  • ፈቃድ የሌላቸው ቀጥታ ጥያቄዎች ሁለቱንም እሴቶች አይይዙም፤ ትክክለኛ መዳረሻና የno-store ባህሪ ይፈተሻሉ።

ይህ ትምህርት ጠቅሞሃል?

ወደድኩት በል፣ ወይም ሊጠቀምበት ለሚችል ሰው አጋራው።

መማርዎን ይቀጥሉ

ሌሎች ትምህርቶችን ይመልከቱ