Skip to main content

🔐 ETN አረጋጋጭ (Authenticator)

ምድብ: የስነ-ምህዳር መድረኮች እና የገንቢ መሳሪያዎች ታዳሚ: የ3ኛ ወገን ገንቢዎች፣ አዋህዶች (Integrators)

አጠቃላይ እይታ​

ETN Authenticator የ ETN ስነ-ምህዳርን የሚያንቀሳቅስ የኋላ-ገጽ (backend) መሰረተ ልማት ነው። ገንቢዎች ተጠቃሚዎችን ለማረጋገጥ እና ክፍያዎችን ለማስኬድ ተለዋዋጭ መንገዶችን በመስጠት በ Web2 ምቾት እና በ Web3 ደህንነት መካከል ያለውን ክፍተት ይሞላል።

የስነ-ምህዳሩ "የመግቢያ ህግ"​

በ ETN Ecosystem App Store ውስጥ መተግበሪያን ለማተም፣ ገንቢዎች ከሁለቱ የመዋሃድ መንገዶች አንዱን መከተል አለባቸው፡-

  1. የማንነት መንገድ (The Identity Path): ደህንነቱ የተጠበቀ እና የተረጋገጠ የተጠቃሚ አስተዳደርን ለማረጋገጥ ETN Authenticatorን ያዋህዱ።
  2. የኢኮኖሚ መንገድ (The Economy Path): በመተግበሪያው ውስጥ እንደ ብቸኛ ተቀባይነት ያለው የክፍያ ዘዴ ETN Payን ያዋህዱ።

መንገድ 1: የማንነት ውህደት አማራጮች​

ሁሉም ገንቢ ውስብስብ የብሎክቼይን ላይብረሪዎችን ለመማር ዝግጁ እንዳልሆነ እንረዳለን። ETN Authenticator ለውህደት ሁለት የተለያዩ ዘዴዎችን ያቀርባል፡-

አማራጭ A: መደበኛ OAuth 2.0 (ለ Web2 ተስማሚ) 🚀​

ለሚከተሉት ምርጥ ነው፡ የብሎክቼይን ኮድ ሳያስተዳድሩ የ "Sign in with Google" አይነት ተሞክሮ ለሚፈልጉ ገንቢዎች።

  • የሚተዳደሩ ክፍለ-ጊዜዎች (Managed Sessions) እና ማደሻዎች: አረጋጋጩ (Authenticator) አጠቃላይ የክፍለ-ጊዜ ዑደቱን ለእርስዎ ያስተዳድራል። ደህንነታቸው የተጠበቀ የክፍለ-ጊዜ መታወቂያዎችን (Session IDs) ይሰጣል እና ቶከን ማደሻዎችን (Token Refreshers) በራስ-ሰር ያስተዳድራል፣ ይህም ውስብስብ የክፍለ-ጊዜ ጥገና ሎጂክ መገንባት ሳያስፈልግዎት ተጠቃሚዎችዎ እንደገቡ እንዲቆዩ ያደርጋል።
  • ምንም የብሎክቼይን ላይብረሪዎች አያስፈልጉም: @ton/coreን መጫን ወይም TON SDKን መማር አያስፈልግዎትም።
  • መደበኛ ትግበራ: ተጠቃሚዎችን ወደ የእኛ የተስተናገደ የፍቃድ መስጫ ገጽ ለማዞር ለመረጡት ቋንቋ (Node.js, Python, PHP, ወዘተ) ማንኛውንም መደበኛ OAuth 2.0 / OIDC ላይብረሪ ይጠቀሙ።

ሂደቱ (The Flow):

  1. ተጠቃሚውን ወደ https://account.etnecosystem.org/oauth/authorize ያዞሩ።
  2. ተጠቃሚው በመድረካችን ላይ ደህንነቱ በተጠበቀ ሁኔታ ይገባል (በ Wallet ወይም በ ETN ቁጥር)።
  3. መደበኛ የፍቃድ code ወደ እርስዎ የመመለሻ ዩአርኤል (callback URL) እንመልሳለን።
  4. ኮዱን ለተጠቃሚ ፕሮፋይል፣ ለመዳረሻ ቶከን (access token) እና ለማደሻ ቶከን (refresh token) ይቀይራሉ።

አማራጭ B: Web3 Native (TON Connect) 💎​

ለሚከተሉት ምርጥ ነው፡ የደንበኛ-ጎን (client-side) ክሪፕቶግራፊክ ማረጋገጫ ለሚፈልጉ DApps እና መድረኮች።

  • ክሪፕቶግራፊክ ማረጋገጫ: ton_proof እና signData መረጃዎችን በቀጥታ ለማረጋገጥ የ TON Libraries መጫንን ይጠይቃል።
  • ቀጥተኛ መስተጋብር: ወደተስተናገደ ገጽ ማዞር ሳያስፈልግ የፊት-ገጽዎ (frontend) በቀጥታ ከተጠቃሚው የኪስ ቦርሳ ፊርማዎችን እንዲጠይቅ ያስችለዋል።

መንገድ 2: የኢኮኖሚ ውህደት (ETN Pay) 💳​

ETN Pay በ TON ብሎክቼይን ላይ ለ ETN Jetton ደህንነቱ የተጠበቀ የክፍያ መግቢያ (gateway) ነው። ውስብስብ የብሎክቼይን ሎጂክን ከክፍያ ፍሰትዎ በመነጠል ለሉዓላዊነት፣ ለመረጋጋት እና ለአጠቃቀም ቀላልነት የተቀየሰ ነው።

ሁኔታ: ዝግ ቤታ (Closed Beta)

ለምን ETN Payን ይምረጡ?​

  • ቀላል ውህደት: ነጋዴዎች ቀላል ኤፒአይ ይጠቀማሉ። በአገልጋይዎ ላይ ምንም ውስብስብ የብሎክቼይን ላይብረሪዎች ወይም TON SDKs አያስፈልጉም።

  • አስተማማኝነት ቅድሚያ:

  • የዋጋ ኦራክል አገልግሎት: የ ETN/USD ተመኖችን በየ5 ደቂቃው እናጠራቅማለን (cache)። የክፍያ መጠየቂያ ፈጠራዎ ከዚህ አገር ውስጥ ካለው ክምችት ያነባል፣ ይህም የውጭ ዋጋ ኤፒአይዎች ቢቋረጡም እንኳ ዜሮ የስራ ማቆም መኖሩን ያረጋግጣል።

  • አቶሚክ ክፍፍሎች (Atomic Splits): ለመድረክ ሞዴሎች ፍጹም ነው። በአንድ አቶሚክ የብሎክቼይን ግብይት ውስጥ ክፍያዎችን መከፋፈልን እንደግፋለን (ለምሳሌ፡ 99.5% ለነጋዴ፣ 0.5% ለመድረክ)።

  • የተረጋገጠ ማስታረቅ: የእኛ TON Listener አገልግሎት ልዩ ለሆኑ የግብይት ማስታወሻዎች (unique memos) ብሎክቼይኑን ይከታተላል፣ ይህም እያንዳንዱ ክፍያ ክትትል፣ ማረጋገጫ እና ሪፖርት መደረጉን ያረጋግጣል።

የክፍያ ፍሰቱ​

  1. ክፍያ መጠየቂያ (Invoice): በ USD መጠን የ POST ጥያቄ ይልካሉ። እኛ ወደ ETN እንቀይረዋለን እና ልዩ የክፍያ መጠየቂያ እንመልሳለን።
  2. ክፍያ: ተጠቃሚው የኪስ ቦርሳቸውን ለማገናኘት እና ለመክፈል ወደ ETN Pay Hosted Frontend ይዛወራሉ።
  3. ማወራረድ: ስርዓታችን ግብይቱን በሰንሰለት ላይ (on-chain) ያውቃል፣ የክፍያ መጠየቂያውን እንደ PAID (ተከፍሏል) ምልክት ያደርጋል፣ እና በ X-ETN-Signature የተረጋገጠ webhook ወደ ኋላ-ገጽዎ ይልካል።

የገንቢ ተጠያቂነት​

የተመረጠው የውህደት መንገድ ምንም ይሁን ምን (ማንነት ወይም ኢኮኖሚ)፣ ሁሉም ገንቢዎች የስነ-ምህዳሩን የታማኝነት ደረጃዎች ማክበር አለባቸው፡-

  • የገንቢ KYC: የኤፒአይ ማረጋገጫዎችን ለማግኘት ማንነትን (የመንግስት መታወቂያ / የንግድ ፈቃድ) ማረጋገጥ አለባቸው።
  • አስገዳጅ ስምምነቶች: ገንቢዎች የገንቢ ስምምነትን በክሪፕቶግራፊ መፈረም አለባቸው፣ ይህም የተጠቃሚ መረጃ ግላዊነትን ለመጠበቅ ህጋዊ አስገዳጅ ቃል ኪዳን ይፈጥራል።

የኤፒአይ መዳረሻ እና ዋጋ​

  • የማረጋገጫ ኤፒአይ (Authentication API): የ ETN Authenticator (OAuth ወይም Web3) መዳረሻ ለስነ-ምህዳር አጋሮች ይሰጣል።
  • የ Web3 ፕሮቶኮል መዳረሻ: ለተወሰኑ Web3 ፕሮቶኮሎች (ለምሳሌ፡ የብሎክቼይን ስልክ፣ የኤስኤምኤስ ማእከል) የላቀ መዳረሻ በአጠቃቀም ላይ የተመሰረተ ወጪ በ $ETN ሊጠይቅ ይችላል።