Ntuziaka nwụnye API
Ntuziaka ntụaka
Ebe mgbanwe 2021

© 2021 Changepoint Canada ULC Ikike niile echekwabara. Ikike Gọọmenti US-Iji, mbigharị, ma ọ bụ mkpughe site n'aka gọọmentị US nọ n'okpuru mmachi dị ka egosipụtara na nkwekọrịta ikike Changepoint Canada ULC yana dịka enyere na DFARS 227.7202-1(a) na 227.7202-3(a) (1995), DFARS 252.227-7013(c)(1)(ii) (OCT 1988), FAR 12.212(a) (1995), FAR 52.227-19, ma ọ bụ FAR 52.227-14 (ALT III), dị ka ọdabara. Ngwaahịa a nwere ozi nzuzo yana nzuzo azụmaahịa nke Changepoint Canada ULC. Amachibidoro ngosi na-enweghị ikike ederede ozugbo nke Changepoint Canada ULC. Iji ngwaahịa a dabere na usoro na ọnọdụ nke nkwekọrịta ikike onye ọrụ na Changepoint Canada ULC. Enwere ike imepụtaghachi akwụkwọ naanị site na ikikere maka ojiji ime. Enweghị ike ịgbanwe ọdịnaya nke akwụkwọ a, gbanwee ma ọ bụ gbanwee na-enweghị nkwenye ederede nke Changepoint Canada ULC. Changepoint Canada ULC nwere ike ịgbanwe ọdịnaya akọwapụtara ebe a n'oge ọ bụla, yana ma ọ bụ na-enweghị ọkwa.

Ịwụnye Changepoint API

Banyere ịwụnye Changepoint API
Changepoint API dị ka COM API, ọrụ Windows Communication Foundation (WCF) yana maka ndakọrịta azụ, dịka Web Ọrụ nkwalite ọrụ (WSE). Maka ozi gbasara Changepoint API, hụ ntụnye aka Changepoint API. Maka ndetu nkwalite, caveats na ihe ndị ama ama, lee ndetu mwepụta na nchekwa otu na Changepoint.
Na-akwalite Changepoint API
Ọ bụrụ na ị na-emelite site na ntọhapụ mbụ nke Changepoint, jiri Windows Control Panel ka ịwepụ ụdị Changepoint API nke gara aga na akụkụ ya tupu ịwụnye ụdị a.
Changepoint API chọrọ
Ị ga-etinyerịrị Changepoint tupu ịwụnye Changepoint API. Maka ihe chọrọ sọftụwia, hụ Changepoint Software Compatibility Matrix, nke dị na 2021 ndetu mwepụta na nchekwa otu patches na Changepoint.
File ụzọ mgbakọ
N'ime akwụkwọ a niile, a na-eji nkwekọrịta ndị a maka ụzọ nkịtị:

• Ụzọ mgbọrọgwụ nke nrụnye Changepoint.
  Ụzọ ndabara bụ:
  C: Mmemme Files (x86)Ebe mgbanwe mgbanwe
• Mgbọrọgwụ ọnọdụ maka ngwa Changepoint nkịtị, dị ka akụrụngwa Ntọala Nbanye.
  Ụzọ ndabara bụ:
  C: Mmemme Files (x86) nkịtị FilesChangepointChangepoint

Ịwụnye Changepoint API

1. Site na ndekọ mgbọrọgwụ mgbasa ozi Changepoint API, mee setup.exe.
2. Soro kpaliri ruo mgbe Họrọ atụmatụ ihuenyo gosiri.
3. Họrọ atụmatụ ndị ịchọrọ ịwụnye, wee pịa Ọzọ.
4. Họrọ ebe nchekwa ebe API, nke ndabara API, wee pịa Ọzọ.
   Mara: Awụnyere akụrụngwa nbanye Changepoint nbanye Ntọala nbanye, n'agbanyeghị ebe nchekwa ebe ị na-ezipụta.
5. Ọ bụrụ na ị họrọ Web API ọrụ: a. Mgbe Họrọ
   a Web Ihuenyo saịtị na-egosi, họrọ a websaịtị ịgbakwunye mebere ndekọ ka, wee pịa Ọzọ.
   b. Pịa Ọzọ ka ịga n'ihu. 6. Mgbe echichi nke API zuru ezu, pịa N'isi.

Ịhazi Changepoint API ka ọ mara cache
Iji hazie Changepoint API ka ọ mara nke ọma, dochie ụkpụrụ maka “cache. Okwuntughe" na "cache". Igodo sava” dị na CP Web ỌrụWeb.config file na ụkpụrụ eji na EnterpriseWeb.config file.
Na-eme Web Mmelite ọrụ (WSE)

1. Dezie nke Web.config file maka web ọrụ. Ebe ndabara bụ:
   APICP Web ỌrụWeb.config
2. Chọta ihe atụ atọ nke ahịrị nkọwa ndị a:
   <!- ​​Uncomment na-esonụ mmewere ma ọ bụrụ na ị na-eji Web API nkwalite ọrụ (WSE). Hapụ nkọwa ma ọ bụrụ na ị na-eji ọrụ WCF ma anaghị etinye ya Web Mmelite ọrụ (WSE) ->
3. Weghachite mmewere nke na-esote ihe atụ ọ bụla nke ahịrị nkọwa:
   <section name=”microsoft.web.ọrụ2″ … >webỌrụ>web.ọrụ2>
   Mara: NkewebỌrụ> ihe a na-agaghị ekwupụta bụ nwa nkeweb>.

Na-ahazi ndekọ maka Web API ọrụ
Ị ga-edozi ndekọ ahụ file ụzọ na ndekọ ọkwa. Ọkwa ndekọ na-agbakọta. Maka example, ọ bụrụ na ị kọwapụta ọkwa 3, yabụ ọkwa 1, 2 na 3 abanyela. Ọkwa ndekọ nke ndabara bụ 8.

1. Dezie nke web ọrụ Web.config. Ebe ndabara bụ:
   APICP Web ỌrụWeb.config
2. Tọọ LogFileỤzọ. Uru ndabara bụ APIAPILogs. 3. Tọọ LogLevel. Ụkpụrụ ziri ezi bụ:
   0 = Enweghị ndekọ
   1 = Isi ihe na usoro
   2 = Ozi mperi
   3 = Ntinye ntinye
   4 = nloghachi
   5 = Ịdọ aka ná ntị
   8 = Ebe nlele

Na-ahazi njirimara ndekọ ndekọ aha maka ndị Web API ọrụ
Ị ga-emerịrị ohere na-amaghị aha wee gbanyụọ njirimara Windows jikọtara ọnụ maka CPWebAkwụkwọ ndekọ aha mebere ọrụ na Ọrụ Ozi Ịntanetị (IIS). Maka ozi ndị ọzọ, hụ akwụkwọ Microsoft IIS.
Na-ahazi ntọala njikọ nchekwa data maka ndị Web API ọrụ
Jiri ikike ntọala nbanye iji zoo ntọala njikọ nchekwa data dị na Web API ọrụ Web.config file. Maka ozi ndị ọzọ, chọọ “Nhazi Njikọ Database” na ntuziaka nwụnye Changepoint.
Na-ahazi nyocha maka Changepoint WCF Web Ọrụ
Ị nwere ike hazie nyocha ngwa yana otu ntinye aka (SSO) maka Changepoint WCF Web Ọrụ.
Nhọrọ mmejuputa iwu ndị a dị site na iji Secure Token Service (STS):

• SSO na-eji ISAPI SSL nhọrọ
• SSO na-eji WS-Federation (ADFS 2.0) SSL chọrọ

Ọ bụrụ na achọrọ SSL, edemede nhazi ahụ na-achọpụta na ejiri ya.
Ederede nhazi maka ISAPI na nyocha ngwa nwere ike mee ka SSL nwee nhọrọ.
Na-ahazi njirimara ngwa maka WCF Web Ọrụ
Ụdị njirimara ndabara maka Changepoint WCF Web Ọrụ bụ nyocha ngwa.
Jiri usoro ndị dị na ngalaba a:

• hazie Changepoint WCF Web Ọrụ iji jiri nyocha SSL jiri nyocha ngwa
• tụgharịa Changepoint WCF Web Ọrụ maka nyocha ngwa ka emechara otu n'ime mmemme SSO

Hazie PowerShell

1. Mepee ngwa ngwa Windows PowerShell.
2. Gbanwee amụma mkpochapụ:
   Iwu Setịpụ-Emebe Egbochighi

Stage 1 Anakọta paramita nhazi
Kpebie ụkpụrụ maka paramita nhazi.

Oke	Nkọwa
WebỤzọ_ọrụ	Ebe Changepoint WCF Web Ọrụ web ngwa files. Ebube: API \ CP Web Ọrụ
Asambodo ọrụ_ Aha	Aha asambodo nke a ga-eji gosi ndị ahịa ọrụ site na iji ọnọdụ nche ozi. Ndi an-kpọ: aha Asambodo “CN=ChangepointAPICertificate.
chọrọ HTTPS	Chọrọ HTTPS (Eziokwu/Ụgha) Ebube: Ụgha.

Stage 2 Mee scripts nhazi
Jiri ụkpụrụ maka nhazi nhazi iji gbanwee nhazi nke websaịtị.

1.  Mepee ngwa ngwa PowerShell.
   Mara: Ọ bụrụ na ihe nkesa gị nwere ikike njikwa akaụntụ onye ọrụ, ị ga-emepe ngwa ngwa PowerShell site na iji ikike nchịkwa dị elu.
2. Gaa na CP web ndekọ nhazi ọrụ, ndabara:
   Nhazi CPWebỌrụ
3.  Mezue ./Configuration_AppAuth.ps1
4. Soro kpaliri.

Na-ahazi otu nbanye (SSO) maka WCF Web Ọrụ
Hazie PowerShell

1. Mepee ngwa ngwa Windows PowerShell.
2. Gbanwee amụma mkpochapụ:
   Iwu Setịpụ-Emebe Egbochighi

Na-ahazi SSO site na iji ISAPI maka WCF Web Ọrụ
Stage 1 Anakọta paramita nhazi
Kpebie ụkpụrụ maka paramita nhazi ndị a.

Oke	Nkọwa
WebỤzọ_ọrụ	Ọnọdụ nke Changepoint WCF Web Ọrụ web ngwa files. Ebube: API \ CP Web Ọrụ
chọrọ HTTPS	Chọrọ HTTPS (Eziokwu/Ụgha). Ebube: Ụgha.
Changepoint_RSA_ Kuki_Trangharịa	Aha asambodo ị na-eji maka izo ya ezo kuki. Ndi an-kpọ: aha Asambodo “CN=ChangepointAPICertificate.
Asambodo ọrụ_Aha	Tinye aha asambodo nke a ga-eji gosi ndị ahịa ọrụ site na iji ọnọdụ nche ozi. Ndi an-kpọ: aha Asambodo “CN=ChangepointAPICertificate.
Ịbanye Asambodo_Aha	Tinye aha akwụkwọ mbinye aka. Nke a bụ aha asambodo ị na-eji maka ịbanye ozi. Ndi an-kpọ: aha Asambodo “CN=ChangepointAPICertificate.
ISAPI_Mode	Ụdị ISAPI. Emepụtara: NT
ISAPI_isi	nkụnye eji isi mee mgbe ISAPI_Mode bụ "HEADER", maka example, oghere.
ClaimType	Tinye Ụdị Nkwupụta SSO. Ebube: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn

Stage 2 Mee scripts nhazi

1. Mepee ngwa ngwa PowerShell.
   Mara: Ọ bụrụ na ihe nkesa gị nwere ikike njikwa akaụntụ onye ọrụ, ị ga-emepe ngwa ngwa PowerShell site na iji ikike nchịkwa dị elu.
2. Gaa na CP web ndekọ nhazi ọrụ, ndabara:
   Nhazi CPWebỌrụ
3. Mee: ./Configuration_SSO_ISAPI.ps1
4. Soro kpaliri.

Na-ahazi SSO site na iji WS-Federation (ADFS 2.0) maka WCF Web Ọrụ
Stage 1 Anakọta paramita nhazi
Kpebie ụkpụrụ maka nhazi nhazi na tebụl, n'okpuru. Gbaa mbọ hụ na ADFS_Server_URI nọ na mpaghara intranet nke ihe nchọgharị onye njedebe.
Mara: Site na ndabara, a na-ahazi Changepoint ka ọ na-emelite igodo ọha na-akpaghị aka nke a na-eji abịanye aka na akara nchekwa site na iji akwụkwọ metadata nke ọgbakọ ebipụtara. Na ADFS nke a bụ:
https://ADFS_Federation.ServiceName/FederationMetadata/2007-06/FederationMetadata.xml
N'ọnọdụ ụfọdụ ọ nwere ike ọ gaghị ekwe omume iru ihe nkesa ADFS site na Changepoint web ihe nkesa ya mere ị ga-eji aka gị melite nhazi ahụ mgbe ị gbasịrị edemede nhazi. Maka nkọwapụta, lee “iji aka na-emelite igodo ọha” na ibe 12.

Oke	Nkọwa
WebỤzọ_ọrụ	Ebe Changepoint WCF Web Ọrụ web ngwa files. Ebube: API \ CP Web Ọrụ
WebỌrụ_URI	Ihe nchọpụta ngalaba ị na-eji maka Changepoint WCF Web Ọrụ. Maka example., https://changepointapi.abc.corp/CPWebService
Changepoint_RSA_ kuki_Transform	Aha asambodo ị na-eji maka izo ya ezo kuki. Ndi an-kpọ: aha Asambodo “CN=ChangepointApiCertificate.
Asambodo ọrụ_Aha	Aha asambodo nke a ga-eji gosi ndị ahịa ọrụ site na iji ọnọdụ nche ozi. Ndi an-kpọ: aha Asambodo “CN=ChangepointApiCertificate.
Ịbanye Asambodo_Aha	Aha asambodo ị na-eji maka ịbanye ozi. Ihe ndabara: a na-eji aha Asambodo “CN=ChangepointApiCertificate”.
ADFS_ FederationAha Ọrụ	Aha Ọrụ Federation. Iji nweta aha: Site na ihe nkesa ADFS, Mwepụta njikwa njikwa ADFS 2.0. • Họrọ ADFS 2.0 site na menu aka ekpe. • Site na pane Action họrọ Dezie Njirimara Ọrụ Federation. Aha Ọrụ Federation dị na taabụ General.
ClaimType	Ụdị nkwuputa SSD. Ihe ndabara bụ: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn

Stage 2 Mee scripts nhazi
Hazie ya websaịtị na-eji ụkpụrụ maka paramita nhazi.

1. Mepee ngwa ngwa PowerShell.
   Mara: Ọ bụrụ na ihe nkesa gị nwere ikike njikwa akaụntụ onye ọrụ, ị ga-emepe ngwa ngwa PowerShell site na iji ikike nchịkwa dị elu.
2. Gaa na ebe mgbanwe web ndekọ nhazi ọrụ, ndabara: Nhazi CPWebỌrụ
3.  Mee: ./Configuration_SSO_ADFS.ps1
4. Soro kpaliri.

Stage 3 Mepụta ntụkwasị obi ndị ọzọ
Mepụta ntụkwasị obi nke otu ntụkwasị obi na ADFS 2.0 Console.

1. Na ihe nkesa ADFS gị, malite ADFS 2.0 console.
2. Họrọ Omume > Tinye ntụkwasị obi Party.
3. Pịa Malite.
4. Họrọ Bubata data gbasara otu na-adabere na ya bipụtara na ntanetị ma ọ bụ na netwọk mpaghara.
5. Tinye adreesị metadata nke Federation, wee pịa Ọzọ, maka exampLe:
   https://changepointapi.abc.corp/cpwebservice/federationmetadata/2007-06/federationmetadata.xml
6. Tinye aha ngosi, dịka Changepoint WCF API, wee pịa Ọzọ, Ọzọ, Ọzọ, wee mechie.
7. Tinye Iwu nkwuputa maka otu Changepoint Relying Party a dị n'elu. Maka Changepoint, aha iwu ebubo ndabara bụ "UPN".
8. Maapụ njiri mara LDAP “Aha onye-isi-aha” na ụdị nkwuputa na-apụ apụ “* UPN” ma ọ bụ “UPN”.

Iji aka na-emelite igodo ọha
Iji nweta akara mkpịsị aka akara ADFS Server

1. Site na ihe nkesa ADFS, Mwepụta njikwa njikwa ADFS 2.0.
2. Họrọ Ọrụ > Asambodo, wee pịa akwụkwọ nbinye aka Token ugboro abụọ.
3. Họrọ taabụ nkọwa.
4. Họrọ mpaghara mkpịsị aka mkpịsị aka.
5. Iji nweta uru mkpịsị aka mkpịsị aka, wepụ oghere niile gụnyere oghere mbụ.

Ka imelite ihe Web.config file

1. Dezie ADFS web.config. Ebe ndabara bụ:
   EnterpriseRP-STS_ADFS
2. N'okpuru mmewere, chọta ida:FederationMetadataLocation igodo wee kpochapụ uru ya:
   
3. N'okpuru , chọta nke mmewere ma jiri ihe ndị a dochie ya: https://ADFS_Federation.ServiceName/adfs/services/trust">https://ADFS_Federation.ServiceName/adfs/services/trust" />

Na-anwale njikọ COM API

1. Gbaa ngwa ule API. Ebe ndabara bụ:
   APIAPI ComponentsApiTestKit.exe.
2. Pịa eriri njikọ> Encrypter.
3. N'ime mpaghara eriri njikọ ederede dị larịị:
   a. Dochie SERVERNAME na DATABASENAME na ozi nchekwa data gị.
   b. Dochie USERID na PASSWORD site na iji ozi akaụntụ onye nchịkwa nchekwa data gị.
   c. Tinye uru oge agwụcha dịka achọrọ.
4. Pịa Encrypt.
5. Na mpaghara eriri Njikọ ezoro ezo, detuo ederede.
6. Mechie igbe okwu.
7. Na menu ngwa ule API, pịa Njikọ> COM API Connection Tester.
8. Na taabụ Ụdị Ugbu a, mado eriri njikọ ezoro ezo n'ime ogige Njikọ Njikọ.
9. Na LoginId na Paswọdu ubi, tinye nbanye ID na paswọọdụ gị Changepoint akaụntụ.
10. Na mpaghara Loglevel (0-8), kọwapụta ọkwa nke ozi njehie a ga-eweghachi na ndekọ COM API file ọ bụrụ na nsonaazụ ule gosipụtara nsogbu na njikọ ahụ.
    0 = Enweghị ndekọ
    1 = Isi ihe na usoro
    2 = Ozi mperi
    3 = Ntinye ntinye
    4 = nloghachi
    5 = Ịdọ aka ná ntị
    8 = Ebe nlele
    Ihe ndabere bụ 8.
11. Pịa Jikọọ.
    Ọ bụrụ na njikọ ahụ gara nke ọma, a ga-egosipụta ozi ịga nke ọma n'ubi nsonaazụ. Ọ bụrụ na njikọ ahụ dara, lelee ndekọ COM API file maka njehie. Ebe ndabara nke ndekọ ahụ file bụ APIAPILogs.

Na-enyocha ụdị ngwa ngwa API arụnyere
Ị nwere ike iji ihe nlele ụdị ụdị nweta nkọwa gbasara akụrụngwa arụnyere, gụnyere ụdị ntọhapụ na ụzọ.

1. Gbaa CPVersionChecker.exe. Ụzọ ndabara bụ: Ngwa APIAPI
2. Pịa Gụọ.

Na-enyocha ụdị nke Web API ọrụ

1. Mepee Internet Explorer site na sava ebe Web arụnyere API ọrụ, ma tinye adreesị:
   http://localhost.port/CPWeb.Service/WSLogin.asmx  ebe ọdụ ụgbọ mmiri bụ nọmba ọdụ ụgbọ mmiri nke websaịtị ebe ị wụnyere CPWebAkwụkwọ ndekọ aha ọrụ.
2. Na ibe WSLogin, pịa njikọ GetVersion.
3. Pịa ịkpọ oku.

Na-anwale nke Web Njikọ API ọrụ

1. Mepee Internet Explorer site na sava ebe Web arụnyere API ọrụ, ma tinye adreesị: http://localhost.port/CPWeb.Service/WSLogin.asmx  ebe ọdụ ụgbọ mmiri bụ nọmba ọdụ ụgbọ mmiri nke websaịtị ebe ị wụnyere CPWebAkwụkwọ ndekọ aha ọrụ.
2. Na ibe WSLogin pịa njikọ TestConnection.
3. Pịa ịkpọ oku. 4. Na nsonaazụ ule:

• Ọ bụrụ mmewere bụ ụgha, njikọ ule gara nke ọma.
• Ọ bụrụ mmewere bụ eziokwu, njikọ ule dara. Maka ihe ndị ọzọ
  ozi na ihe kpatara ọdịda, hụ na na ihe ndị dị na nsonaazụ ule, wee lelee ndekọ API. Ụzọ ndabara na ndekọ API bụ: APIAPILogs

Ịtọlite ​​​​nke Web API ọrụ na sava asụsụ

1. Ka ibuga Changepoint Web API ọrụ na sava asụsụ, ị ga-agbakwunye ma ọ bụ melite ya tag n'ime Web API ọrụ web.config. Ebe ndabara nke Web.config file bụ: APICP Web ỌrụWeb.config
2. Ọ bụrụ na tag adịlarị, hụ na ma omenala na uiCulture bụ "en-US."
3. Ọ bụrụ na tag enwebeghịrị, tinye ihe ndị a , ikwu okwu, na ọcha naweb> ọnụ:web>
   Visual Basic nhọrọ: Tọọ siri ike =" ezi" ka jụ niile data ụdị mgbanwe ebe data ọnwụ nwere ike ime. Tọọ n'ụzọ doro anya ="eziokwu" iji manye nkwupụta nke mgbanwe niile. –>
4. Malitegharịa ekwentị IIS.

Akwụkwọ / akụrụngwa

Ngwa Changepoint API [pdf] Ntuziaka nwụnye API, Akụrụngwa, API Ngwanrọ

Ntụaka

• Akwụkwọ ntuziaka onye ọrụ