Stiùireadh stàlaidh bathar-bog Changepoint API

Stiùireadh stàlaidh API
Stiùireadh iomraidh
Atharrachadh puing 2021

© 2021 Changepoint Canada ULC Gach còir glèidhte. Còraichean Riaghaltais na SA - Tha cleachdadh, dùblachadh, no foillseachadh le Riaghaltas na SA fo smachd cuingealachaidhean mar a tha air a mhìneachadh ann an aonta ceadachais Changepoint Canada ULC agus mar a tha air a sholarachadh ann an DFARS 227.7202-1(a) agus 227.7202-3(a) (1995), DFARS 252.227-7013(c)(1)(ii) (OCT 1988), FAR 12.212(a) (1995), FAR 52.227-19, no FAR 52.227-14 (ALT III), mar a tha iomchaidh. Anns an toradh seo tha fiosrachadh dìomhair agus dìomhaireachdan malairt Changepoint Canada ULC. Thathas a’ toirmeasg foillseachadh às aonais cead sgrìobhte ro-làimh bho Changepoint Canada ULC. Tha cleachdadh an toraidh seo an urra ri teirmichean is cumhaichean Aonta Cead an neach-cleachdaidh le Changepoint Canada ULC. Chan fhaod ach neach-ceadachaidh na sgrìobhainnean ath-riochdachadh airson an cleachdadh a-staigh. Chan fhaod susbaint na sgrìobhainn seo atharrachadh, atharrachadh no atharrachadh gun chead sgrìobhte soilleir bho Changepoint Canada ULC. Faodaidh Changepoint Canada ULC an susbaint a tha air a shònrachadh an seo atharrachadh aig àm sam bith, le fios no às aonais fios.

A’ stàladh an API Changepoint

Mu dheidhinn an API Changepoint a stàladh
Tha an API Changepoint ri fhaighinn mar COM API, seirbheis Windows Communication Foundation (WCF) agus, airson co-chòrdalachd air ais, mar a Web Seirbheis Leasachaidhean Seirbheisean (WSE). Airson fiosrachadh mun API Changepoint, faic Iomradh API Changepoint. Airson notaichean ùrachadh, uaimhean agus cùisean aithnichte, faic an Notaichean fuasglaidh ann am pasganan sgioba ann an Changepoint.
Ag ùrachadh an API Changepoint
Ma tha thu ag ùrachadh bho fhoillseachadh roimhe de Changepoint, cleachd Pannal Smachd Windows gus an tionndadh roimhe den API Changepoint agus na co-phàirtean aige a dhì-stàladh mus stàlaich thu an dreach seo.
Riatanasan API Changepoint
Feumaidh tu Changepoint a stàladh mus stàlaich thu an API Changepoint. Airson riatanasan bathar-bog, faic Matrix Co-fhreagarrachd Bathar-bog Changepoint, a tha ri fhaighinn ann am pasgan sgioba Notaichean Fuasglaidh 2021 agus Patches ann an Changepoint.
File gnàthasan slighe
Tron sgrìobhainn seo, thathas a’ cleachdadh na gnàthasan a leanas airson slighean cumanta:

• Prìomh shlighe an stàlaidh Changepoint.
  Is e an t-slighe bunaiteach:
  C: Prògram Files (x86)ChangepointChangepoint
• An t-àite bunaiteach airson goireasan cumanta Changepoint, leithid goireas Login Settings.
  Is e an t-slighe bunaiteach:
  C: Prògram Files (x86) Cumanta FilesChangepointChangepoint

A’ stàladh an API Changepoint

1. Bho eòlaire freumhan meadhanan Changepoint API, ruith setup.exe.
2. Lean na molaidhean gus an nochd an sgrìn Tagh Feartan.
3. Tagh na feartan a tha thu airson a stàladh, agus an uairsin cliog An ath-.
4. Tagh am pasgan ceann-uidhe API, bunaiteach API, agus cliog An ath-.
   Thoir an aire: Tha goireas Changepoint Login Settings air a chuir a-steach LoginSettings, ge bith dè am pasgan ceann-uidhe a shònraicheas tu.
5. Ma thagh thu an Web Seirbheisean API: a. Nuair a bhios an Tagh
   a Web Nochdaidh sgrion na làraich, tagh a weblàrach-lìn gus an eòlaire brìgheil a chuir ris, agus an uairsin cliog An ath-.
   b. Cliog air Next gus leantainn air adhart. 6. Nuair a bhios an stàladh an API deiseil, cliog Crìochnaich.

A’ rèiteachadh an API Changepoint gus a bhith mothachail air tasgadan
Gus an API Changepoint a rèiteachadh gus a bhith mothachail air tasgadan, cuir na luachan airson an “cache. Facal-faire" agus "cache. Servers” iuchraichean anns a’ CP Web SeirbheiseanWeb.config file leis na luachan a thathar a’ cleachdadh san IomairtWeb.config file.
A’ comasachadh Web Leasachaidhean seirbheis (WSE)

1. Deasaich an Web.config file airson web seirbhisean. Is e an t-àite bunaiteach:
   APICP Web SeirbheiseanWeb.config
2. Lorg na trì eisimpleirean den loidhne bheachdan a leanas:
   <!- ​​Thoir beachd air an eileamaid a leanas ma tha thu a’ cleachdadh Web API Leasachaidhean Seirbheis (WSE). Fàg beachdan ma tha thu a’ cleachdadh seirbheisean WCF agus nach eil thu gan stàladh Web Leasachaidhean Seirbheis (WSE) ->
3. Thoir iomradh air an eileamaid a tha a’ leantainn gach eisimpleir den loidhne bheachdan:
   <section name=”microsoft.web.seirbheisean2″ … >webSeirbheisean>web.seirbhis2>
   Thoir an aire: Tha anwebSeirbheisean > eileamaid ri bhith gun iomradh is leanabh deweb>.

A rèiteachadh logadh a-steach airson an Web API seirbheisean
Feumaidh tu an clàr a shuidheachadh file ìrean slighe agus log. Tha na h-ìrean log tionalach. Airson example, ma shònraicheas tu ìre 3, thèid ìrean 1, 2, agus 3 a chlàradh. Is e an ìre logaidh bunaiteach 8.

1. Deasaich an web seirbhisean Web.config. Is e an t-àite bunaiteach:
   APICP Web SeirbheiseanWeb.config
2. Suidhich an LogFileSlighe. Tha an luach bunaiteach APIAPILlogs. 3. Suidhich an LogLevel. Is iad na luachan dligheach:
   0 = Gun chlàradh
   1 = Bun nì agus modh
   2 = Teachdaireachd mearachd
   3 = Paramadairean cuir a-steach
   4 = Tilleadh
   5 = Rabhadh
   8 = puing-seic

A’ rèiteachadh dearbhadh eòlaire brìgheil airson an Web API seirbheisean
Feumaidh tu ruigsinneachd gun urra a chomasachadh agus dearbhadh Windows Amalaichte a dhì-cheadachadh airson an CPWebEòlaire brìgheil seirbheis ann an Seirbheisean Fiosrachaidh Eadar-lìn (IIS). Airson tuilleadh fiosrachaidh, faic na sgrìobhainnean Microsoft IIS.
A' rèiteachadh roghainnean ceangail stòr-dàta airson an Web API seirbheisean
Cleachd an goireas Login Settings gus na roghainnean ceangail stòr-dàta a chrioptachadh anns an fhaidhle Web API seirbheisean Web.config file. Airson tuilleadh fiosrachaidh, rannsaich airson “Configuring Database Connection Settings” anns an Changepoint Installation Guide.
A’ rèiteachadh dearbhadh airson Changepoint WCF Web Seirbheisean
Faodaidh tu Dearbhadh Iarrtais agus soidhnigeadh singilte (SSO) a rèiteachadh airson Changepoint WCF Web Seirbheisean.
Tha na roghainnean buileachaidh a leanas rim faighinn a’ cleachdadh Secure Token Service (STS):

• SSO a’ cleachdadh ISAPI SSL roghainneil
• SSO a’ cleachdadh WS-Federation (ADFS 2.0) SSL a dhìth

Ma tha feum air SSL, bidh an sgriobt rèiteachaidh a’ dèanamh cinnteach gun tèid a chleachdadh.
Faodaidh na sgriobtaichean rèiteachaidh airson ISAPI agus dearbhadh tagraidh comas a thoirt do SSL.
A’ rèiteachadh dearbhadh tagraidh airson WCF Web Seirbheisean
An seòrsa dearbhaidh bunaiteach airson Changepoint WCF Web Tha seirbheisean mar dhearbhadh tagraidh.
Cleachd na modhan-obrach san earrann seo gu:

• rèiteachadh Changepoint WCF Web Seirbheisean gus dearbhadh tagraidh a chleachdadh le SSL
• thoir air ais Changepoint WCF Web Seirbheisean gu dearbhadh tagraidh às deidh dhaibh aon de na gnìomhan SSO a chuir an gnìomh

Dèan rèiteachadh air PowerShell

1. Fosgail puing Windows PowerShell.
2. Atharraich am poileasaidh cur gu bàs:
   Set-CoileanadhPoileasaidh Gun bhacadh

Stage 1 Cruinnich crìochan rèiteachaidh
Obraich a-mach luachan airson na paramadairean rèiteachaidh.

Paramadair	Tuairisgeul
WebSeirbheis_Slighe	Àite an Changepoint WCF Web Seirbheisean web tagradh files. Ro-shealladh: \ API CP Web Seirbheisean
Teisteanas Seirbheis_ Ainm	Ainm teisteanais a thèid a chleachdadh gus an t-seirbheis a dhearbhadh do luchd-dèiligidh a’ cleachdadh modh tèarainteachd Teachdaireachd. Bun-stèidh: an t-ainm teisteanais “CN = ChangepointAPICertificate”.
feum air HTTPS	Feumaidh HTTPS (Fìor / Meallta) Default: Meallta.

Stage 2 Cuir an gnìomh sgriobtaichean rèiteachaidh
Cleachd na luachan airson na paramadairean rèiteachaidh gus rèiteachadh an fhaidhle atharrachadh weblàraichean.

1.  Fosgail puing PowerShell.
   Thoir an aire: Ma tha Smachd Cunntas Cleachdaiche air a chomasachadh don t-seirbheisiche agad, feumaidh tu am putan PowerShell fhosgladh a’ cleachdadh ceadan rianadair àrdaichte.
2. Seòl chun CP web eòlaire rèiteachaidh seirbheis, bunaiteach:
   ConfigurationCPWebSeirbheis
3.  Cuir an gnìomh ./Configuration_AppAuth.ps1
4. Lean na molaidhean.

A’ rèiteachadh soidhnigeadh singilte (SSO) airson WCF Web Seirbheisean
Dèan rèiteachadh air PowerShell

1. Fosgail puing Windows PowerShell.
2. Atharraich am poileasaidh cur gu bàs:
   Set-CoileanadhPoileasaidh Gun bhacadh

A’ rèiteachadh SSO a’ cleachdadh ISAPI airson WCF Web Seirbheisean
Stage 1 Cruinnich crìochan rèiteachaidh
Obraich a-mach luachan airson nam paramadairean rèiteachaidh a leanas.

Paramadair	Tuairisgeul
WebSeirbheis_Slighe	Àite an Changepoint WCF Web Seirbheisean web tagradh files. Ro-shealladh: \ API CP Web Seirbheisean
feum air HTTPS	Feumaidh HTTPS (Fìor / Meallta). Default: Meallta.
Atharrachadh puing_RSA_ Cookie_Cruth-atharrachadh	Ainm an teisteanais a chleachdas tu airson crioptachadh Cookie. Bun-stèidh: an t-ainm teisteanais “CN = ChangepointAPICertificate”.
SeirbheisCertificate_Ainm	Cuir a-steach ainm an teisteanais a thèid a chleachdadh gus an t-seirbheis a dhearbhadh do luchd-dèiligidh a’ cleachdadh modh tèarainteachd Teachdaireachd. Bun-stèidh: an t-ainm teisteanais “CN = ChangepointAPICertificate”.
A' soidhnigeadh Teisteanas_Ainm	Cuir a-steach ainm an teisteanais soidhnidh. Seo ainm an teisteanais a chleachdas tu airson teachdaireachdan a shoidhnigeadh. Bun-stèidh: an t-ainm teisteanais “CN = ChangepointAPICertificate”.
ISAPI_Modh	Modh ISAPI. Bun-stèidh: NT
ISAPI_Ceannard	Is e am bann-cinn a thèid a chleachdadh nuair a tha ISAPI_Mode “HEADER”, airson example, bàn.
Seòrsa tagraidh	Cuir a-steach an seòrsa tagraidh SSO. Ro-shealladh: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn

Stage 2 Cuir an gnìomh sgriobtaichean rèiteachaidh

1. Fosgail puing PowerShell.
   Thoir an aire: Ma tha Smachd Cunntas Cleachdaiche air a chomasachadh don t-seirbheisiche agad, feumaidh tu am putan PowerShell fhosgladh a’ cleachdadh ceadan rianadair àrdaichte.
2. Seòl chun CP web eòlaire rèiteachaidh seirbheis, bunaiteach:
   ConfigurationCPWebSeirbheis
3. Cur gu bàs: ./Configuration_SSO_ISAPI.ps1
4. Lean na molaidhean.

A’ rèiteachadh SSO a’ cleachdadh WS-Federation (ADFS 2.0) airson WCF Web Seirbheisean
Stage 1 Cruinnich crìochan rèiteachaidh
Obraich a-mach na luachan airson na crìochan rèiteachaidh sa chlàr, gu h-ìosal. Dèan cinnteach gu bheil an ADFS_Server_URI ann an sòn eadra-lìon brabhsair an neach-cleachdaidh deireannach.
Thoir an aire: Gu gnàthach, tha Changepoint air a rèiteachadh gus na h-iuchraichean poblach ùrachadh gu fèin-ghluasadach a thathas a ’cleachdadh gus comharran tèarainteachd a shoidhnigeadh le bhith a’ cleachdadh sgrìobhainn meata-dàta a ’chaidreachais foillsichte. Ann an ADFS tha seo:
https://ADFS_Federation.ServiceName/FederationMetadata/2007-06/FederationMetadata.xml
Ann an cuid de chùisean is dòcha nach bi e comasach am frithealaiche ADFS a ruighinn bhon Changepoint web frithealaiche gus am feum thu an rèiteachadh ùrachadh le làimh às deidh dhut an sgriobt rèiteachaidh a ruith. Airson mion-fhiosrachadh, faic “Ag ùrachadh iuchraichean poblach le làimh” air duilleag 12.

Paramadair	Tuairisgeul
WebSeirbheis_Slighe	Àite an Changepoint WCF Web Seirbheisean web tagradh files. Ro-shealladh: \ API CP Web Seirbheisean
WebSeirbheis_URI	Aithneadair àrainn a chleachdas tu airson Changepoint WCF Web Seirbheisean. Airson example., https://changepointapi.abc.corp/CPWebService
Changepoint_RSA_ Cookie_Transform	Ainm an teisteanais a chleachdas tu airson crioptachadh Cookie. Bun-stèidh: an t-ainm teisteanais “CN = ChangepointApiCertificate”.
SeirbheisCertificate_Ainm	Ainm teisteanais a thèid a chleachdadh gus an t-seirbheis a dhearbhadh do luchd-dèiligidh a’ cleachdadh modh tèarainteachd Teachdaireachd. Bun-stèidh: an t-ainm teisteanais “CN = ChangepointApiCertificate”.
A' soidhnigeadh Teisteanas_Ainm	Ainm an teisteanais a chleachdas tu airson teachdaireachdan a shoidhnigeadh. Default: tha an t-ainm teisteanais “CN = ChangepointApiCertificate” air a chleachdadh.
ADFS_ FederationServiceName	Ainm seirbheis Caidreachas. Gus an t-ainm fhaighinn: Bho fhrithealaiche ADFS, cuir air bhog consol ADFS 2.0 Management. • Tagh ADFS 2.0 bhon chlàr chlì. • Bhon phannal Gnìomh tagh Deasaich Feartan Seirbheis Caidreachas. Tha Ainm Seirbheis a’ Chaidreachais air an taba Coitcheann.
Seòrsa tagraidh	Seòrsa Tagraidh SSO. Is e am bun-bheachd: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn

Stage 2 Cuir an gnìomh sgriobtaichean rèiteachaidh
Dèan rèiteachadh air an weblàraich a’ cleachdadh nan luachan airson nam paramadairean rèiteachaidh.

1. Fosgail puing PowerShell.
   Thoir an aire: Ma tha Smachd Cunntas Cleachdaiche air a chomasachadh don t-seirbheisiche agad, feumaidh tu am putan PowerShell fhosgladh a’ cleachdadh ceadan rianadair àrdaichte.
2. Seòl gu Changepoint web eòlaire rèiteachadh seirbheis, bunaiteach: ConfigurationCPWebSeirbheis
3.  Cur gu bàs: ./Configuration_SSO_ADFS.ps1
4. Lean na molaidhean.

Stage 3 Cruthaich earbsa pàrtaidh earbsach
Cruthaich Urras Pàrtaidh Relying ann an ADFS 2.0 Console.

1. Air an t-seirbheisiche ADFS agad, cuir air bhog consol ADFS 2.0.
2. Tagh Gnìomh > Cuir Urras Pàrtaidh an urra ris.
3. Cliog air Start.
4. Tagh Import dàta mun phàrtaidh earbsach a chaidh fhoillseachadh air-loidhne no air lìonra ionadail.
5. Cuir a-steach seòladh meata-dàta Caidreachas, agus an uairsin cliog An ath-, airson example:
   https://changepointapi.abc.corp/cpwebservice/federationmetadata/2007-06/federationmetadata.xml
6. Cuir a-steach ainm Taisbeanaidh, me Changepoint WCF API, agus cliog Air adhart, Air adhart, Air adhart, an uairsin Dùin.
7. Cuir Riaghailt Tagraidh ris airson a’ Phàrtaidh Atharrachadh Point Relying gu h-àrd. Airson Changepoint, is e an t-ainm riaghailt tagraidh bunaiteach “UPN”.
8. Mapa am feart LDAP “Prìomh-Ainm-Cleachdaiche” gu Seòrsa Tagraidh a-mach “* UPN” no “UPN”.

Ag ùrachadh iuchraichean poblach le làimh
Gus an ADFS Server Token Soidhnigeadh òrdag fhaighinn

1. Bho fhrithealaiche ADFS, cuir air bhog consol ADFS 2.0 Management.
2. Tagh Seirbheis> Teisteanasan, agus cliog dùbailte air an teisteanas soidhnigeadh Token.
3. Tagh an taba Mion-fhiosrachadh.
4. Tagh an raon Thumbprint.
5. Gus an luach òrdag fhaighinn, thoir air falbh a h-uile àite a’ toirt a-steach a’ chiad àite.

Gus an ùraich thu an Web.config file

1. Deasaich an ADFS web.config. Is e an t-àite bunaiteach:
   EnterpriseRP-STS_ADFS
2. Fo na eileamaid, lorg an ida:FederationMetadataLocation iuchair agus soilleir a luach:
   
3. Fo , lorg an eileamaid agus cuir na leanas na àite: https://ADFS_Federation.ServiceName/adfs/services/trust" >https://ADFS_Federation.ServiceName/adfs/services/trust" />

A 'dèanamh deuchainn air ceangal COM API

1. Ruith an API Test Kit. Is e an t-àite bunaiteach:
   Components APIAPIApiTestKit.exe.
2. Cliog Ceangal String > Encrypter.
3. Anns an raon Teacsa Ceangal Teacs Plain:
   a. Cuir am fiosrachadh stòr-dàta agad an àite SERVERNAME agus DATABASENAME.
   b. Cuir fiosrachadh cunntas cleachdaiche rianadair an stòr-dàta agad an àite USERID agus PASSWORD.
   c. Cuir a-steach an luach ùine mar a dh’ fheumar.
4. Cliog air Encrypt.
5. Anns an raon sreang ceangail crioptaichte, dèan lethbhreac den teacsa.
6. Dùin am bogsa deasbaid.
7. Air clàr-taice API Test Kit, cliog Ceangal> COM API Connection Tester.
8. Anns an taba Tionndadh gnàthach, cuir a-steach an sreang ceangail crioptaichte a-steach don raon Ceangal String.
9. Anns na raointean LoginId agus Facal-faire, cuir a-steach an ID logaidh a-steach agus am facal-faire airson do chunntas Changepoint.
10. Anns an raon Loglevel (0-8), sònraich an ìre fiosrachaidh mearachd a thèid a thilleadh ann an log COM API file ma tha toradh an deuchainn a 'sealltainn duilgheadas leis a' cheangal.
    0 = Gun chlàradh
    1 = Bun nì agus modh
    2 = Teachdaireachd mearachd
    3 = Paramadairean cuir a-steach
    4 = Tilleadh
    5 = Rabhadh
    8 = puing-seic
    Is e 8 an roghainn bunaiteach.
11. Cliog Connect.
    Ma bha an ceangal soirbheachail, tha teachdaireachd soirbheachais ri fhaicinn ann an raon nan Toraidhean. Ma dh'fhàillig an ceangal, thoir sùil air log COM API file airson mhearachdan. Àite bunaiteach an loga file tha APIAPILlogs.

A’ sgrùdadh an tionndaidh de cho-phàirtean API stàlaichte
Faodaidh tu an goireas dearbhaidh dreach a chleachdadh gus mion-fhiosrachadh fhaighinn mu na pàirtean stàlaichte, a’ toirt a-steach an dreach fuasglaidh agus an t-slighe.

1. Ruith CPVersionChecker.exe. Is e an t-slighe bunaiteach: Co-phàirtean APIAPI
2. Cliog Leugh.

A' sgrùdadh an dreach den Web API seirbheisean

1. Cuir Internet Explorer air bhog bhon fhrithealaiche far a bheil an Web Tha seirbheisean API air a chuir a-steach, agus cuir a-steach an seòladh:
   http://localhost.port/CPWeb.Service/WSLogin.asmx  far a bheil am port àireamh port an weblàrach far an do chuir thu a-steach an CPWebLeabhar seirbheis mas-fhìor.
2. Air duilleag WSLogin, cliog air a’ cheangal GetVersion.
3. Cliog air Invoke.

A 'dèanamh deuchainn air an Web Ceangal API seirbheisean

1. Cuir Internet Explorer air bhog bhon fhrithealaiche far a bheil an Web Tha seirbheisean API air a chuir a-steach, agus cuir a-steach an seòladh: http://localhost.port/CPWeb.Service/WSLogin.asmx  far a bheil am port àireamh port an weblàrach far an do chuir thu a-steach an CPWebLeabhar seirbheis mas-fhìor.
2. Air duilleag WSLogin cliog air a’ cheangal TestConnection.
3. Cliog air Invoke. 4. Anns na toraidhean deuchainn:

• Ma tha tha an eileamaid ceàrr, shoirbhich leis a’ cheangal deuchainn.
• Ma tha tha an eileamaid fìor, dh'fhàillig an ceangal deuchainn. Airson barrachd
  fiosrachadh mu na h-adhbharan airson an fàilligeadh, faic an agus eileamaidean anns na toraidhean deuchainn, agus thoir sùil air na logaichean API. Is e an t-slighe bunaiteach gu logaichean API: APIAPILlogs

A 'suidheachadh an Web API seirbheisean air frithealaiche cànain

1. Gus an Changepoint a chleachdadh Web Seirbheisean API air frithealaiche cànain, feumaidh tu a chur ris no ùrachadh an tag Anns a’ Web API seirbheisean web.config. Àite bunaiteach an Web.config file tha: APICP Web SeirbheiseanWeb.config
2. Ma tha an tag mar-thà, dèan cinnteach gu bheil an dà chuid cultar agus buadhan uiCulture “en-US.”
3. Ma tha an tag nach eil ann mu thràth, cuir na leanas ris , beachd, agus eileamaidean dhanweb> nód:web>
   Roghainnean Visual Basic: Suidhich teann = ”fìor” gus a h-uile tionndadh seòrsa dàta a dhì-cheadachadh far am faod call dàta tachairt. Suidhich gu soilleir = “fìor” gus foillseachadh a h-uile caochladair a sparradh. ->
4. Ath-thòiseachadh IIS.