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

ሰዎች በድረ ገጽዎ ላይ ወደ መለያ እንዲገቡ እንዴት ማስቻል ይችላሉ?

ዝግጁውን የመግቢያ ገጽ ከሚተዳደር የመለያ አገልግሎት ጋር ያገናኙ፣ የኢሜይል ኮዶችን፣ መውጣትንና ያልተሳኩ ሙከራዎችን ይፈትሹ።

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

ይህ ለማን ነው?

በትንሽ ድረ ገጽ የመለያ መግቢያ ለሚፈልጉ ሰዎች። የሚተዳደር አገልግሎትና የተሰጠው መተግበሪያ አተገባበሩን ይሠራሉ፤ የማንነት ማረጋገጫ ኮድ ሳይጽፉ ከኮድ ጻፊ ረዳት ጋር መሥራት ይችላሉ።

ከመጀመርዎ በፊት

የራስዎ የSupabase የልምምድ ፕሮጀክትና የተፈቀደ የሙከራ ሳጥን ወይም የተዋቀረ ላኪ። የተሰጠውን ገጽ በኮምፒውተር HTTP ወይም በራስዎ HTTPS አስተናጋጅ ይጠቀሙ። የኮድ ጻፊ ረዳት ውቅሩን መምራትና የኢሜይል ኮዶችን ማዋቀር ይችላል።

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

ግምቶቹ በተሰጡት መነሻ ፋይሎች፣ አስፈላጊ መለያዎችና መሣሪያዎች ተዘጋጅተው ሲሠራ የሚወስደውን ጊዜ ያመለክታሉ። ዝግጅት፣ የማሳተም ወረፋ፣ የኢሜይልና የDNS ጥበቃ ተጨማሪ ጊዜ ይፈልጋሉ። የኢሜይል ማድረስ/የመለያ ዝግጅት ተጨማሪ መጠበቅ ሊፈልግ ይችላል። የአቅራቢ ገደቦችና የsession ዕድሜ ለልምምዱ በሚጠቀሙበት መለያ መፈተሽ አለባቸው።

ምን ይማራሉ?

  • እውነተኛ የመግቢያ ኮድ ይጠይቁና ይጠቀሙ።
  • የመግባትና የመውጣት ሁኔታዎችን ያረጋግጡ።
  • የተሳሳቱ ኮዶችና የጠፉ መልዕክቶች በታማኝነት እንደ ያልተሳኩ ይቆዩ።

የልምምድ ፋይሎች

ደረጃ 1

የመግቢያ መንገዱን ይረዱ

ኮድ መቀበልና ወደ መለያ መግባት የተለያዩ ጊዜያት ናቸው።

ዝግጁውን ገጽ ከረዳትዎ ጋር ይጠቀሙ። ሰውየው አድራሻ ያስገባል፣ ኮድ ይቀበላል፣ አገልግሎቱ መግባቱን ከማረጋገጡ በፊትም ያንን ኮድ ይልካል።

«የኢሜይል ሳጥንዎን ይፈትሹ» የሚል ገጽ ጥያቄ መቅረቡን ያመለክታል እንጂ ጎብኚው ማንነቱ መረጋገጡን አይደለም።

ተጨባጭ ምሳሌ

የኢሜይል አድራሻ ብቻ ባለቤቱ መግባቱን እንዳጠናቀቀ ማስረጃ አይደለም።

የተሰጠውን የSupabase መግቢያ መተግበሪያ ተጠቀም። የራሴን የተፈቀደ የሙከራ ሳጥን በመጠቀም የአቅራቢውን የኢሜይል ኮድ ውቅር ምራኝ፣ ይፋ ሊወጡ የሚችሉ የፕሮጀክት እሴቶችን ብቻ በይፋዊ ውቅሩ አስገባ፣ ገጹንም በHTTP አስኪድ። ኮድ መጠየቅ፣ ማስገባት፣ ዳግም መጫንና መውጣት እንድፈትሽ እርዳኝ። ልክ ያልሆነ ኮድ ወይም የጠፋ ኢሜይል የሐሰት የመግባት ሁኔታ መሆን የለበትም።

Supabase፦ የኢሜይል መግቢያ ኮዶች · Supabase፦ የAPI ቁልፍ ዓይነቶች

የዚህ ደረጃ ፋይሎች

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 ያክሉ

ማንነት ማረጋገጥ ማንነትን ይፈትሻል፤ የኢሜይል አድራሻ ማሳየት በቂ አይደለም።

አንድ ጊዜ የሚጠቅም የኢሜይል ኮድ ለመላክና ከተረጋገጠ በኋላ session ለመፍጠር Supabase Auth እንጠቀማለን። የአሳሹ SDK የsession ማከማቻንና እድሳትን ያስተዳድራል፤ የይለፍ ቃል የውሂብ ጎታ አንተገብርም።

የኢሜይል endpoint ጥያቄ መቀበሉ ተጠቃሚው ገብቷል ማለት አይደለም። session የሚኖረው ትክክለኛ የማረጋገጫ ደረጃ ከተጠናቀቀ በኋላ ብቻ ነው። ለግል ውሂብ ፈቃድ መስጠት በኋላ የሚከናወን የተለየ ፍተሻ ነው።

የተሠራ ምሳሌ

የሌላ ሰው ኢሜይል በመስክ መጻፍ የዚያን ሰው መዳረሻ መስጠት የለበትም። ወደ መልዕክት ሳጥኑ የተላከው ኮድ የማረጋገጫ ደረጃው ነው።

Supabase፦ የኢሜይል መግቢያ ኮዶች · Supabase፦ የAPI ቁልፍ ዓይነቶች

Extra implementation exercise

ገጹ የኢሜይል አድራሻ ተቀብሎ «Check your inbox» ማለትም «የመልዕክት ሳጥንዎን ይፈትሹ» ይላል። ጎብኚው ማንነቱ ተረጋግጧል?

የተሠራ መፍትሔ ያሳዩ

አይደለም። የመግቢያ ጥያቄው ተጀምሯል። ገብቷል የሚል ሁኔታ ከማሳየትዎ በፊት ኮዱን ያረጋግጡ፣ የተፈጠረውንም session ይመርምሩ።

  • የተጠየቀና የተረጋገጠ ሁኔታን ይለያል።
  • የተሳካ ማረጋገጥና session ይጠይቃል።

ደረጃ 2

አቅራቢውንና ገጹን ያዘጋጁ

የተሰጠው ቅጽ የሚጠብቀውን የኮድ መንገድ ይምረጡ።

ከመፈተሽ በፊት ረዳቱ አራት አስፈላጊ ነገሮችን ያረጋግጥ፦ የታሰበውን የSupabase ልምምድ ፕሮጀክት፣ በላኪ ቅንብሩ የተፈቀደ ሳጥን፣ የመግቢያ ኮድ ያለበት የኢሜይል አብነትና የተሰጠው ገጽ በHTTP መሥራቱን። አብነቱ magic link ብቻ ከመያዝ ይልቅ ከዚህ ኮድ ማስገቢያ ጋር መጣጣም አለበት።

በpublic/config.js የሚገቡት የፕሮጀክቱ URLና ለህዝብ የሚወጣ ቁልፍ ብቻ ናቸው። ሚስጥራዊ/service-role ቁልፎችን በአሳሽ ፋይሎች አያስቀምጡ። እነዚህ የአቅራቢና የሚሠራ መተግበሪያ ፍተሻዎች የግድ ናቸው፤ የማንነት ማረጋገጫ አፈጻጸሙን ማንበብ ወይም መጻፍ ግን አማራጭ ነው።

ተጨባጭ ምሳሌ

የሚሠራ የኢሜይል አገናኝ ኮድ እንዲጽፉ ለሚጠይቅ ገጽ አሁንም የተሳሳተ መንገድ ሊሆን ይችላል።

የዚህ ደረጃ ፋይሎች

Start hereየልምምድ ፋይሎች

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

How it works (optional)

አቅራቢውንና የአሳሽ ደንበኛውን ያዋቅሩ

የኢሜይሉ አብነትና የቁልፍ ዓይነት ከተሰጠው የኮድ ሂደት ጋር መዛመድ አለባቸው።

በተለየ Supabase ፕሮጀክት Email authentication ያንቁ። ላኪው ወደ የሙከራ መልዕክት ሳጥንዎ ማድረስ መቻሉን ይፈትሹ፤ ሲያስፈልግ የሚደገፍ SMTP ያዋቅሩ። በMagic Link የኢሜይል አብነት {{ .Token }} ያካትቱ፣ መልዕክቱ ይህ ገጽ የሚጠብቀውን ኮድ እንዲሰጥ።

የፕሮጀክቱን URL እና ሊታተም የሚችል ቁልፍ በconfig.js ያስቀምጡ። ቁልፉ መተግበሪያውን ይለያል፤ የተጠቃሚ session ወይም የአስተዳዳሪ ሚስጥር አይደለም። በዚህ የአሳሽ ፋይል secret/service-role ቁልፍ ፈጽሞ አያስቀምጡ። module imports እንዲሠሩ public/ን በHTTP/HTTPS ያቅርቡ።

ገጹ የሚጻፍ የኢሜይል ኮድ (OTP) ይጠብቃል። በአቅራቢው የኢሜይል አብነት {{ .Token }} ያንን ኮድ ያሳያል፤ የማረጋገጫ አገናኝ ተለዋዋጭ ብቻ ያለው አብነት ይህ UI የሚጠይቀውን ኮድ አይሰጥም። የቅንብር ስም ከመገመት ይልቅ፣ አብነቱን ለማግኘት ወቅታዊውን ያለ ይለፍ ቃል የኢሜይል መመሪያ ይጠቀሙ።

ይፋዊው የSupabase «With OTP» መመሪያ የኢሜይል ኮዶች ከMagic Link ጋር ተመሳሳይ አተገባበር እንደሚጋሩ በግልጽ ያብራራል፦ የMagic Link ኢሜይል አብነትን {{ .Token }} እንዲያካትት ይቀይሩ። ስሙ ይህ ገጽ አገናኝ ብቻ ያለው መልዕክት ይቀበል ማለት አይደለም። የdashboard መለያዎች ከተለዩ ያንን መመሪያ ይከተሉ፤ ያልተዛመደ የአብነት ቅንብር አይፍጠሩ።

የተሠራ ምሳሌ

የSDK ዘዴው signInWithOtp ይባላል፣ ግን እንደ አብነቱ ኢሜይሉ አገናኝ ወይም ኮድ ሊይዝ ይችላል። የእኛ በይነገጽ የኮድ ቅጂውን ይጠብቃል።

Extra implementation exercise

ገጽዎ ኮድ ይጠይቃል፣ ኢሜይሉ ግን magic link ብቻ ይዟል። ምን መፈተሽ አለብዎት?

የተሠራ መፍትሔ ያሳዩ

በተዋቀረው አብነት የToken እሴት ይፈትሹ፣ ከኮድ በይነገጹ ጋር ካስማሙትም በኋላ ጥያቄውን ይድገሙ። ለፕሮጀክትዎ ወቅታዊውን የአቅራቢ ሰነድ ይከተሉ።

  • የኢሜይሉን አብነትና የታሰበውን ሂደት ይፈትሻል።
  • ኮድ አይፈጥርም፣ መልዕክቱ ተረጋግጧልም አይልም።

ደረጃ 3

አንድ እውነተኛ መግባት ያጠናቅቁ

የተፈጠረ ኮድ ሳይሆን የኢሜይል መልዕክቱን ይጠቀሙ።

ከመለያ ወጥተው በአዲስ የግል መስኮት ይጀምሩ። ለሚቆጣጠሩት ሳጥን ኮድ ይጠይቁ፣ በመጀመሪያም ሆን ብለው የተሳሳተ ኮድ ያስገቡ። ሙከራው እንደተከለከለ መቆየቱንና ገጹ ገና የገባ መለያ የለም ማለቱን ያረጋግጡ። ከዚያ አዲስ ኮድ ጠይቀው ከኢሜይሉ የመጣውን እውነተኛ እሴት ያስገቡና የታየውን መለያ ይመልከቱ።

የተከለከለ ኮድ መግባትን ማስጀመር የለበትም። ቀድሞ ገብተው ከጀመሩ፣ የተሳሳተ ኮድ ያንን ነባር session ሊያስቀር ይችላል፤ ይህ ሌላ ሁኔታ ነውና አዲስ session መከልከልን አይፈትሽም። ኢሜይል ካልደረሰ ያንኑ የታገደ ደረጃ ይመዝግቡ።

ተጨባጭ ምሳሌ

ከተከለከለ ኮድ በኋላ የሚታይ ደስ የሚል የስኬት መለያ የመለያውን ሁኔታ በስህተት ይገልጻል።

የዚህ ደረጃ ፋይሎች

Start hereየልምምድ ፋይሎች

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

How it works (optional)

ኮድ ይጠይቁና ያረጋግጡ

እያንዳንዱ አዝራር የተለየ የሁኔታ ሽግግር ይወክላል።

public/app.js ያንብቡ። የመጀመሪያው ተግባር በተጻፈው ኢሜይል signInWithOtpን ይጠራል፤ ሁለተኛው በዚያ ኢሜይልና በተቀበለው token verifyOtpን ይጠራል። የተሳካ ውጤት session ያካትታል።

የራስዎን መልዕክት ሳጥን ይጠቀሙ፣ የአሁኑንም ኮድ በትክክል ይቅዱ። የተሳሳተ፣ ጊዜው ያለፈበት ወይም አስቀድሞ የተጠቀመ ኮድ ተጠቃሚውን ሳይገባ መተው አለበት። ኮዶችን ወይም የመዳረሻ tokensን በጋራ ሪፖርት አይመዝግቡ።

የተሠራ ምሳሌ

UIው ለሁኔታና ለመለያ ጽሑፍ textContent ይጠቀማል። የኢሜይል አድራሻን እንደ HTML አይተረጉምም።

const {data,error}=await client.auth.verifyOtp({email,token,type:'email'});
if(error || !data.session) { /* keep the unverified state */ }

Extra implementation exercise

የተሳሳተ ኮድ ስህተት ይመልሳል፣ መተግበሪያዎ ግን «Signed in» ማለትም «ገብተዋል» ያሳያል። የትኛው መስፈርት መቀየር አለበት?

የተሠራ መፍትሔ ያሳዩ

ገብቷል የሚለውን ሁኔታ የሚያሳዩት ማረጋገጥ ሲሳካና session ሲኖር ብቻ ነው። አዝራሩን መጫን ራሱን እንደ ማስረጃ አይጠቀሙ።

  • የተመለሰውን ስህተትና session ይፈትሻል።
  • አለመሳካትን ከተሳካ ማንነት ማረጋገጥ ይለያል።

ደረጃ 4

ዳግም መጫንንና መውጣትን ይፈትሹ

የሚታየው ሁኔታ እውነተኛውን የመግቢያ ክፍለ ጊዜ መከተሉን ያረጋግጡ።

ከተሳካ መግባት በኋላ እንደገና ይጫኑና የሚታየውን መለያ ይመልከቱ። ከዚያ Sign out ይጠቀሙና ማንነቱን ደግመው ይመልከቱ። ለነፃ session ፍተሻ፣ የተለየ የአሳሽ መገለጫ ይጠቀሙ፣ ወይም አዲስ ከመክፈትዎ በፊት ሁሉንም የግል መስኮቶች ይዝጉ፤ ተጨማሪ የግል መስኮቶች ነባሩን የግል session ሊጋሩ ይችላሉ።

የተሰጠው መነሻ የመለያ ሁኔታ ያሳያል፤ ለመፈተሽ የተጠበቀ ሰነድ አልያዘም። በኋላ የግል ይዘት ካከሉ፣ አገልጋይ ከመመለሱ በፊት መዳረሻን ማረጋገጥ አለበት። የተደበቀ ቁልፍ ብቻ ያንን ጥበቃ አይሰጥም።

ተጨባጭ ምሳሌ

ከመለያ የወጣ ገጽ መለያ ቀርቷል ብሎ ብቻ እንደ ቀድሞው መለያ መሥራት መቀጠል የለበትም።

የዚህ ደረጃ ፋይሎች

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ን በራሱ እንደማይወርስ ለማረጋገጥ የግል መስኮት ይጠቀሙ።

መውጣት የዚህን ደንበኛ session ያጸዳል፤ በሁሉም ቦታ የተቀዱ የመዳረሻ tokens ወዲያው መሥራት ያቆማሉ ማለት አይደለም። የተጠበቁ የአገልጋይ endpoints ሲሠሩ፣ የመዳረሻ token ዕድሜና የስረዛ ባህሪ አስፈላጊ ናቸው።

የተሠራ ምሳሌ

የወጣ ተጠቃሚ UI የግል መለያ መረጃ ማሳየት ወይም ከአዲስ ጥያቄ ጋር የድሮ token በራሱ ማያያዝ የለበትም። የግል endpoints አሁንም የአገልጋይ ማረጋገጫ ይፈልጋሉ።

Extra implementation exercise

የSign in አዝራርን መደበቅ የግል ሰነድን ለመጠበቅ በቂ ይሆናል?

የተሠራ መፍትሔ ያሳዩ

አይደለም። አገልጋዩ የተጠበቀ ይዘት ከመመለሱ በፊት ጠሪውን ማረጋገጥ አለበት። ቀጣዩ የprivate-page ትምህርት ያንን ድንበር ይተገብራል።

  • የUI ሁኔታን ከአገልጋይ የፈቃድ ማረጋገጫ ይለያል።
  • በሰነዱ ጥያቄ ላይ የመዳረሻ ፍተሻ ይጠይቃል።

ደረጃ 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)

ተግባርዎ፦ ሙሉውን የመለያ ጉዞ ያረጋግጡ

የጥያቄ፣ ያልተሳካ፣ የገባና የወጣ ሁኔታዎችን ይመዝግቡ።

ትክክለኛ መግባት ከማጠናቀቅዎ በፊት የተሳሳተ ኮድ ይፈትሹ። የማደስ ባህሪን፣ መውጣትንና የግል መስኮትን ይፈትሹ። የሚቆጣጠሯቸውን የመልዕክት ሳጥኖች ብቻ ይጠቀሙ።

እውነቱን ሳይቀይሩ አንድ ግልጽ ያልሆነ መልዕክት ያሻሽሉ፦ የተጠየቀ ኮድ በመጠበቅ ላይ ነው፣ ስህተትም የተሳካ session አይደለም።

የተሠራ ምሳሌ

ሪፖርቱ የተቀበለውን ኮድ፣ bearer token ወይም የግል መገለጫ መረጃ ሳያጋልጥ የታዩ ሁኔታዎችን መለየት አለበት።

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

Extra implementation exercise

የመለያ ጉዞውን ያጠናቅቁ፣ እያንዳንዱ ያዩት ሁኔታ ምን እንደሚያረጋግጥም ያብራሩ።

የተሠራ መፍትሔ ያሳዩ

የፕሮጀክቱን URL እና ሊታተም የሚችል ቁልፍ ያዋቅሩ፣ ከዚያም መልዕክቱ ይህ ገጽ የሚጠብቀውን ኮድ እንዲይዝ {{ .Token }} ያለበት አብነት ያዘጋጁ። ለራስዎ መልዕክት ሳጥን ኮድ ይጠይቁ። የተጠየቀ ኢሜይል የተረጋገጠ session አይደለም።

የተሳሳተ ኮድ ያስገቡና የተጠቃሚ session አለመፈጠሩን ያረጋግጡ። አዲስ ትክክለኛ ኮድ ይጠቀሙ፣ የታየውን ማንነት ያረጋግጡ፣ እንደገና ይጫኑና sessionን ይመልከቱ። ይውጡና ትሩ ከእንግዲህ session እንደማያሳይ ያረጋግጡ።

በግል መስኮት ይድገሙ፦ የመጀመሪያውን መስኮት የመግቢያ ሁኔታ መውረስ የለበትም። አዝራር መደበቅ ሰነድ ከመጠበቅ ጋር አይዛመድም፤ አገልጋይ የግል ይዘት ከመመለሱ በፊት ፈቃድን ማረጋገጥ አለበት።

  • የተሳሳተ ኮድና የወጣ ሁኔታዎች ማንነታቸው ሳይረጋገጥ ይቀጥላሉ።
  • ትክክለኛ session እንደተዋቀረው ይቀጥላል፣ የደንበኛ መውጣትም በእውነት ይረጋገጣል።

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

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

መማርዎን ይቀጥሉ

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