រំកិលទៅមាតិកា

មគ្គុទ្ទេសក៍ពេញលេញសម្រាប់ STB EVA Onboarding

ការរៀបចំរហ័ស

បំពេញ 6 ជំហានដើម្បីបើកការរាយការណ៍អនុលោមតាមតម្រូវការរដ្ឋាភិបាលសិង្ហបុរី។ សណ្ឋាគារភាគច្រើនអាចបញ្ចប់ក្នុងរយៈពេល 15-25 នាទី។ សូមរក្សាទុកការកំណត់រាល់ជំហាន ដើម្បីឱ្យការផ្លាស់ប្តូរមានប្រសិទ្ធភាពភ្លាមៗ។

មគ្គុទ្ទេសក៍នេះនាំអ្នកឆ្លងកាត់ដំណើរការ STB E-Visitor Authentication (EVA) onboarding ពី Settings → Government Integration។

ជំហានសកម្មភាពអ្វីដែលអ្នកត្រូវមាន
1រក្សាទុក Hotel Codeលេខកូដ Hotel Licensing Board (HLB)
2ដាក់ស្នើទម្រង់ STBសិទ្ធិចូលប្រើ form.gov.sg
3បង្កើត និងដាក់ស្នើ JWKSតំណដាក់ស្នើ JWKS
4បញ្ចូល EVA API KeyAPI key ពីអ៊ីមែល STB
5បង្កើត និងជូនដំណឹង STBtest transaction រួចរាល់
6រង់ចាំការបញ្ជាក់ពី STBអ៊ីមែលអនុម័តពី STB

មុនពេលចាប់ផ្តើម​

សូមបញ្ជាក់ថាអ្នកមានលក្ខខណ្ឌខាងក្រោម៖

  • ប្រទេសសណ្ឋាគាររបស់អ្នកត្រូវបានកំណត់ជា Singapore
  • អ្នកមានសិទ្ធិ Settings write
  • អ្នកមាន លេខកូដ Hotel Licensing Board (HLB)
  • អ្នកអាចចូលប្រើទម្រង់ STB ខាងក្រៅបាន
រក Hotel Code នៅទីណា

ប្រសិនបើអ្នកមិនដឹងលេខកូដ HLB របស់អ្នកទេ សូមស្វែងរកសណ្ឋាគាររបស់អ្នកនៅ licence1.business.gov.sg/hotelreg/search។

Onboarding ជាជំហានៗ​

ជំហានទី 1៖ រក្សាទុក Hotel Code​

Government Integration page showing Step 1 with Hotel Code field

  1. ទៅកាន់ Settings → Government Integration

  2. បើក Enable E-Visitor Authentication (EVA) Integration

  3. បញ្ចូល Hotel Code របស់អ្នកពីក្រុមប្រឹក្សាអាជ្ញាបណ្ណសណ្ឋាគារ

  4. ចុច Save Hotel Code

    ✓ អ្នកនឹងឃើញសារ "Hotel code saved successfully"

មិនអាចរក្សាទុកបានទេ?

សូមប្រាកដថា Government Integration ត្រូវបានបើករួចហើយ (toggle ពណ៌ខៀវ) មុនពេលរក្សាទុក hotel code។

ជំហានទី 2៖ ដាក់ស្នើទម្រង់ STB EVA Onboarding​

Step 2 showing Open STB Form button and confirmation action

  1. នៅផ្នែក Step 2 ចុច Open STB Form

  2. បំពេញទម្រង់ HIS-EVA Hotel Onboarding Application នៅ form.gov.sg

  3. ត្រឡប់មក Streamliner

  4. ចុច I have submitted the form

  5. នៅក្នុង popup បញ្ជាក់ ចុច Yes, I have submitted the form

    ✓ Step 2 នឹងបង្ហាញថាបានបញ្ចប់

អ្វីដែល STB ត្រូវការ

ទម្រង់នេះនឹងស្នើព័ត៌មានសណ្ឋាគាររបស់អ្នក និងតម្រូវការចូលប្រើ API។ ជាទូទៅការដំណើរការនឹងចំណាយពេល 3-5 ថ្ងៃធ្វើការ។

ជំហានទី 3៖ បង្កើត និងដាក់ស្នើ JWKS​

JWKS (JSON Web Key Set) គឺជាព័ត៌មានសុវត្ថិភាពដែលប្រើសម្រាប់ផ្ទៀងផ្ទាត់សណ្ឋាគាររបស់អ្នកទៅប្រព័ន្ធ STB។

ប្រសិនបើអ្នកត្រូវការកូនសោថ្មី (សណ្ឋាគារភាគច្រើន)​

Step 3 showing Generate JWKS and Download buttons

  1. នៅក្នុង Step 3 ចុច Generate JWKS

    ✓ អ្នកនឹងឃើញសារ "JWKS generated successfully" ជាមួយ timestamp

  2. ចុច Download JWKS txt

  3. រក្សាទុកឯកសារនេះ (អ្នកនឹងត្រូវអាប់ឡូដវាទៅ STB)

  4. ចុច Submit JWKS Form ដើម្បីបើក portal ដាក់ស្នើរបស់ STB

  5. អាប់ឡូដឯកសារ JWKS ដែលអ្នកបានទាញយក

  6. ត្រឡប់មក Streamliner

  7. ចុច I have submitted the JWKS

  8. បញ្ជាក់នៅក្នុង popup

    ✓ Step 3 នឹងបង្ហាញថាបានបញ្ចប់

ប្រសិនបើអ្នកមានព័ត៌មានសម្គាល់ពី STB រួចហើយ​

សណ្ឋាគារខ្លះទទួលបានព័ត៌មានសម្គាល់ JWKS ដោយផ្ទាល់ពី STB។ ក្នុងករណីនេះ សូមប្រើ Override Keys ជំនួសការបង្កើតកូនសោថ្មី៖

Advanced options expanded showing Override Keys button

  1. នៅក្នុង Step 3 បើក Advanced options

  2. ចុច Override Keys

  3. នៅក្នុង modal ដែលបង្ហាញ សូមបញ្ចូលព័ត៌មានសម្គាល់ដែលអ្នកមានរួចហើយ៖

    • JWKS (ទម្រង់ JSON)
    • Public Key (ទម្រង់ PEM)
    • Private Key (ទម្រង់ PEM)

  4. ចុច Save Override Keys

    ✓ អ្នកនឹងឃើញសារ "EVA keys overridden successfully"

  5. ចុច I have submitted the JWKS ដើម្បីបញ្ជាក់

    ✓ Step 3 នឹងបង្ហាញថាបានបញ្ចប់

សូមរក្សាកូនសោរបស់អ្នកឱ្យមានសុវត្ថិភាព

កុំចែករំលែក private key ឬ JWKS របស់អ្នកតាមអ៊ីមែល ឬការជជែកឡើយ។ ព័ត៌មានសម្គាល់ទាំងនេះអាចផ្តល់សិទ្ធិចូលប្រព័ន្ធរដ្ឋាភិបាល។

ជំហានទី 4៖ បញ្ចូល EVA API Key​

បន្ទាប់ពី STB ដំណើរការការដាក់ស្នើ JWKS របស់អ្នករួច ពួកគេនឹងផ្ញើ API key មកអ្នកតាមអ៊ីមែល។

  1. ពិនិត្យអ៊ីមែលរបស់អ្នកសម្រាប់សារដែលមានចំណងជើង "EVA API Key" ពី STB

  2. ចម្លង API key នោះ (ទម្រង់ UUID)

  3. ត្រឡប់ទៅ Step 4 ក្នុង Streamliner

  4. បិទភ្ជាប់ key ទៅក្នុង Enter EVA API Key

  5. ចុច Save API Key

    ✓ ប្រព័ន្ធនឹងផ្ទៀងផ្ទាត់ key ដោយស្វ័យប្រវត្តិ ✓ អ្នកនឹងឃើញសារ "API key saved successfully"

ការផ្ទៀងផ្ទាត់ត្រូវការពេលបន្តិច

ប្រព័ន្ធនឹងសាកល្បង API key របស់អ្នកជាមួយ STB endpoint។ វាចំណាយពេលប្រហែល 5-10 វិនាទី។ សូមកុំបិទទំព័រនេះខណៈពេលកំពុងផ្ទៀងផ្ទាត់។

ជំហានទី 5៖ បង្កើត Test Transaction និងជូនដំណឹង STB​

Step 5 showing test transaction ID and notification options

បន្ទាប់ពីរក្សាទុក API key រួច ប្រព័ន្ធនឹងបង្កើត test transaction ដោយស្វ័យប្រវត្តិ។

  1. រង់ចាំឱ្យប្រព័ន្ធបង្កើត test transaction

    ✓ អ្នកនឹងឃើញ transaction ID ដែល STB ផ្ញើត្រឡប់មក

  2. ចុច Send Automated Email to STB ដើម្បីជូនដំណឹងទៅ STB

    ✓ Step 5 នឹងបង្ហាញថាបានបញ្ចប់

    ប្រសិនបើអ៊ីមែលស្វ័យប្រវត្តិមិនអាចប្រើបាន សូមចុច Copy transaction ID ហើយផ្ញើអ៊ីមែលទៅ STB ដោយដៃជាមួយព័ត៌មាន transaction។

ប្រសិនបើអ៊ីមែលស្វ័យប្រវត្តិបង្ហាញការព្រមាន

ប្រសិនបើអ្នកឃើញ "We sent this test transaction to your email only" នោះមានន័យថា STB មិនទាន់បានទទួលការជូនដំណឹងទេ។ សូមបញ្ជូនបន្តអ៊ីមែលនោះទៅ STB ដោយដៃ បន្ទាប់មកបញ្ជាក់ក្នុង Streamliner។

សូមទាក់ទង success@vouch-technologies.com ប្រសិនបើអ្នកចង់បើកការជូនដំណឹង STB ដោយស្វ័យប្រវត្តិសម្រាប់សណ្ឋាគាររបស់អ្នក។

ជំហានទី 6៖ រង់ចាំការបញ្ជាក់ពី STB​

Step 6 showing waiting status and confirmation button

STB នឹងពិនិត្យ test transaction របស់អ្នក ហើយបញ្ជាក់ថាការភ្ជាប់បានជោគជ័យ។

  1. រង់ចាំអ៊ីមែលបញ្ជាក់ពី STB (ជាទូទៅ 1-2 ថ្ងៃធ្វើការ)

  2. ត្រឡប់មក Streamliner

  3. ចុច Mark STB Confirmation Received

    ✓ អ្នកនឹងឃើញសារ "STB confirmation recorded. EVA onboarding is complete." ✓ ជំហានទាំង 6 នឹងបង្ហាញថាបានបញ្ចប់

All steps completed showing successful onboarding

🎉 EVA integration របស់អ្នកបានដំណើរការហើយ! ទិន្នន័យ check-in របស់ភ្ញៀវនឹងត្រូវបានដាក់ស្នើទៅ STB ដោយស្វ័យប្រវត្តិ។

ការគ្រប់គ្រង Integration របស់អ្នក​

បង្កើត Test Transaction ម្តងទៀត​

ប្រសិនបើ test transaction ផុតកំណត់ ឬបរាជ័យ៖

  1. ទៅកាន់ Step 5
  2. ចុច Re-generate Test Transaction
  3. ជូនដំណឹង STB ជាមួយ transaction ID ថ្មី

កំណត់ Onboarding ឡើងវិញ​

ប្រសិនបើអ្នកត្រូវការចាប់ផ្តើមឡើងវិញ៖

  1. ទាក់ទង success@vouch-technologies.com
  2. ស្នើសុំកំណត់ EVA onboarding ឡើងវិញ
  3. ធ្វើជំហានទាំង 6 ម្តងទៀតដោយប្រើព័ត៌មានសម្គាល់ថ្មី
ការកំណត់ឡើងវិញនឹងលុបព័ត៌មានសម្គាល់ដែលមានស្រាប់

ការកំណត់ឡើងវិញនឹងលុប JWKS, API key និងវឌ្ឍនភាពទាំងអស់។ សូមធ្វើវាតែប៉ុណ្ណោះ ប្រសិនបើព័ត៌មានសម្គាល់បច្ចុប្បន្នរបស់អ្នកបានបាត់បង់ ឬអាចត្រូវបានលេចធ្លាយ។

ការដោះស្រាយបញ្ហា​

ប៊ូតុង Step 1 ត្រូវបានបិទ​

អ្វីដែលអ្នកឃើញ: មិនអាចរក្សាទុក hotel code បាន។

ដំណោះស្រាយ៖

  • បញ្ជាក់ថា Enable E-Visitor Authentication (EVA) Integration ត្រូវបានបើក
  • ពិនិត្យថាវាល hotel code មិនទទេ
  • សាកល្បង refresh ទំព័រ

មិនអាចបញ្ជាក់ Step 2 បាន​

អ្វីដែលអ្នកឃើញ: I have submitted the form នៅតែបិទ។

ដំណោះស្រាយ៖

  1. បញ្ចប់ Step 1 ជាមុនសិន
  2. បញ្ជាក់ថាអ្នកបានដាក់ស្នើទម្រង់ STB នៅ form.gov.sg ពិតប្រាកដ
  3. ត្រឡប់មកវិញ ហើយចុចប៊ូតុងបញ្ជាក់

Override Keys បរាជ័យ​

អ្វីដែលអ្នកឃើញ: កើតមានកំហុសពេលរក្សាទុកព័ត៌មានសម្គាល់ override។

ដំណោះស្រាយ៖

  • បញ្ជាក់ថា JWKS ជា JSON ត្រឹមត្រូវ
  • បញ្ជាក់ថា public key និង private key ស្ថិតក្នុងទម្រង់ PEM ជាមួយ header ត្រឹមត្រូវ (-----BEGIN PUBLIC KEY-----)
  • បញ្ជាក់ថាមានយ៉ាងហោចណាស់ 1 វាលត្រូវបានបំពេញ (JWKS, public key ឬ private key)

ការផ្ទៀងផ្ទាត់ API key បរាជ័យ​

អ្វីដែលអ្នកឃើញ: មានកំហុសបន្ទាប់ពីចុច Save API Key។

ដំណោះស្រាយ៖

  1. ពិនិត្យថា key គ្រប់គ្រាន់ (36 តួអក្សររួមទាំងសញ្ញាខ្ទាស់)
  2. ដកចន្លោះបន្ថែមនៅខាងមុខ ឬខាងក្រោយ key
  3. បញ្ជាក់ថាអ្នកកំពុងប្រើ key TEST ឬ LIVE ត្រឹមត្រូវសម្រាប់ environment ដែលបានជ្រើស
  4. បញ្ជាក់ថា Step 3 (JWKS) បានបញ្ចប់