ការណែនាំអំពីការដំឡើងកម្មវិធី Changepoint API

Changepoint API Software - Featured Image

ការណែនាំអំពីការដំឡើង API
មគ្គុទ្ទេសក៍យោង
ចំណុចផ្លាស់ប្តូរ 2021

© 2021 Changepoint Canada ULC រក្សាសិទ្ធិគ្រប់យ៉ាង។ សិទ្ធិរបស់រដ្ឋាភិបាលសហរដ្ឋអាមេរិក-ការប្រើប្រាស់ ការចម្លង ឬការបង្ហាញដោយរដ្ឋាភិបាលសហរដ្ឋអាមេរិកគឺស្ថិតនៅក្រោមការរឹតបន្តឹងដូចមានចែងក្នុងកិច្ចព្រមព្រៀងអាជ្ញាប័ណ្ណ Changepoint Canada ULC និងដូចដែលបានផ្តល់នៅក្នុង DFARS 227.7202-1(a) និង 227.7202-3(a) (1995) DFARS 252.227-7013(c)(1)(ii) (OCT 1988), FAR 12.212(a) (1995), FAR 52.227-19, ឬ FAR 52.227-14 (ALT III) តាមដែលអាចអនុវត្តបាន។ ផលិតផលនេះមានព័ត៌មានសម្ងាត់ និងអាថ៌កំបាំងពាណិជ្ជកម្មនៃ Changepoint Canada ULC ។ ការបង្ហាញត្រូវបានហាមឃាត់ដោយគ្មានការអនុញ្ញាតជាលាយលក្ខណ៍អក្សរជាមុនពី Changepoint Canada ULC ។ ការប្រើប្រាស់ផលិតផលនេះគឺស្ថិតនៅក្រោមលក្ខខណ្ឌនៃកិច្ចព្រមព្រៀងអាជ្ញាប័ណ្ណរបស់អ្នកប្រើជាមួយ Changepoint Canada ULC ។ ឯកសារអាចត្រូវបានផលិតឡើងវិញដោយអ្នកទទួលអាជ្ញាប័ណ្ណសម្រាប់ការប្រើប្រាស់ផ្ទៃក្នុងប៉ុណ្ណោះ។ ខ្លឹមសារនៃឯកសារនេះអាចមិនត្រូវបានផ្លាស់ប្តូរ កែប្រែ ឬផ្លាស់ប្តូរដោយគ្មានការយល់ព្រមជាលាយលក្ខណ៍អក្សរពី Changepoint Canada ULC ឡើយ។ Changepoint Canada ULC អាចផ្លាស់ប្តូរខ្លឹមសារដែលបានបញ្ជាក់នៅទីនេះគ្រប់ពេល ដោយមាន ឬគ្មានការជូនដំណឹងជាមុន។

ការដំឡើង Changepoint API

អំពីការដំឡើង Changepoint API
Changepoint API អាចប្រើបានជា COM API ដែលជាសេវាកម្ម Windows Communication Foundation (WCF) និងសម្រាប់ភាពឆបគ្នាថយក្រោយ ជា Web សេវាកម្មលើកកម្ពស់សេវាកម្ម (WSE) ។ សម្រាប់ព័ត៌មានអំពី Changepoint API សូមមើល Changepoint API Reference។ សម្រាប់​ការ​ធ្វើ​ឱ្យ​ប្រសើរ​កំណត់​ចំណាំ ការ​ព្រមាន និង​បញ្ហា​ដែល​បាន​ដឹង សូម​មើល Release Notes ក្នុង​ថត​ក្រុម​ក្នុង Changepoint ។
ការធ្វើឱ្យប្រសើរឡើងនូវ Changepoint API
ប្រសិនបើអ្នកកំពុងដំឡើងកំណែពីការចេញផ្សាយមុននៃ Changepoint ប្រើផ្ទាំងបញ្ជាវីនដូ ដើម្បីលុបកំណែមុននៃ Changepoint API និងសមាសធាតុរបស់វា មុនពេលដំឡើងកំណែនេះ។
តម្រូវការផ្លាស់ប្តូរចំណុច API
អ្នកត្រូវតែដំឡើង Changepoint មុនពេលអ្នកដំឡើង Changepoint API ។ សម្រាប់តម្រូវការផ្នែកទន់ សូមមើល Changepoint Software Compatibility Matrix ដែលមាននៅក្នុង Release Notes និង Patches team folder ឆ្នាំ 2021 នៅក្នុង Changepoint។
File អនុសញ្ញាផ្លូវ
តាមរយៈឯកសារនេះ អនុសញ្ញាខាងក្រោមត្រូវបានប្រើសម្រាប់ផ្លូវរួម៖

  • ផ្លូវឫសនៃការដំឡើង Changepoint ។
    ផ្លូវលំនាំដើមគឺ៖
    គ៖ កម្មវិធី Files (x86) ចំណុចផ្លាស់ប្តូរចំណុចផ្លាស់ប្តូរ
  • ទីតាំង root សម្រាប់ឧបករណ៍ប្រើប្រាស់ Changepoint ទូទៅ ដូចជាឧបករណ៍ប្រើប្រាស់ការកំណត់ការចូល។
    ផ្លូវលំនាំដើមគឺ៖
    គ៖ កម្មវិធី Files (x86) ធម្មតា FilesChangepointChangepoint

ការដំឡើង Changepoint API

  1. ពីថត root ប្រព័ន្ធផ្សព្វផ្សាយ Changepoint API សូមដំណើរការ setup.exe ។
  2. ធ្វើតាមការណែនាំរហូតដល់អេក្រង់ ជ្រើសរើសលក្ខណៈពិសេសលេចឡើង។
  3. ជ្រើសរើសមុខងារដែលអ្នកចង់ដំឡើង បន្ទាប់មកចុច Next។
  4. ជ្រើសរើសថតទិសដៅ API លំនាំដើម API ហើយចុច Next។
    ចំណាំ៖ ឧបករណ៍ប្រើប្រាស់ការកំណត់ការចូល Changepoint ត្រូវបានដំឡើងនៅក្នុង ការកំណត់ចូល ដោយមិនគិតពីថតទិសដៅដែលអ្នកបញ្ជាក់។
  5. ប្រសិនបើអ្នកជ្រើសរើស Web API សេវាកម្ម៖ ក. នៅពេលជ្រើសរើស
    a Web អេក្រង់គេហទំព័រលេចឡើង សូមជ្រើសរើស a webគេហទំព័រដើម្បីបន្ថែមថតនិម្មិតទៅ ហើយបន្ទាប់មកចុចបន្ទាប់។
    ខ. ចុច Next ដើម្បីបន្ត។ 6. នៅពេលដែលការដំឡើង API ត្រូវបានបញ្ចប់ សូមចុច Finish ។

កំណត់រចនាសម្ព័ន្ធ Changepoint API ដើម្បីឱ្យដឹងអំពីឃ្លាំងសម្ងាត់
ដើម្បីកំណត់រចនាសម្ព័ន្ធ Changepoint API ដើម្បីដឹងអំពីឃ្លាំងសម្ងាត់ សូមជំនួសតម្លៃសម្រាប់ “ឃ្លាំងសម្ងាត់។ ពាក្យសម្ងាត់" និង "ឃ្លាំងសម្ងាត់។ ម៉ាស៊ីនមេ” គ្រាប់ចុចនៅក្នុង CP Web សេវាកម្មWeb.config file ជាមួយនឹងតម្លៃដែលបានប្រើនៅក្នុងសហគ្រាសWeb.config file.
ការបើកដំណើរការ Web ការលើកកម្ពស់សេវាកម្ម (WSE)

  1. កែសម្រួល Web.config file សម្រាប់ web សេវាកម្ម។ ទីតាំងលំនាំដើមគឺ៖
    APICP Web សេវាកម្មWeb.config
  2. ស្វែងរកឧទាហរណ៍ទាំងបីនៃបន្ទាត់មតិយោបល់ខាងក្រោម៖
    < !– មិនបញ្ចេញមតិលើធាតុខាងក្រោម ប្រសិនបើអ្នកកំពុងប្រើ Web ការបង្កើនសេវាកម្ម (WSE) API ។ ទុកមតិយោបល់ប្រសិនបើប្រើសេវាកម្ម WCF ហើយមិនដំឡើង Web ការលើកកម្ពស់សេវាកម្ម (WSE) ->
  3. មិនបញ្ចេញមតិលើធាតុដែលធ្វើតាមឧទាហរណ៍នីមួយៗនៃបន្ទាត់មតិយោបល់៖
    <section name=”microsoft.web.services2″ … >webសេវាកម្ម >web.services2>
    ចំណាំ៖ នេះ។webសេវាកម្ម> ធាតុដែលមិនត្រូវបានបញ្ចេញមតិគឺជាកូនរបស់web>.

កំណត់រចនាសម្ព័ន្ធកំណត់ហេតុសម្រាប់ Web API សេវាកម្ម
អ្នកត្រូវតែកំណត់កំណត់ហេតុ file ផ្លូវនិងកម្រិតកំណត់ហេតុ។ កម្រិតនៃកំណត់ហេតុគឺប្រមូលផ្តុំ។ សម្រាប់អតីតample ប្រសិនបើអ្នកបញ្ជាក់កម្រិត 3 នោះកម្រិត 1, 2, និង 3 ត្រូវបានកត់ត្រាទុក។ កម្រិតកំណត់ហេតុលំនាំដើមគឺ 8 ។

  1. កែសម្រួល web សេវាកម្ម Web.config ។ ទីតាំងលំនាំដើមគឺ៖
    APICP Web សេវាកម្មWeb.config
  2. កំណត់កំណត់ហេតុFileផ្លូវ។ តម្លៃលំនាំដើមគឺ APIAPILogs 3. កំណត់ LogLevel ។ តម្លៃត្រឹមត្រូវគឺ៖
    0 = គ្មានការកត់ត្រា
    1 = ប្រភពវត្ថុ និងវិធីសាស្រ្ត
    2 = សារកំហុស
    3 = ប៉ារ៉ាម៉ែត្របញ្ចូល
    4 = ត្រឡប់
    5 = ព្រមាន
    8 = ប៉ុស្តិ៍ត្រួតពិនិត្យ

កំណត់រចនាសម្ព័ន្ធការផ្ទៀងផ្ទាត់ថតនិម្មិតសម្រាប់ Web API សេវាកម្ម
អ្នកត្រូវតែបើកការចូលប្រើអនាមិក និងបិទការផ្ទៀងផ្ទាត់ Windows រួមបញ្ចូលគ្នាសម្រាប់ CPWebសេវាថតនិម្មិតនៅក្នុងសេវាព័ត៌មានអ៊ីនធឺណិត (IIS) ។ សម្រាប់ព័ត៌មានបន្ថែម សូមមើលឯកសារ Microsoft IIS ។
ការកំណត់រចនាសម្ព័ន្ធការតភ្ជាប់មូលដ្ឋានទិន្នន័យសម្រាប់ Web API សេវាកម្ម
ប្រើឧបករណ៍ប្រើប្រាស់ការកំណត់ការចូល ដើម្បីអ៊ិនគ្រីបការកំណត់ការតភ្ជាប់មូលដ្ឋានទិន្នន័យនៅក្នុង Web API សេវាកម្ម Web.config file. សម្រាប់ព័ត៌មានបន្ថែម សូមស្វែងរក "ការកំណត់រចនាសម្ព័ន្ធការតភ្ជាប់មូលដ្ឋានទិន្នន័យ" នៅក្នុងការណែនាំអំពីការដំឡើង Changepoint ។
កំណត់រចនាសម្ព័ន្ធការផ្ទៀងផ្ទាត់សម្រាប់ Changepoint WCF Web សេវាកម្ម
អ្នកអាចកំណត់រចនាសម្ព័ន្ធការផ្ទៀងផ្ទាត់កម្មវិធី និងការចូលតែមួយ (SSO) សម្រាប់ Changepoint WCF Web សេវាកម្ម។
ជម្រើសនៃការអនុវត្តខាងក្រោមមានដោយប្រើប្រាស់សេវាកម្ម Secure Token Service (STS)៖

  • SSO ដោយប្រើ ISAPI SSL ជាជម្រើស
  • SSO ដោយប្រើ WS-Federation (ADFS 2.0) SSL ត្រូវបានទាមទារ

ប្រសិនបើ SSL ត្រូវបានទាមទារ ស្គ្រីបកំណត់រចនាសម្ព័ន្ធធានាថាវាត្រូវបានប្រើប្រាស់។
ស្គ្រីបកំណត់រចនាសម្ព័ន្ធសម្រាប់ ISAPI និងការផ្ទៀងផ្ទាត់កម្មវិធីអាចបើក SSL ជាជម្រើស។
កំណត់រចនាសម្ព័ន្ធការផ្ទៀងផ្ទាត់កម្មវិធីសម្រាប់ WCF Web សេវាកម្ម
ប្រភេទការផ្ទៀងផ្ទាត់លំនាំដើមសម្រាប់ Changepoint WCF Web សេវាកម្មគឺការផ្ទៀងផ្ទាត់កម្មវិធី។
ប្រើនីតិវិធីក្នុងផ្នែកនេះដើម្បី៖

  • កំណត់រចនាសម្ព័ន្ធ Changepoint WCF Web សេវាកម្មប្រើប្រាស់ការផ្ទៀងផ្ទាត់កម្មវិធីជាមួយ SSL
  • ត្រឡប់ Changepoint WCF Web សេវាកម្មដល់ការផ្ទៀងផ្ទាត់កម្មវិធីបន្ទាប់ពីបានអនុវត្តការអនុវត្តមួយនៃ SSO

កំណត់រចនាសម្ព័ន្ធ PowerShell

  1. បើកប្រអប់បញ្ចូល Windows PowerShell ។
  2. កែប្រែគោលការណ៍ប្រតិបត្តិ៖
    Set-ExecutionPolicy មិនមានការរឹតបន្តឹង

Stage 1 ប្រមូលប៉ារ៉ាម៉ែត្រកំណត់រចនាសម្ព័ន្ធ
កំណត់តម្លៃសម្រាប់ប៉ារ៉ាម៉ែត្រកំណត់រចនាសម្ព័ន្ធ។

ប៉ារ៉ាម៉ែត្រ ការពិពណ៌នា
Webសេវាកម្ម_ផ្លូវ ទីតាំងនៃការផ្លាស់ប្តូរចំណុច WCF Web សេវាកម្ម web កម្មវិធី files.
លំនាំដើម៖ \API\CP Web សេវាកម្ម
វិញ្ញាបនបត្រសេវាកម្ម_
ឈ្មោះ
ឈ្មោះវិញ្ញាបនបត្រដែលនឹងត្រូវបានប្រើដើម្បីផ្ទៀងផ្ទាត់សេវាកម្មដល់អតិថិជនដោយប្រើរបៀបសុវត្ថិភាពសារ។
លំនាំដើម៖ ឈ្មោះ “CN=ChangepointAPICertificate” ឈ្មោះវិញ្ញាបនបត្រ។
ទាមទារ HTTPS ទាមទារ HTTPS (ពិត/មិនពិត)
លំនាំដើម៖ មិនពិត។

Stage 2 ប្រតិបត្តិស្គ្រីបការកំណត់រចនាសម្ព័ន្ធ
ប្រើតម្លៃសម្រាប់ប៉ារ៉ាម៉ែត្រកំណត់រចនាសម្ព័ន្ធដើម្បីកែប្រែការកំណត់រចនាសម្ព័ន្ធរបស់ webគេហទំព័រ។

  1.  បើកប្រអប់បញ្ចូល PowerShell ។
    ចំណាំ៖ ប្រសិនបើម៉ាស៊ីនមេរបស់អ្នកបានបើកការគ្រប់គ្រងគណនីអ្នកប្រើប្រាស់ អ្នកត្រូវតែបើកប្រអប់បញ្ចូល PowerShell ដោយប្រើសិទ្ធិអ្នកគ្រប់គ្រងកម្រិតខ្ពស់។
  2. រុករកទៅ CP web ថតការកំណត់រចនាសម្ព័ន្ធសេវាកម្ម, លំនាំដើម៖
    ការកំណត់រចនាសម្ព័ន្ធCPWebសេវាកម្ម
  3.  ប្រតិបត្តិ ./Configuration_AppAuth.ps1
  4. ធ្វើតាមការណែនាំ។

កំណត់រចនាសម្ព័ន្ធការចូលតែមួយ (SSO) សម្រាប់ WCF Web សេវាកម្ម
កំណត់រចនាសម្ព័ន្ធ PowerShell

  1. បើកប្រអប់បញ្ចូល Windows PowerShell ។
  2. កែប្រែគោលការណ៍ប្រតិបត្តិ៖
    Set-ExecutionPolicy មិនមានការរឹតបន្តឹង

កំណត់រចនាសម្ព័ន្ធ SSO ដោយប្រើ ISAPI សម្រាប់ WCF Web សេវាកម្ម
Stage 1 ប្រមូលប៉ារ៉ាម៉ែត្រកំណត់រចនាសម្ព័ន្ធ
កំណត់តម្លៃសម្រាប់ប៉ារ៉ាម៉ែត្រកំណត់រចនាសម្ព័ន្ធខាងក្រោម។

ប៉ារ៉ាម៉ែត្រ ការពិពណ៌នា
Webសេវាកម្ម_ផ្លូវ ទីតាំងនៃ Changepoint WCF Web សេវាកម្ម web កម្មវិធី files.
លំនាំដើម៖ \API\CP Web សេវាកម្ម
ទាមទារ HTTPS ទាមទារ HTTPS (ពិត/មិនពិត)។
លំនាំដើម៖ មិនពិត។
ចំណុចផ្លាស់ប្តូរ_RSA_
Cookie_Transform
ឈ្មោះវិញ្ញាបនបត្រដែលអ្នកប្រើសម្រាប់ការអ៊ិនគ្រីបខូគី។
លំនាំដើម៖ ឈ្មោះ “CN=ChangepointAPICertificate” ឈ្មោះវិញ្ញាបនបត្រ។
សេវាវិញ្ញាបនបត្រ_ឈ្មោះ បញ្ចូលឈ្មោះវិញ្ញាបនបត្រដែលនឹងត្រូវបានប្រើដើម្បីផ្ទៀងផ្ទាត់សេវាកម្មដល់អតិថិជនដោយប្រើរបៀបសុវត្ថិភាពសារ។
លំនាំដើម៖ ឈ្មោះ “CN=ChangepointAPICertificate” ឈ្មោះវិញ្ញាបនបត្រ។
ចុះហត្ថលេខាលើវិញ្ញាបនបត្រ_ឈ្មោះ បញ្ចូលឈ្មោះវិញ្ញាបនបត្រចុះហត្ថលេខា។ នេះជាឈ្មោះវិញ្ញាបនបត្រដែលអ្នកប្រើសម្រាប់ការចុះហត្ថលេខាលើសារ។
លំនាំដើម៖ ឈ្មោះ “CN=ChangepointAPICertificate” ឈ្មោះវិញ្ញាបនបត្រ។
ISAPI_របៀប របៀប ISAPI ។
លំនាំដើម៖ NT
ISAPI_បឋមកថា បឋមកថាដែលប្រើនៅពេល ISAPI_Mode គឺ “HEADER” ឧទាហរណ៍ample, ទទេ។
ប្រភេទការទាមទារ បញ្ចូលប្រភេទការទាមទារ SSO ។
លំនាំដើម៖ http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn

Stage 2 ប្រតិបត្តិស្គ្រីបការកំណត់រចនាសម្ព័ន្ធ

  1. បើកប្រអប់បញ្ចូល PowerShell ។
    ចំណាំ៖ ប្រសិនបើម៉ាស៊ីនមេរបស់អ្នកបានបើកការគ្រប់គ្រងគណនីអ្នកប្រើប្រាស់ អ្នកត្រូវតែបើកប្រអប់បញ្ចូល PowerShell ដោយប្រើសិទ្ធិអ្នកគ្រប់គ្រងកម្រិតខ្ពស់។
  2. រុករកទៅ CP web ថតការកំណត់រចនាសម្ព័ន្ធសេវាកម្ម, លំនាំដើម៖
    ការកំណត់រចនាសម្ព័ន្ធCPWebសេវាកម្ម
  3. ប្រតិបត្តិ៖ ./Configuration_SSO_ISAPI.ps1
  4. ធ្វើតាមការណែនាំ។

ការកំណត់រចនាសម្ព័ន្ធ SSO ដោយប្រើ WS-Federation (ADFS 2.0) សម្រាប់ WCF Web សេវាកម្ម
Stage 1 ប្រមូលប៉ារ៉ាម៉ែត្រកំណត់រចនាសម្ព័ន្ធ
កំណត់តម្លៃសម្រាប់ប៉ារ៉ាម៉ែត្រកំណត់រចនាសម្ព័ន្ធក្នុងតារាងខាងក្រោម។ ត្រូវប្រាកដថា ADFS_Server_URI ស្ថិតនៅក្នុងតំបន់អ៊ីនត្រាណែតនៃកម្មវិធីរុករករបស់អ្នកប្រើប្រាស់ចុងក្រោយ។
ចំណាំ៖ តាមលំនាំដើម Changepoint ត្រូវបានកំណត់រចនាសម្ព័ន្ធដើម្បីធ្វើបច្ចុប្បន្នភាពដោយស្វ័យប្រវត្តិនូវសោសាធារណៈដែលត្រូវបានប្រើដើម្បីចុះហត្ថលេខាលើសញ្ញាសម្ងាត់ដោយប្រើប្រាស់ឯកសារទិន្នន័យមេតារបស់សហព័ន្ធដែលបានបោះពុម្ពផ្សាយ។ នៅក្នុង ADFS នេះគឺ៖
https://ADFS_Federation.ServiceName/FederationMetadata/2007-06/FederationMetadata.xml
ក្នុងករណីខ្លះ វាប្រហែលជាមិនអាចទៅដល់ម៉ាស៊ីនមេ ADFS ពី Changepoint បានទេ។ web ម៉ាស៊ីនមេ ដូច្នេះអ្នកនឹងត្រូវធ្វើបច្ចុប្បន្នភាពការកំណត់រចនាសម្ព័ន្ធដោយដៃបន្ទាប់ពីដំណើរការស្គ្រីបកំណត់រចនាសម្ព័ន្ធ។ សម្រាប់ព័ត៌មានលម្អិត សូមមើល "ការធ្វើបច្ចុប្បន្នភាពសោសាធារណៈដោយដៃ" នៅទំព័រ 12 ។

ប៉ារ៉ាម៉ែត្រ ការពិពណ៌នា
Webសេវាកម្ម_ផ្លូវ ទីតាំងនៃការផ្លាស់ប្តូរចំណុច WCF Web សេវាកម្ម web កម្មវិធី fileស. លំនាំដើម៖ \API\CP Web សេវាកម្ម
Webសេវាកម្ម_URI ការកំណត់អត្តសញ្ញាណដែនដែលអ្នកប្រើសម្រាប់ Changepoint WCF Web សេវាកម្ម។ សម្រាប់អតីតampឡេ។ , https://changepointapi.abc.corp/CPWebService
Changepoint_RSA_ Cookie_Transform ឈ្មោះវិញ្ញាបនបត្រដែលអ្នកប្រើសម្រាប់ការអ៊ិនគ្រីបខូគី។ លំនាំដើម៖ ឈ្មោះ “CN=ChangepointApiCertificate” ឈ្មោះវិញ្ញាបនបត្រ។
សេវាវិញ្ញាបនបត្រ_ឈ្មោះ ឈ្មោះវិញ្ញាបនបត្រដែលនឹងត្រូវបានប្រើដើម្បីផ្ទៀងផ្ទាត់សេវាកម្មដល់អតិថិជនដោយប្រើរបៀបសុវត្ថិភាពសារ។
លំនាំដើម៖ ឈ្មោះ “CN=ChangepointApiCertificate” ឈ្មោះវិញ្ញាបនបត្រ។
ចុះហត្ថលេខាលើវិញ្ញាបនបត្រ_ឈ្មោះ ឈ្មោះវិញ្ញាបនបត្រដែលអ្នកប្រើសម្រាប់ការចុះហត្ថលេខាលើសារ។
លំនាំដើម៖ ឈ្មោះវិញ្ញាបនបត្រ “CN=ChangepointApiCertificate” ត្រូវបានប្រើ។
ADFS_ ឈ្មោះសេវាសហព័ន្ធ ឈ្មោះសេវាសហព័ន្ធ។ ដើម្បីទទួលបានឈ្មោះ៖ ពីម៉ាស៊ីនមេ ADFS សូមបើកដំណើរការកុងសូលគ្រប់គ្រង ADFS 2.0 ។
•ជ្រើសរើស ADFS 2.0 ពីម៉ឺនុយខាងឆ្វេង។
• ពីផ្ទាំងសកម្មភាព សូមជ្រើសរើស កែសម្រួលលក្ខណសម្បត្តិសេវាកម្មសហព័ន្ធ។
ឈ្មោះសេវាសហព័ន្ធគឺនៅលើផ្ទាំងទូទៅ។
ប្រភេទការទាមទារ ប្រភេទពាក្យបណ្តឹង SSO ។ លំនាំដើមគឺ៖ http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn

Stage 2 ប្រតិបត្តិស្គ្រីបការកំណត់រចនាសម្ព័ន្ធ
កំណត់រចនាសម្ព័ន្ធ webគេហទំព័រដោយប្រើតម្លៃសម្រាប់ប៉ារ៉ាម៉ែត្រកំណត់រចនាសម្ព័ន្ធ។

  1. បើកប្រអប់បញ្ចូល PowerShell ។
    ចំណាំ៖ ប្រសិនបើម៉ាស៊ីនមេរបស់អ្នកបានបើកការគ្រប់គ្រងគណនីអ្នកប្រើប្រាស់ អ្នកត្រូវតែបើកប្រអប់បញ្ចូល PowerShell ដោយប្រើសិទ្ធិអ្នកគ្រប់គ្រងកម្រិតខ្ពស់។
  2. រុករកទៅចំណុចផ្លាស់ប្តូរ web ថតការកំណត់រចនាសម្ព័ន្ធសេវាកម្ម, លំនាំដើម៖ ការកំណត់រចនាសម្ព័ន្ធCPWebសេវាកម្ម
  3.  ប្រតិបត្តិ៖ ./Configuration_SSO_ADFS.ps1
  4. ធ្វើតាមការណែនាំ។

Stage 3 បង្កើតការជឿទុកចិត្តលើភាគី
បង្កើត Relying Party Trust នៅក្នុង ADFS 2.0 Console ។

  1. នៅលើម៉ាស៊ីនមេ ADFS របស់អ្នក បើកដំណើរការកុងសូល ADFS 2.0 ។
  2. ជ្រើសរើស សកម្មភាព > បន្ថែមការទុកចិត្តភាគីដែលពឹងផ្អែក។
  3. ចុចចាប់ផ្តើម។
  4. ជ្រើសរើសនាំចូលទិន្នន័យអំពីភាគីដែលពឹងផ្អែកដែលបានបោះពុម្ពផ្សាយតាមអ៊ីនធឺណិត ឬនៅលើបណ្តាញមូលដ្ឋាន។
  5. បញ្ចូលអាសយដ្ឋានទិន្នន័យមេតារបស់សហព័ន្ធ ហើយបន្ទាប់មកចុច Next សម្រាប់ឧampលេ៖
    https://changepointapi.abc.corp/cpwebservice/federationmetadata/2007-06/federationmetadata.xml
  6. បញ្ចូលឈ្មោះបង្ហាញ ឧ. Changepoint WCF API ហើយចុច Next, Next, Next, បន្ទាប់មក Close។
  7. បន្ថែមច្បាប់ទាមទារសម្រាប់ភាគីផ្លាស់ប្តូរចំណុចយោងខាងលើ។ សម្រាប់ Changepoint ឈ្មោះលំនាំដើមនៃច្បាប់ទាមទារគឺ "UPN"។
  8. គូសផែនទីគុណលក្ខណៈ LDAP “User-Principal-Name” ទៅនឹងប្រភេទការទាមទារចេញ “* UPN” ឬ “UPN”។

ការធ្វើបច្ចុប្បន្នភាពសោសាធារណៈដោយដៃ
ដើម្បីទទួលបាន ADFS Server Token Signing Thumbprint

  1. ពីម៉ាស៊ីនមេ ADFS បើកដំណើរការកុងសូលគ្រប់គ្រង ADFS 2.0 ។
  2. ជ្រើសរើសសេវាកម្ម > វិញ្ញាបនបត្រ ហើយចុចពីរដងលើវិញ្ញាបនបត្រចុះហត្ថលេខាលើសញ្ញាសម្ងាត់។
  3. ជ្រើសរើសផ្ទាំងព័ត៌មានលម្អិត។
  4. ជ្រើសរើសវាលស្នាមមេដៃ។
  5. ដើម្បីទទួលបានតម្លៃស្នាមមេដៃ សូមដកដកឃ្លាទាំងអស់ចេញ រួមទាំងដកឃ្លាដំបូងផងដែរ។

ដើម្បីធ្វើបច្ចុប្បន្នភាព Web.config file

  1. កែសម្រួល ADFS web.config ។ ទីតាំងលំនាំដើមគឺ៖
    EnterpriseRP-STS_ADFS
  2. នៅក្រោម ធាតុ ស្វែងរក ida:FederationMetadataLocation key ហើយជម្រះតម្លៃរបស់វា៖
  3. នៅក្រោម , ស្វែងរក ធាតុហើយជំនួសវាដោយដូចខាងក្រោមៈ https://ADFS_Federation.ServiceName/adfs/services/trust“>https://ADFS_Federation.ServiceName/adfs/services/trust” />

សាកល្បងការភ្ជាប់ COM API

  1. ដំណើរការឧបករណ៍តេស្ត API ។ ទីតាំងលំនាំដើមគឺ៖
    APIAPI ComponentsApiTestKit.exe ។
  2. ចុច Connection String > Encrypter។
  3. នៅក្នុងវាល ខ្សែអក្សរតភ្ជាប់អត្ថបទធម្មតា៖
    ក. ជំនួស SERVERNAME និង DATABASENAME ជាមួយព័ត៌មានមូលដ្ឋានទិន្នន័យរបស់អ្នក។
    ខ. ជំនួស USERID និង PASSWORD ជាមួយនឹងព័ត៌មានគណនីអ្នកប្រើប្រាស់របស់អ្នកគ្រប់គ្រងមូលដ្ឋានទិន្នន័យ។
    គ. បញ្ចូលតម្លៃអស់ពេលតាមតម្រូវការ។
  4. ចុច អ៊ិនគ្រីប។
  5. នៅក្នុងវាល ខ្សែអក្សរតភ្ជាប់ដែលបានអ៊ិនគ្រីប សូមចម្លងអត្ថបទ។
  6. បិទប្រអប់។
  7. នៅលើម៉ឺនុយ API Test Kit សូមចុច Connection> COM API Connection Tester។
  8. នៅក្នុងផ្ទាំង កំណែបច្ចុប្បន្ន សូមបិទភ្ជាប់ខ្សែអក្សរការតភ្ជាប់ដែលបានអ៊ិនគ្រីបទៅក្នុងវាល ខ្សែអក្សរតភ្ជាប់។
  9. នៅក្នុងវាល LoginId និងពាក្យសម្ងាត់ សូមបញ្ចូលលេខសម្គាល់ចូល និងពាក្យសម្ងាត់សម្រាប់គណនី Changepoint របស់អ្នក។
  10. ក្នុង​វាល​កម្រិត​កំណត់​ហេតុ (0-8) បញ្ជាក់​កម្រិត​នៃ​ព័ត៌មាន​កំហុស​ដែល​ត្រូវ​ត្រឡប់​ក្នុង​កំណត់ហេតុ COM API file ប្រសិនបើលទ្ធផលតេស្តបង្ហាញបញ្ហាជាមួយការតភ្ជាប់។
    0 = គ្មានការកត់ត្រា
    1 = ប្រភពវត្ថុ និងវិធីសាស្រ្ត
    2 = សារកំហុស
    3 = ប៉ារ៉ាម៉ែត្របញ្ចូល
    4 = ត្រឡប់
    5 = ព្រមាន
    8 = ប៉ុស្តិ៍ត្រួតពិនិត្យ
    លំនាំដើមគឺ 8 ។
  11. ចុចភ្ជាប់។
    ប្រសិនបើការតភ្ជាប់បានជោគជ័យ សារជោគជ័យត្រូវបានបង្ហាញនៅក្នុងវាលលទ្ធផល។ ប្រសិនបើការតភ្ជាប់បានបរាជ័យ សូមពិនិត្យមើលកំណត់ហេតុ COM API file សម្រាប់កំហុស។ ទីតាំងលំនាំដើមនៃកំណត់ហេតុ file គឺ APIAPILogs

កំពុងពិនិត្យមើលកំណែនៃសមាសធាតុ API ដែលបានដំឡើង
អ្នកអាចប្រើឧបករណ៍ពិនិត្យកំណែ ដើម្បីទទួលបានព័ត៌មានលម្អិតអំពីសមាសធាតុដែលបានដំឡើង រួមទាំងកំណែចេញផ្សាយ និងផ្លូវ។

  1. ដំណើរការ CPVersionChecker.exe ។ ផ្លូវលំនាំដើមគឺ៖ សមាសធាតុ APIAPI
  2. ចុចអាន។

កំពុងពិនិត្យមើលកំណែរបស់អេស Web API សេវាកម្ម

  1. បើកដំណើរការ Internet Explorer ពីម៉ាស៊ីនមេដែលជាកន្លែង Web Services API ត្រូវបានដំឡើង ហើយបញ្ចូលអាសយដ្ឋាន៖
    http://localhost.port/CPWeb.Service/WSLogin.asmx  កន្លែងដែលច្រកគឺជាលេខច្រករបស់ webគេហទំព័រដែលអ្នកបានដំឡើង CPWebសេវាថតនិម្មិត។
  2. នៅលើទំព័រ WLogin សូមចុចលើតំណ GetVersion។
  3. ចុច ហៅ។

ការធ្វើតេស្ត Web ការតភ្ជាប់ API សេវាកម្ម

  1. បើកដំណើរការ Internet Explorer ពីម៉ាស៊ីនមេដែលជាកន្លែង Web Services API ត្រូវបានដំឡើង ហើយបញ្ចូលអាសយដ្ឋាន៖ http://localhost.port/CPWeb.Service/WSLogin.asmx  កន្លែងដែលច្រកគឺជាលេខច្រករបស់ webគេហទំព័រដែលអ្នកបានដំឡើង CPWebសេវាថតនិម្មិត។
  2. នៅលើទំព័រ WSLogin ចុចតំណ TestConnection ។
  3. ចុច ហៅ។ 4. នៅក្នុងលទ្ធផលតេស្តៈ
  • ប្រសិនបើ ធាតុគឺមិនពិត ការតភ្ជាប់សាកល្បងបានជោគជ័យ។
  • ប្រសិនបើ ធាតុគឺពិត ការតភ្ជាប់សាកល្បងបានបរាជ័យ។ សម្រាប់ច្រើនទៀត
    ព័ត៌មានអំពីមូលហេតុនៃការបរាជ័យ សូមមើល និង ធាតុនៅក្នុងលទ្ធផលតេស្ត និងពិនិត្យមើលកំណត់ហេតុ API ។ ផ្លូវលំនាំដើមទៅកាន់កំណត់ហេតុ API គឺ៖ APIAPILogs

ការដំឡើង Web សេវាកម្ម API នៅលើម៉ាស៊ីនមេភាសា

  1. ដើម្បីដាក់ពង្រាយចំណុចផ្លាស់ប្តូរ Web សេវាកម្ម API នៅលើម៉ាស៊ីនមេភាសា អ្នកត្រូវតែបន្ថែម ឬធ្វើបច្ចុប្បន្នភាព tag នៅក្នុង Web API សេវាកម្ម web.config ។ ទីតាំងលំនាំដើមនៃ Web.config file គឺ៖ APICP Web សេវាកម្មWeb.config
  2. ប្រសិនបើ tag មានរួចហើយ ធានាថាទាំងវប្បធម៌ និងគុណលក្ខណៈ uiCulture គឺ "en-US"។
  3. ប្រសិនបើ tag មិន​ទាន់​មាន​ទេ សូម​បន្ថែម​ចំណុច​ខាង​ក្រោម មតិយោបល់ និង ធាតុទៅweb> ថ្នាំង៖web>
    ជម្រើស Visual Basic៖ កំណត់យ៉ាងតឹងរឹង = "ពិត" ដើម្បីមិនអនុញ្ញាតការបំប្លែងប្រភេទទិន្នន័យទាំងអស់ ដែលការបាត់បង់ទិន្នន័យអាចកើតឡើង។ កំណត់ explicit = "true" ដើម្បីបង្ខំការប្រកាសនៃអថេរទាំងអស់។ ->
  4. ចាប់ផ្តើម IIS ឡើងវិញ។

ឯកសារ/ធនធាន

PDF thumbnailកម្មវិធី API
Installation Guide · API, Software, API Software

សួរសំណួរ

Use this section to ask about setup, compatibility, troubleshooting, or anything missing from this manual.

សួរសំណួរ

Ask about setup, compatibility, troubleshooting, or anything missing from this manual. Name and email are optional.