API တပ်ဆင်ခြင်းလမ်းညွှန်
အကိုးအကားလမ်းညွှန်
ပြောင်းလဲမှုအမှတ် 2021

© 2021 Changepoint Canada ULC မူပိုင်ခွင့်အားလုံး လက်ဝယ်ရှိသည်။ US အစိုးရ၏အခွင့်အရေးများ- US အစိုးရမှ အသုံးပြုခြင်း၊ ပွားခြင်း သို့မဟုတ် ထုတ်ဖော်ခြင်းတို့သည် 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 Services Enhancements (WSE) ဝန်ဆောင်မှု။ Changepoint API အကြောင်း အချက်အလက်အတွက်၊ Changepoint API ရည်ညွှန်းချက်ကို ကြည့်ပါ။ အဆင့်မြှင့်မှတ်စုများ၊ သတိပေးချက်များ နှင့် သိပြီးသားပြဿနာများအတွက်၊ Changepoint ရှိ အဖွဲ့ဖိုင်တွဲများရှိ ဖြန့်ချိရေးမှတ်စုများကို ကြည့်ပါ။
Changepoint API ကို အဆင့်မြှင့်တင်ခြင်း။
အကယ်၍ သင်သည် Changepoint ၏ယခင်ထုတ်လွှတ်မှုမှ အဆင့်မြှင့်တင်နေပါက၊ ဤဗားရှင်းကိုမထည့်သွင်းမီ Changepoint API ၏ယခင်ဗားရှင်းနှင့် ၎င်း၏အစိတ်အပိုင်းများကို ဖယ်ရှားရန် Windows Control Panel ကိုအသုံးပြုပါ။
Changepoint API လိုအပ်ချက်များ
Changepoint API ကို မထည့်သွင်းမီ Changepoint ကို ထည့်သွင်းရပါမည်။ ဆော့ဖ်ဝဲလ်လိုအပ်ချက်များအတွက်၊ Changepoint ရှိ 2021 ထုတ်ဝေမှုမှတ်စုများနှင့် Patches အဖွဲ့ဖိုင်တွဲတွင် ရနိုင်သော Changepoint Software Compatibility Matrix ကို ကြည့်ပါ။
File လမ်းစဉ်များ
ဤစာတမ်းတစ်လျှောက်လုံးတွင် ဘုံလမ်းကြောင်းများအတွက် အောက်ပါသဘောတူညီချက်များကို အသုံးပြုသည်-

• Changepoint ထည့်သွင်းခြင်း၏ အမြစ်လမ်းကြောင်း။
  မူရင်းလမ်းကြောင်းမှာ-
  C: အစီအစဉ် Files (x86)ChangepointChangepoint
• Login Settings utility ကဲ့သို့သော အသုံးများသော Changepoint utilities အတွက် root တည်နေရာ။
  မူရင်းလမ်းကြောင်းမှာ-
  C: အစီအစဉ် Files (x86) အဖြစ်များပါတယ် FilesChangepointChangepoint

Changepoint API ကို ထည့်သွင်းခြင်း။

1. Changepoint API media root directory မှ setup.exe ကို run ပါ။
2. Select Features မျက်နှာပြင်ပေါ်လာသည်အထိ အချက်ပြမှုများကို လိုက်နာပါ။
3. သင်ထည့်သွင်းလိုသည့် အင်္ဂါရပ်များကို ရွေးပါ၊ ထို့နောက် Next ကိုနှိပ်ပါ။
4. API ဦးတည်ရာဖိုင်တွဲ၊ မူရင်းကို ရွေးပါ။ API နှင့် Next ကိုနှိပ်ပါ။
   မှတ်ချက် - Changepoint Login Settings utility တွင် ထည့်သွင်းထားသည်။ သင်သတ်မှတ်ထားသည့် ဦးတည်ရာဖိုင်တွဲကို မည်သို့ပင်ဖြစ်စေ လော့ဂ်အင်ဆက်တင်များ။
5. သင်ရွေးချယ်ခဲ့လျှင် Web ဝန်ဆောင်မှု API- a. ဘယ်အချိန်မှာ Select လုပ်မလဲ။
   a Web Site screen ပေါ်လာရင် a ကိုရွေးပါ။ webဆိုက်သို့ virtual directory ကိုထည့်ရန်၊ ထို့နောက် Next ကိုနှိပ်ပါ။
   ခ ရှေ့ဆက်ရန် Next ကိုနှိပ်ပါ။ 6. API တပ်ဆင်မှုပြီးသွားသောအခါ Finish ကိုနှိပ်ပါ။

ကက်ရှ်သိရှိရန် Changepoint API ကို ပြင်ဆင်သတ်မှတ်ခြင်း။
Changepoint API ကို cache-aware ဖြစ်စေရန် configure လုပ်ရန်၊ “cache အတွက် တန်ဖိုးများကို အစားထိုးပါ။ စကားဝှက်" နှင့် "ကက်ရှ်။ CP ရှိ ဆာဗာများ” သော့များ Web ဝန်ဆောင်မှုများWeb.config file Enterprise တွင်အသုံးပြုသောတန်ဖိုးများနှင့်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. Log ကိုသတ်မှတ်ပါ။Fileမဂ်။ မူရင်းတန်ဖိုးသည် APIAPILogs 3. LogLevel ကို သတ်မှတ်ပါ။ မှန်ကန်သောတန်ဖိုးများမှာ-
   0 = သစ်ခုတ်ခြင်း မရှိပါ။
   1 = အရင်းအမြစ်အရာဝတ္ထုနှင့် နည်းလမ်း
   2 = အမှားသတင်းစကား
   3 = ထည့်သွင်းမှုဘောင်များ
   4 = ပြန်လာ
   5 = သတိပေးချက်
   8 = စစ်ဆေးရေးဂိတ်

virtual directory authentication အတွက် ပြင်ဆင်ခြင်း။ Web ဝန်ဆောင်မှု API
သင်သည် အမည်မသိအသုံးပြုခွင့်ကို ဖွင့်ပြီး CP အတွက် ပေါင်းစပ်ထားသော Windows စစ်မှန်ကြောင်းကို ပိတ်ရပါမည်။WebInternet Information Services (IIS) တွင် ဝန်ဆောင်မှုပေးသော virtual directory ပိုမိုသိရှိလိုပါက၊ Microsoft IIS စာရွက်စာတမ်းအား ကြည့်ပါ။
ဒေတာဘေ့စ်ချိတ်ဆက်မှု ဆက်တင်များကို ပြင်ဆင်သတ်မှတ်ခြင်း။ Web ဝန်ဆောင်မှု API
ဒေတာဘေ့စ်ချိတ်ဆက်မှုဆက်တင်များကို စာဝှက်ရန် လော့ဂ်အင်ဆက်တင်များ utility ကိုသုံးပါ။ Web ဝန်ဆောင်မှု API Web.config file. ပိုမိုသိရှိလိုပါက၊ Changepoint တပ်ဆင်ခြင်းလမ်းညွှန်တွင် “ဒေတာဘေ့စ်ချိတ်ဆက်မှု ဆက်တင်များကို ပြင်ဆင်သတ်မှတ်ခြင်း” ကို ရှာဖွေပါ။
Changepoint WCF အတွက် စစ်မှန်ကြောင်း အထောက်အထား သတ်မှတ်ခြင်း Web ဝန်ဆောင်မှုများ
Changepoint WCF အတွက် Application Authentication နှင့် single sign-on (SSO) ကို သင် configure လုပ်နိုင်ပါသည်။ Web ဝန်ဆောင်မှုများ။
Secure Token Service (STS) ကို အသုံးပြု၍ အောက်ပါ အကောင်အထည်ဖော်မှု ရွေးချယ်စရာများကို ရရှိနိုင်ပါသည်။

• ISAPI SSL ကို အသုံးပြု၍ SSO ကို ရွေးချယ်နိုင်သည်။
• WS-Federation (ADFS 2.0) SSL ကို အသုံးပြု၍ SSO လိုအပ်သည်။

SSL လိုအပ်ပါက၊ ဖွဲ့စည်းမှုပုံစံ script သည် ၎င်းကိုအသုံးပြုကြောင်းသေချာစေသည်။
ISAPI အတွက် ဖွဲ့စည်းမှုပုံစံ script များနှင့် အပလီကေးရှင်း စစ်မှန်ကြောင်း အထောက်အထားများသည် SSL ကို ရွေးချယ်နိုင်သည် ။
WCF အတွက် အပလီကေးရှင်း စစ်မှန်ကြောင်း အတည်ပြုခြင်းကို သတ်မှတ်ခြင်း Web ဝန်ဆောင်မှုများ
Changepoint WCF အတွက် မူရင်းအထောက်အထားစိစစ်ခြင်းအမျိုးအစား Web ဝန်ဆောင်မှုများသည် အပလီကေးရှင်း အထောက်အထားစိစစ်ခြင်း ဖြစ်သည်။
ဤကဏ္ဍရှိ လုပ်ထုံးလုပ်နည်းများကို အသုံးပြုရန်-

• Changepoint WCF ကို စီစဉ်သတ်မှတ်ပါ။ Web SSL ဖြင့် အပလီကေးရှင်း အထောက်အထားစိစစ်ခြင်းကို အသုံးပြုရန် ဝန်ဆောင်မှုများ
• Changepoint WCF ကို ပြန်ပြောင်း Web SSO အကောင်အထည်ဖော်မှုတစ်ခုအား အကောင်အထည်ဖော်ပြီးနောက် လျှောက်လွှာကို စစ်မှန်ကြောင်းအတည်ပြုခြင်းအတွက် ဝန်ဆောင်မှုများ

PowerShell ကို စီစဉ်သတ်မှတ်ပါ။

1. Windows PowerShell အမှာစာတစ်ခုဖွင့်ပါ။
2. အကောင်အထည်ဖော်မှုမူဝါဒကို ပြင်ဆင်ပါ-
   Set-ExecutionPolicy ကို ကန့်သတ်မထားဘူး။

Stage 1 ပြင်ဆင်သတ်မှတ်မှုဘောင်များကို စုဆောင်းပါ။
configuration parameters များအတွက် တန်ဖိုးများကို သတ်မှတ်ပါ။

ကန့်သတ်ချက်	ဖော်ပြချက်
Webဝန်ဆောင်မှု_လမ်းကြောင်း	Changepoint WCF ၏တည်နေရာ Web ဝန်ဆောင်မှုများ web လျှောက်လွှာ files. မူရင်း- \API\CP Web ဝန်ဆောင်မှုများ
ဝန်ဆောင်မှုလက်မှတ်_ နာမည်	Message လုံခြုံရေးမုဒ်ကို အသုံးပြု၍ ဝန်ဆောင်မှုကို သုံးစွဲသူများထံ စစ်မှန်ကြောင်းအထောက်အထားပြရန် အသုံးပြုမည့် လက်မှတ်အမည်။ မူရင်း- “CN=ChangepointAPICertificate” လက်မှတ်အမည်။
HTTPS လိုအပ်သည်။	HTTPS လိုအပ်သည် (မှန်/မမှန်) မူရင်း- မှားသည်။

Stage 2 ဖွဲ့စည်းမှုပုံစံ script များကို လုပ်ဆောင်ပါ။
configuration parameters များအတွက် တန်ဖိုးများကို အသုံးပြု၍ configuration ကို ပြင်ဆင်ပါ။ webဆိုဒ်များ

1.  PowerShell အမှာစာတစ်ခုဖွင့်ပါ။
   မှတ်ချက် - သင့်ဆာဗာတွင် အသုံးပြုသူအကောင့်ထိန်းချုပ်မှုဖွင့်ထားပါက၊ သင်သည် မြင့်မားသောစီမံခန့်ခွဲသူခွင့်ပြုချက်များကို အသုံးပြု၍ PowerShell အမှာစာအားဖွင့်ရပါမည်။
2. CP သို့သွားပါ။ web ဝန်ဆောင်မှုဖွဲ့စည်းပုံလမ်းညွှန်၊ မူရင်း-
   ConfigurationCPWebဝန်ဆောင်မှု
3.  ./Configuration_AppAuth.ps1 ကို လုပ်ဆောင်ပါ။
4. လမ်းညွှန်ချက်များကို လိုက်နာပါ။

WCF အတွက် တစ်ခုတည်းသော အကောင့်ဖွင့်ခြင်း (SSO) ကို ပြင်ဆင်သတ်မှတ်ခြင်း။ Web ဝန်ဆောင်မှုများ
PowerShell ကို စီစဉ်သတ်မှတ်ပါ။

1. Windows PowerShell အမှာစာတစ်ခုဖွင့်ပါ။
2. အကောင်အထည်ဖော်မှုမူဝါဒကို ပြင်ဆင်ပါ-
   Set-ExecutionPolicy ကို ကန့်သတ်မထားဘူး။

WCF အတွက် ISAPI ကို အသုံးပြု၍ SSO ကို ပြင်ဆင်ခြင်း Web ဝန်ဆောင်မှုများ
Stage 1 ပြင်ဆင်သတ်မှတ်မှုဘောင်များကို စုဆောင်းပါ။
အောက်ပါဖွဲ့စည်းမှုဘောင်များအတွက် တန်ဖိုးများကို သတ်မှတ်ပါ။

ကန့်သတ်ချက်	ဖော်ပြချက်
Webဝန်ဆောင်မှု_လမ်းကြောင်း	Changepoint WCF ၏တည်နေရာ Web ဝန်ဆောင်မှုများ web လျှောက်လွှာ files. မူရင်း- \API\CP Web ဝန်ဆောင်မှုများ
HTTPS လိုအပ်သည်။	HTTPS (မှန်/မှား) လိုအပ်သည်။ မူရင်း- မှားသည်။
Changepoint_RSA_ Cookie_Transform	Cookie ကုဒ်ဝှက်ခြင်းအတွက် သင်အသုံးပြုသော လက်မှတ်အမည်။ မူရင်း- “CN=ChangepointAPICertificate” လက်မှတ်အမည်။
ဝန်ဆောင်မှုလက်မှတ်_အမည်	Message လုံခြုံရေးမုဒ်ကို အသုံးပြု၍ ဝန်ဆောင်မှုကို သုံးစွဲသူများထံ စစ်မှန်ကြောင်းအထောက်အထားပြရန် အသုံးပြုမည့် လက်မှတ်အမည်ကို ထည့်သွင်းပါ။ မူရင်း- “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 ဖွဲ့စည်းမှုပုံစံ script များကို လုပ်ဆောင်ပါ။

1. PowerShell အမှာစာတစ်ခုဖွင့်ပါ။
   မှတ်ချက် - သင့်ဆာဗာတွင် အသုံးပြုသူအကောင့်ထိန်းချုပ်မှုဖွင့်ထားပါက၊ သင်သည် မြင့်မားသောစီမံခန့်ခွဲသူခွင့်ပြုချက်များကို အသုံးပြု၍ PowerShell အမှာစာအားဖွင့်ရပါမည်။
2. CP သို့သွားပါ။ web ဝန်ဆောင်မှုဖွဲ့စည်းပုံလမ်းညွှန်၊ မူရင်း-
   ConfigurationCPWebဝန်ဆောင်မှု
3. လုပ်ဆောင်ရန်- ./Configuration_SSO_ISAPI.ps1
4. လမ်းညွှန်ချက်များကို လိုက်နာပါ။

WCF အတွက် WS-Federation (ADFS 2.0) ကို အသုံးပြု၍ SSO ကို ပြင်ဆင်ခြင်း။ Web ဝန်ဆောင်မှုများ
Stage 1 ပြင်ဆင်သတ်မှတ်မှုဘောင်များကို စုဆောင်းပါ။
ဇယားရှိ configuration parameters များအတွက် တန်ဖိုးများကို အောက်တွင် သတ်မှတ်ပါ။ ADFS_Server_URI သည် အသုံးပြုသူ၏ဘရောက်ဆာ၏ Intranet ဇုန်တွင်ရှိကြောင်း သေချာပါစေ။
မှတ်ချက် - မူရင်းအားဖြင့်၊ Changepoint သည် ထုတ်ဝေထားသော ဖယ်ဒရေးရှင်း မက်တာဒေတာစာရွက်စာတမ်းကို အသုံးပြုခြင်းဖြင့် လုံခြုံရေးတိုကင်များကို လက်မှတ်ထိုးရန် အသုံးပြုသည့် အများသူငှာသော့များကို အလိုအလျောက် အပ်ဒိတ်လုပ်ရန် စီစဉ်ထားပါသည်။ ADFS တွင် ဤအရာသည်-
https://ADFS_Federation.ServiceName/FederationMetadata/2007-06/FederationMetadata.xml
အချို့ကိစ္စများတွင် Changepoint မှ ADFS ဆာဗာသို့ ရောက်ရှိရန် မဖြစ်နိုင်ပါ။ web ဆာဗာသည် configuration script ကို run ပြီးနောက် configuration ကို manually update လုပ်ရမည်ဖြစ်ပါသည်။ အသေးစိတ်အတွက်၊ စာမျက်နှာ 12 ရှိ “အများပြည်သူသော့များကို ကိုယ်တိုင်မွမ်းမံခြင်း” ကို ကြည့်ပါ။

ကန့်သတ်ချက်	ဖော်ပြချက်
Webဝန်ဆောင်မှု_လမ်းကြောင်း	Changepoint WCF ၏တည်နေရာ Web ဝန်ဆောင်မှုများ web လျှောက်လွှာ file၎။ မူရင်း- \API\CP Web ဝန်ဆောင်မှုများ
Webဝန်ဆောင်မှု_URI	Changepoint WCF အတွက် သင်အသုံးပြုသော Domain identifier Web ဝန်ဆောင်မှုများ။ ဟောင်းအတွက်ample.၊ https://changepointapi.abc.corp/CPWebService
Changepoint_RSA_ Cookie_Transform	Cookie ကုဒ်ဝှက်ခြင်းအတွက် သင်အသုံးပြုသော လက်မှတ်အမည်။ မူရင်း- “CN=ChangepointApiCertificate” လက်မှတ်အမည်။
ဝန်ဆောင်မှုလက်မှတ်_အမည်	Message လုံခြုံရေးမုဒ်ကို အသုံးပြု၍ ဝန်ဆောင်မှုကို သုံးစွဲသူများထံ စစ်မှန်ကြောင်းအထောက်အထားပြရန် အသုံးပြုမည့် လက်မှတ်အမည်။ မူရင်း- “CN=ChangepointApiCertificate” လက်မှတ်အမည်။
လက်မှတ် ရေးထိုးခြင်း_အမည်	မက်ဆေ့ချ်များ လက်မှတ်ရေးထိုးရန်အတွက် သင်အသုံးပြုသော လက်မှတ်အမည်။ မူရင်း- “CN=ChangepointApiCertificate” လက်မှတ်အမည်ကို အသုံးပြုထားသည်။
ADFS_ FederationServiceName	အဖွဲ့ချုပ်ဝန်ဆောင်မှုအမည်။ အမည်ကိုရယူရန်- ADFS ဆာဗာမှ၊ ADFS 2.0 Management console ကိုဖွင့်ပါ။ •ဘယ်ဘက်မီနူးမှ ADFS 2.0 ကိုရွေးချယ်ပါ။ •လုပ်ဆောင်ချက်အကန့်မှ Edit Federation Service Properties ကိုရွေးပါ။ Federation Service Name သည် General tab တွင်ရှိသည်။
တောင်းဆိုမှုအမျိုးအစား	SSO တောင်းဆိုမှုအမျိုးအစား။ မူရင်းမှာ- http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn

Stage 2 ဖွဲ့စည်းမှုပုံစံ script များကို လုပ်ဆောင်ပါ။
Configure လုပ်ပါ။ webconfiguration parameters များအတွက် တန်ဖိုးများကို အသုံးပြုထားသော sites များ။

1. PowerShell အမှာစာတစ်ခုဖွင့်ပါ။
   မှတ်ချက် - သင့်ဆာဗာတွင် အသုံးပြုသူအကောင့်ထိန်းချုပ်မှုဖွင့်ထားပါက၊ သင်သည် မြင့်မားသောစီမံခန့်ခွဲသူခွင့်ပြုချက်များကို အသုံးပြု၍ PowerShell အမှာစာအားဖွင့်ရပါမည်။
2. Changepoint သို့သွားပါ။ web ဝန်ဆောင်မှုဖွဲ့စည်းပုံလမ်းညွှန်၊ မူရင်း- ConfigurationCPWebဝန်ဆောင်မှု
3.  လုပ်ဆောင်ရန်- ./Configuration_SSO_ADFS.ps1
4. လမ်းညွှန်ချက်များကို လိုက်နာပါ။

Stage 3 အားကိုးအားထားပြုသောပါတီကိုဖန်တီးပါ။
ADFS 2.0 Console တွင် Relying Party Trust ကို ဖန်တီးပါ။

1. သင်၏ ADFS ဆာဗာတွင် ADFS 2.0 ကွန်ဆိုးလ်ကို စတင်ပါ။
2. Action > Add Relying Party Trust ကို ရွေးပါ။
3. Start ကိုနှိပ်ပါ။
4. အွန်လိုင်း သို့မဟုတ် ဒေသတွင်း ကွန်ရက်ပေါ်တွင် လွှင့်တင်ထားသည့် အားကိုးရသော ပါတီအကြောင်း ဒေတာတင်သွင်းမှုကို ရွေးချယ်ပါ။
5. အဖွဲ့ချုပ် မက်တာဒေတာလိပ်စာကို ရိုက်ထည့်ပါ၊ ဥပမာ ဥပမာ- Next ကိုနှိပ်ပါ။ample-
   https://changepointapi.abc.corp/cpwebservice/federationmetadata/2007-06/federationmetadata.xml
6. ပြသမှုအမည်၊ ဥပမာ Changepoint WCF API ကိုထည့်ပါ၊ ထို့နောက် Next၊ Next၊ Next၊ ထို့နောက် Close ကိုနှိပ်ပါ။
7. အထက်ဖော်ပြပါ Changepoint Relying Party အတွက် တောင်းဆိုမှု စည်းကမ်းကို ထည့်ပါ။ Changepoint အတွက်၊ မူရင်းတောင်းဆိုမှု စည်းမျဉ်းအမည်မှာ "UPN" ဖြစ်သည်။
8. LDAP ရည်ညွှန်းချက် “User-Principal-Name” ကို အထွက်တောင်းဆိုမှုအမျိုးအစား “* UPN” သို့မဟုတ် “UPN” သို့ မြေပုံဆွဲပါ။

အများသူငှာသော့များကို ကိုယ်တိုင်မွမ်းမံခြင်း။
ADFS Server Token Signing Thumbprint ကို ရယူရန်

1. ADFS ဆာဗာမှ ADFS 2.0 Management console ကိုဖွင့်ပါ။
2. ဝန်ဆောင်မှု > လက်မှတ်များကို ရွေးပြီး တိုကင်လက်မှတ်ထိုးခြင်း လက်မှတ်ကို နှစ်ချက်နှိပ်ပါ။
3. Details tab ကို ရွေးပါ။
4. Thumbprint အကွက်ကို ရွေးပါ။
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 Test Kit ကိုဖွင့်ပါ။ မူရင်းတည်နေရာမှာ-
   APIAPI ComponentsApiTestKit.exe။
2. Connection String > Encrypter ကို နှိပ်ပါ။
3. Plain Text Connections String အကွက်တွင်-
   a SERVERNAME နှင့် DATABASENAME ကို သင်၏ဒေတာဘေ့စ်အချက်အလက်ဖြင့် အစားထိုးပါ။
   ခ USERID နှင့် PASSWORD အား သင်၏ဒေတာဘေ့စ်စီမံခန့်ခွဲသူအသုံးပြုသူအကောင့်အချက်အလက်ဖြင့် အစားထိုးပါ။
   ဂ။ အချိန်ကုန်တန်ဖိုးကို လိုအပ်သလို ထည့်ပါ။
4. Encrypt ကိုနှိပ်ပါ။
5. ကုဒ်ဝှက်ထားသော ချိတ်ဆက်မှုကြိုးအကွက်တွင် စာသားကို ကူးယူပါ။
6. dialog box ကိုပိတ်ပါ။
7. API Test Kit မီနူးတွင်၊ ချိတ်ဆက်မှု > COM API ချိတ်ဆက်မှု စမ်းသပ်သူကို နှိပ်ပါ။
8. လက်ရှိဗားရှင်းတက်ဘ်တွင်၊ ကုဒ်ဝှက်ထားသော ချိတ်ဆက်မှုစာကြောင်းကို ချိတ်ဆက်မှုကြိုးအကွက်ထဲသို့ ကူးထည့်ပါ။
9. LoginId နှင့် Password အကွက်များတွင်၊ သင်၏ Changepoint အကောင့်အတွက် လော့ဂ်အင် ID နှင့် စကားဝှက်ကို ရိုက်ထည့်ပါ။
10. Loglevel (0-8) အကွက်တွင်၊ COM API မှတ်တမ်းတွင် ပြန်ပေးမည့် အမှားအချက်အလက်အဆင့်ကို သတ်မှတ်ပါ။ file အကယ်၍ စမ်းသပ်မှုရလဒ်သည် ချိတ်ဆက်မှုတွင် ပြဿနာတစ်ခု ပြနေပါက၊
    0 = သစ်ခုတ်ခြင်း မရှိပါ။
    1 = အရင်းအမြစ်အရာဝတ္ထုနှင့် နည်းလမ်း
    2 = အမှားသတင်းစကား
    3 = ထည့်သွင်းမှုဘောင်များ
    4 = ပြန်လာ
    5 = သတိပေးချက်
    8 = စစ်ဆေးရေးဂိတ်
    မူရင်းမှာ ၁။
11. Connect ကိုနှိပ်ပါ။
    ချိတ်ဆက်မှုအောင်မြင်ပါက၊ ရလဒ်အကွက်တွင် အောင်မြင်မှုမက်ဆေ့ချ်ကို ပြသမည်ဖြစ်သည်။ ချိတ်ဆက်မှု မအောင်မြင်ပါက COM API မှတ်တမ်းကို စစ်ဆေးပါ။ file အမှားများအတွက်။ မှတ်တမ်း၏ မူရင်းတည်နေရာ file သည် APIAPILogs

ထည့်သွင်းထားသော API အစိတ်အပိုင်းများ၏ ဗားရှင်းကို စစ်ဆေးခြင်း။
ဖြန့်ချိသည့်ဗားရှင်းနှင့် လမ်းကြောင်းအပါအဝင် ထည့်သွင်းထားသည့် အစိတ်အပိုင်းများအကြောင်းအသေးစိတ်အချက်အလက်များကို ရယူရန် ဗားရှင်းစစ်ဆေးသည့်ကိရိယာကို သင်အသုံးပြုနိုင်သည်။

1. CPVersionChecker.exe ကိုဖွင့်ပါ။ မူရင်းလမ်းကြောင်းမှာ- APIAPI အစိတ်အပိုင်းများ
2. Read ကိုနှိပ်ပါ။

ဗားရှင်းကို စစ်ဆေးခြင်း။ Web ဝန်ဆောင်မှု API

1. အဆိုပါဆာဗာမှ Internet Explorer ကိုဖွင့်ပါ။ Web ဝန်ဆောင်မှု API ကို ထည့်သွင်းပြီး လိပ်စာကို ထည့်ပါ-
   http://localhost.port/CPWeb.Service/WSLogin.asmx  port က port နံပါတ်ဘယ်မှာလဲ။ webCP ကို ​​သင်တပ်ဆင်သည့်နေရာWebဝန်ဆောင်မှု virtual လမ်းညွှန်။
2. WLogin စာမျက်နှာတွင်၊ GetVersion လင့်ခ်ကို နှိပ်ပါ။
3. Invoke ကိုနှိပ်ပါ။

စမ်းသပ်ခြင်း။ Web ဝန်ဆောင်မှု API ချိတ်ဆက်မှု

1. အဆိုပါဆာဗာမှ Internet Explorer ကိုဖွင့်ပါ။ Web ဝန်ဆောင်မှု API ကို ထည့်သွင်းပြီး လိပ်စာကို ထည့်ပါ- http://localhost.port/CPWeb.Service/WSLogin.asmx  port က port နံပါတ်ဘယ်မှာလဲ။ webCP ကို ​​သင်တပ်ဆင်သည့်နေရာWebဝန်ဆောင်မှု virtual လမ်းညွှန်။
2. WLogin စာမျက်နှာတွင် TestConnection လင့်ခ်ကို နှိပ်ပါ။
3. Invoke ကိုနှိပ်ပါ။ 4. စမ်းသပ်မှုရလဒ်များတွင်-

• ရှိရင် အစိတ်အပိုင်းသည် မှားယွင်းနေသည်၊ စမ်းသပ်ချိတ်ဆက်မှု အောင်မြင်ခဲ့သည်။
• ရှိရင် အစိတ်အပိုင်းမှန်သည်၊ စမ်းသပ်ချိတ်ဆက်မှု မအောင်မြင်ပါ။ ပို
  ပျက်ကွက်ရခြင်းအကြောင်းရင်းများဆိုင်ရာ အချက်အလက်များကို ကြည့်ရှုပါ။ နှင့် စမ်းသပ်မှုရလဒ်များတွင် အစိတ်အပိုင်းများနှင့် API မှတ်တမ်းများကို စစ်ဆေးပါ။ API မှတ်တမ်းများဆီသို့ မူရင်းလမ်းကြောင်းမှာ- APIAPILogs

ကိုသတ်မှတ်ခြင်း။ Web ဘာသာစကားဆာဗာတွင် ဝန်ဆောင်မှုများ API

1. Changepoint ကို အသုံးချရန် Web ဝန်ဆောင်မှု API ကို ဘာသာစကားဆာဗာတွင် သင်ထည့်သွင်းရမည် သို့မဟုတ် အပ်ဒိတ်လုပ်ရမည်။ tag ၌ Web ဝန်ဆောင်မှု API web.config. ပုံသေတည်နေရာ Web.config file သည်- APICP Web ဝန်ဆောင်မှုများWeb.config
2. အကယ်၍ tag ရှိနှင့်ပြီးသား၊ ယဉ်ကျေးမှုနှင့် uiCulture ရည်ညွှန်းချက်များသည် "en-US" ဖြစ်ကြောင်း သေချာပါစေ။
3. အကယ်၍ tag မရှိသေးပါ၊ အောက်ပါတို့ကို ထည့်ပါ။ ၊ မှတ်ချက် ၊ နှင့် မှဒြပ်စင်web> node-web>
   Visual Basic ရွေးစရာများ- ဒေတာဆုံးရှုံးမှုများ ဖြစ်ပွားနိုင်သည့် ဒေတာအမျိုးအစား ပြောင်းလဲမှုများအားလုံးကို ခွင့်မပြုရန် တင်းကျပ်သော=”အမှန်” သတ်မှတ်ပါ။ variable အားလုံးကို ကြေငြာရန် အတင်းအကြပ် explicit=”true” ကို သတ်မှတ်ပါ။ ->
4. IIS ကိုပြန်လည်စတင်ပါ။

စာရွက်စာတမ်းများ / အရင်းအမြစ်များ

Changepoint API ဆော့ဖ်ဝဲ [pdf] တပ်ဆင်ခြင်းလမ်းညွှန် API, Software, API Software

ကိုးကား

• အသုံးပြုသူလက်စွဲ