Jagorar Shigar API
Jagoran Magana
Canje-canje 2021

© 2021 Changepoint Canada ULC Duk haƙƙin mallaka. HAKKOKIN GWAMNATIN Amurka-Amfani, kwafi, ko bayyanawa ta Gwamnatin Amurka yana ƙarƙashin ƙuntatawa kamar yadda aka tsara a cikin yarjejeniyar lasisin Changepoint Canada ULC kuma kamar yadda aka tanadar a DFARS 227.7202-1(a) da 227.7202-3(a) (1995), DFARS 252.227-7013 (c) (1) (ii) (OCT 1988), FAR 12.212 (a) (1995), FAR 52.227-19, ko FAR 52.227-14 (ALT III), kamar yadda ya dace. Wannan samfurin ya ƙunshi bayanan sirri da sirrin kasuwanci na Changepoint Canada ULC. An haramta bayyanawa ba tare da izini a rubuce na farko na Changepoint Canada ULC ba. Amfani da wannan samfurin yana ƙarƙashin sharuɗɗa da sharuɗɗan Yarjejeniyar Lasisi na mai amfani tare da Changepoint Canada ULC. Mai lasisi ne kawai zai iya sake buga takaddun don amfani na ciki. Ba za a iya canza abun cikin wannan takarda ba, gyara ko canza shi ba tare da rubutaccen izinin Changepoint Canada ULC ba. Changepoint Canada ULC na iya canza abun ciki da aka ƙayyade a kowane lokaci, tare da ko ba tare da sanarwa ba.

Shigar da Changepoint API

Game da shigar API Changepoint
Ana samun API ɗin Changepoint azaman COM API, sabis na Gidauniyar Sadarwa ta Windows (WCF) kuma, don dacewa da baya, azaman Web Sabis na Haɓaka Ayyuka (WSE). Don bayani game da Changepoint API, duba Reference API Changepoint. Don haɓaka bayanin kula, faɗakarwa da sanannun batutuwa, duba Bayanan Sakin a cikin manyan fayilolin ƙungiyar a Changepoint.
Haɓaka API ɗin Changepoint
Idan kuna haɓakawa daga fitowar Canjin Canjin da ta gabata, yi amfani da Windows Control Panel don cire sigar da ta gabata ta Changepoint API da abubuwanta kafin shigar da wannan sigar.
Buƙatun API na Changepoint
Dole ne ku shigar da Changepoint kafin ku shigar da API Changepoint. Don buƙatun software, duba Matrix Compatibility Software Changepoint, wanda ke akwai a cikin 2021 Bayanan kula na Sakin da Faci na ƙungiyar a Changepoint.
File hanyoyin tarurruka
A cikin wannan takarda, ana amfani da waɗannan ƙa'idodi don hanyoyin gama gari:

• Tushen hanyar shigarwa Changepoint.
  Hanyar da ta dace ita ce:
  C: Shirin Files (x86) Canjin Canji
• Tushen wurin gama-gari na abubuwan amfani na Changepoint, kamar kayan aikin Saitunan Shiga.
  Hanyar da ta dace ita ce:
  C: Shirin Files (x86) Na kowa FilesChangepointChangepoint

Shigar da Changepoint API

1. Daga tushen tushen kafofin watsa labarai na Changepoint API, gudanar da saitin.exe.
2. Bi saƙon har sai allon Zaɓi Features ya bayyana.
3. Zaɓi abubuwan da kuke son sanyawa, sannan danna Next.
4. Zaɓi babban fayil ɗin manufa na API, tsoho API, kuma danna Next.
   Lura: An shigar da kayan aikin Saitunan Shiga Changepoint a ciki Saitunan shiga, ba tare da la'akari da babban fayil ɗin da kuka ƙayyade ba.
5. Idan kun zaɓi Web API ɗin sabis: a. Lokacin Zaɓi
   a Web Allon rukunin yanar gizon yana bayyana, zaɓi a website don ƙara kama-da-wane directory zuwa, sa'an nan kuma danna Next.
   b. Danna Gaba don ci gaba. 6. Lokacin da shigarwa na API ya cika, danna Gama.

Saita API ɗin Changepoint don zama sananne
Don saita Changepoint API don zama mai sani, maye gurbin dabi'u don "cache. Kalmar sirri" da "cache. Maɓallan Sabar” a cikin CP Web AyyukaWeb.config file tare da ƙimar da ake amfani da su a cikin KasuwancinWeb.config file.
Yin kunnawa Web Haɓaka Ayyuka (WSE)

1. Gyara da Web.config file domin web ayyuka. Tsohuwar wurin shine:
   APICP Web AyyukaWeb.config
2. Nemo misalai guda uku na layin sharhi mai zuwa:
   < !- Uncomment da wadannan kashi idan kana amfani Web API ɗin Haɓaka Sabis (WSE). Bar sharhi idan kuna amfani da sabis na WCF kuma ba a sakawa ba Web Haɓaka Sabis (WSE) ->
3. Ƙarfafa abin da ke biye da kowane misali na layin sharhi:
   <section name=”microsoft.web.sabis2″… >webAyyuka>web.sabis2>
   Lura: ThewebServices> abin da za a ba da amsa shi ne yaro naweb>.

Ana saita shiga don Web API ɗin sabis
Dole ne ku saita log ɗin file hanya da matakan log. Matakan log ɗin suna tarawa. Don misaliample, idan kun saka matakin 3, to matakan 1, 2, da 3 suna shiga. Matsayin tsohowar log ɗin shine 8.

1. Gyara da web ayyuka Web.config. Tsohuwar wurin shine:
   APICP Web AyyukaWeb.config
2. Saita LogFileHanya. Tsohuwar ƙimar ita ce APIAPIlogs. 3. Saita LogLevel. Ingantattun dabi'u sune:
   0 = Babu shiga
   1 = Tushen abu da hanya
   2 = Sakon kuskure
   3 = Matsalolin shigarwa
   4 = Komawa
   5 = Gargadi
   8 = Dubawa

Ana saita ingantaccen kundin adireshi don Web API ɗin sabis
Dole ne ku kunna damar da ba a san suna ba kuma ku kashe Integrated Windows Tantance kalmar sirri don CPWebLittafin jagorar sabis a cikin Sabis na Bayanan Intanet (IIS). Don ƙarin bayani, duba takaddun Microsoft IIS.
Ana saita saitunan haɗin bayanai don Web API ɗin sabis
Yi amfani da mai amfani Saitunan Shiga don ɓoye saitunan haɗin bayanai a cikin Web API ɗin sabis Web.config file. Don ƙarin bayani, bincika "Saitunan Saitunan Haɗin Bayanan Bayanai" a cikin Jagoran Shigar Canji.
Ana saita tabbaci don Changepoint WCF Web Ayyuka
Kuna iya saita Tabbatar da Aikace-aikacen da sa hannu guda ɗaya (SSO) don Changepoint WCF Web Ayyuka.
Akwai zaɓuɓɓukan aiwatarwa masu zuwa ta amfani da Secure Token Service (STS):

• SSO ta amfani da ISAPI SSL na zaɓi
• SSO ta amfani da WS-Tarayyar (ADFS 2.0) SSL da ake buƙata

Idan ana buƙatar SSL, rubutun sanyi yana tabbatar da cewa an yi amfani da shi.
Rubutun daidaitawa don ISAPI da amincin aikace-aikacen na iya ba da damar SSL da zaɓi.
Ana saita amincin aikace-aikacen don WCF Web Ayyuka
Nau'in tantancewar tsoho don Changepoint WCF Web Sabis shine amincin aikace-aikacen.
Yi amfani da hanyoyin da ke cikin wannan sashe don:

• saita Changepoint WCF Web Sabis don amfani da ingantaccen aiki tare da SSL
• Maida Changepoint WCF Web Sabis don tabbatar da aikace-aikacen bayan aiwatar da ɗayan aiwatar da SSO

Sanya PowerShell

1. Bude faɗakarwar Windows PowerShell.
2. Gyara manufofin aiwatarwa:
   Saita-ExecutionManufofin Ƙaddamarwa

Stage 1 Tattara sigogin sanyi
Ƙayyade ƙididdiga don sigogin daidaitawa.

Siga	Bayani
WebTafarki_Sabis	Wurin Canja wurin WCF Web Ayyuka web aikace-aikace files. Na baya: API \ CP Web Ayyuka
Takaddar Sabis_ Suna	Sunan takaddun shaida wanda za a yi amfani da shi don tabbatar da sabis ga abokan ciniki ta amfani da yanayin tsaro na saƙo. Default: "CN=ChangepointAPICertificate" Sunan Takaddun shaida.
bukatar HTTPS	Ana buƙatar HTTPS (Gaskiya/Ƙarya) Default: Karya.

Stage 2 aiwatar da rubutun sanyi
Yi amfani da ma'auni don sigogin daidaitawa don gyara tsarin saitin webshafuka.

1.  Bude faɗakarwar PowerShell.
   Lura: Idan uwar garken naka yana da ikon sarrafa Asusun Mai amfani, dole ne ka buɗe faɗakarwar PowerShell ta amfani da izini mai ɗaukaka.
2. Kewaya zuwa CP web Kundin tsarin tsarin sabis, tsoho:
   Kanfigareshan CPWebSabis
3.  Yi ./Configuration_AppAuth.ps1
4. Bi tsokaci.

Yana daidaita sa hannu guda ɗaya (SSO) don WCF Web Ayyuka
Sanya PowerShell

1. Bude faɗakarwar Windows PowerShell.
2. Gyara manufofin aiwatarwa:
   Saita-ExecutionManufofin Ƙaddamarwa

Saita SSO ta amfani da ISAPI don WCF Web Ayyuka
Stage 1 Tattara sigogin sanyi
Ƙayyade ƙima don sigogin daidaitawa masu zuwa.

Siga	Bayani
WebTafarki_Sabis	Wurin Canja wurin WCF Web Ayyuka web aikace-aikace files. Na baya: API \ CP Web Ayyuka
bukatar HTTPS	Ana buƙatar HTTPS (Gaskiya/Ƙarya). Default: Karya.
Canza wurin_RSA_ Kuki_Canza	Sunan takardar shedar da kuke amfani da ita don boye-boye Kuki. Default: "CN=ChangepointAPICertificate" Sunan Takaddun shaida.
Certificate_Sunan Sabis	Shigar da sunan takardar shaidar da za a yi amfani da shi don tabbatar da sabis ga abokan ciniki ta amfani da yanayin tsaro na saƙo. Default: "CN=ChangepointAPICertificate" Sunan Takaddun shaida.
Sa hannu Certificate_Sunan	Shigar da sunan takardar shaidar sa hannu. Wannan shine sunan takardar shaidar da kuke amfani da ita don sanya hannu kan saƙonni. Default: "CN=ChangepointAPICertificate" Sunan Takaddun shaida.
ISAPI_Mode	Yanayin ISAPI. Tsohuwar: NT
ISAPI_header	Kan kai da ake amfani dashi lokacin ISAPI_Mode shine "HEADER", misaliampku, babu.
ClaimType	Shigar da Nau'in Da'awar SSO. Na baya: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn

Stage 2 aiwatar da rubutun sanyi

1. Bude faɗakarwar PowerShell.
   Lura: Idan uwar garken naka yana da ikon sarrafa Asusun Mai amfani, dole ne ka buɗe faɗakarwar PowerShell ta amfani da izini mai ɗaukaka.
2. Kewaya zuwa CP web Kundin tsarin tsarin sabis, tsoho:
   Kanfigareshan CPWebSabis
3. Yi: ./Configuration_SSO_ISAPI.ps1
4. Bi tsokaci.

Saita SSO ta amfani da WS-Federation (ADFS 2.0) don WCF Web Ayyuka
Stage 1 Tattara sigogin sanyi
Ƙayyade ƙimar ma'aunin daidaitawa a cikin tebur, ƙasa. Tabbatar cewa ADFS_Server_URI yana cikin yankin Intanet na mai binciken mai amfani.
Lura: Ta hanyar tsoho, ana saita Changepoint don sabunta maɓallan jama'a ta atomatik waɗanda ake amfani da su don sanya hannu kan alamun tsaro ta amfani da daftarin metadata na tarayya da aka buga. A cikin ADFS wannan shine:
https://ADFS_Federation.ServiceName/FederationMetadata/2007-06/FederationMetadata.xml
A wasu lokuta ƙila ba zai yiwu a isa uwar garken ADFS daga wurin Canji ba web uwar garken don haka dole ne ka sabunta tsarin da hannu bayan gudanar da rubutun sanyi. Don cikakkun bayanai, duba "Maɓallai na jama'a da hannu" a shafi na 12.

Siga	Bayani
WebTafarki_Sabis	Wurin Canja wurin WCF Web Ayyuka web aikace-aikace files. Na baya: API \ CP Web Ayyuka
WebSabis_URI	Mai gano yanki wanda kuke amfani da shi don Changepoint WCF Web Ayyuka. Don misaliample., ba https://changepointapi.abc.corp/CPWebService
Canza wurin_RSA_ Kuki_Canza	Sunan takardar shedar da kuke amfani da ita don ɓoyayyen kuki. Default: "CN=ChangepointApiCertificate" Sunan Takaddun shaida.
Certificate_Sunan Sabis	Sunan takaddun shaida wanda za a yi amfani da shi don tabbatar da sabis ga abokan ciniki ta amfani da yanayin tsaro na saƙo. Default: "CN=ChangepointApiCertificate" Sunan Takaddun shaida.
Sa hannu Certificate_Sunan	Sunan takardar shaidar da kuke amfani da ita don sanya hannu kan saƙonni. Tsohuwar: “CN=ChangepointApiCertificate” ana amfani da Sunan Takaddun shaida.
ADFS_ Sunan Sabis na Tarayya	Sunan Sabis na Tarayya. Don samun sunan: Daga uwar garken ADFS, Ƙaddamar da ADFS 2.0 Gudanarwa console. Zaɓi ADFS 2.0 daga menu na hagu. • Daga cikin Ayyukan Aiki zaɓi Shirya Abubuwan Sabis na Tarayya. Sunan Sabis na Tarayya yana kan Gaba ɗaya shafin.
ClaimType	Nau'in Da'awar SSO. Tsohuwar ita ce: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn

Stage 2 aiwatar da rubutun sanyi
Sanya webshafukan yanar gizo masu amfani da ƙididdiga don sigogin daidaitawa.

1. Bude faɗakarwar PowerShell.
   Lura: Idan uwar garken naka yana da ikon sarrafa Asusun Mai amfani, dole ne ka buɗe faɗakarwar PowerShell ta amfani da izini mai ɗaukaka.
2. Kewaya zuwa wurin Canji web Kundin tsarin tsarin sabis, tsoho: Kanfigareshan CPWebSabis
3.  Yi: ./Configuration_SSO_ADFS.ps1
4. Bi tsokaci.

Stage 3 Ƙirƙirar amincewar jam'iyya
Ƙirƙiri Amintacciyar Jam'iyyar Dogara a cikin ADFS 2.0 Console.

1. A kan uwar garken ADFS ɗin ku, ƙaddamar da ADFS 2.0 console.
2. Zaɓi Aiki > Ƙara Dogaran Jam'iyya.
3. Danna Fara.
4. Zaɓi Shigo bayanai game da ƙungiyar dogara da aka buga akan layi ko akan hanyar sadarwar gida.
5. Shigar da adireshin metadata na Federation, sannan danna Next, don misaliampda:
   https://changepointapi.abc.corp/cpwebservice/federationmetadata/2007-06/federationmetadata.xml
6. Shigar da sunan nuni, misali Changepoint WCF API, kuma danna Gaba, Gaba, Gaba, sannan Rufe.
7. Ƙara Dokar Da'awa don Jam'iyyar Dogaro da Canji na sama. Don Changepoint, tsohuwar sunan ƙa'idar da'awar shine "UPN".
8. Taswirar sifa ta LDAP "Masu amfani-Babban Suna" zuwa Nau'in Da'awar Mai fita "* UPN" ko "UPN".

Ana sabunta maɓallan jama'a da hannu
Don samun Alamar Sabar Sabar ADFS

1. Daga uwar garken ADFS, Ƙaddamar da ADFS 2.0 Gudanarwa console.
2. Zaɓi Sabis > Takaddun shaida, kuma danna takardar shaidar sa hannu sau biyu.
3. Zaɓi shafin Cikakkun bayanai.
4. Zaɓi filin babban yatsan hannu.
5. Don samun ƙimar babban yatsan yatsa, cire duk sarari gami da sarari na farko.

Don sabunta Web.config file

1. Shirya ADFS web.config. Tsohuwar wurin shine:
   EnterpriseRP-STS_ADFS
2. Karkashin kashi, nemo ida:FederationMetadataLocation key kuma share ƙimarsa:
   
3. Karkashin , samin element kuma musanya shi da mai zuwa: https://ADFS_Federation.ServiceName/adfs/services/trust" >https://ADFS_Federation.ServiceName/adfs/services/trust" />

Gwada haɗin COM API

1. Gudanar da Kit ɗin Gwajin API. Tsohuwar wurin shine:
   APIAPI ComponentsApiTestKit.exe.
2. Danna Connection String > Encrypter.
3. A cikin Filin Haɗin Rubutun Filaye:
   a. Sauya SERVERNAME da DATABASENAME tare da bayanan bayananku.
   b. Sauya USERID da PASSWORD tare da bayanan asusun mai amfani na mai sarrafa bayanan ku.
   c. Shigar da ƙimar ƙarewar lokacin da ake buƙata.
4. Danna Encrypt.
5. A cikin filin Haɗin Rufewa, kwafi rubutun.
6. Rufe akwatin maganganu.
7. A menu na Kit ɗin Gwajin API, danna Haɗi> COM Mai Haɗin Haɗin API.
8. A cikin Shafin Shafin Yanzu, liƙa rufaffen haɗin haɗin kai cikin filin Haɗin Haɗin.
9. A cikin LoginId da Password filayen, shigar da ID na shiga da kalmar sirri don asusun ku na Changepoint.
10. A cikin filin Loglevel (0-8), ƙayyade matakin bayanin kuskuren da za a dawo da shi a cikin COM API log. file idan sakamakon gwajin ya nuna matsala tare da haɗin.
    0 = Babu shiga
    1 = Tushen abu da hanya
    2 = Sakon kuskure
    3 = Matsalolin shigarwa
    4 = Komawa
    5 = Gargadi
    8 = Dubawa
    Tsoho shine 8.
11. Danna Haɗa.
    Idan haɗin ya yi nasara, ana nuna saƙon nasara a cikin filin sakamako. Idan haɗin ya gaza, duba COM API log file don kurakurai. Wurin tsoho na log ɗin file shine APIAPIlogs.

Duba sigar abubuwan abubuwan API da aka shigar
Kuna iya amfani da kayan aikin duba sigar don samun cikakkun bayanai game da abubuwan da aka shigar, gami da sigar saki da hanya.

1. Shigar da CPVersionChecker.exe. Hanyar da ta dace ita ce: Abubuwan APIAPI
2. Danna Karanta.

Duba sigar ta Web API ɗin sabis

1. Kaddamar da Internet Explorer daga uwar garken inda aka shigar Web API ɗin sabis ɗin an shigar, kuma shigar da adireshin:
   http://localhost.port/CPWeb.Service/WSLogin.asmx  inda tashar jiragen ruwa ne lambar tashar jiragen ruwa na webwurin da ka shigar da CPWebLittafin jagorar sabis.
2. A shafin WSLogin, danna mahaɗin GetVersion.
3. Danna Kira.

Gwajin da Web Haɗin API na ayyuka

1. Kaddamar da Internet Explorer daga uwar garken inda aka shigar Web API ɗin sabis ɗin an shigar, kuma shigar da adireshin: http://localhost.port/CPWeb.Service/WSLogin.asmx  inda tashar jiragen ruwa ne lambar tashar jiragen ruwa na webwurin da ka shigar da CPWebLittafin jagorar sabis.
2. A shafin WSLogin danna mahaɗin TestConnection.
3. Danna Kira. 4. A cikin sakamakon gwajin:

• Idan kashi karya ne, haɗin gwajin yayi nasara.
• Idan kashi gaskiya ne, haɗin gwajin ya kasa. Don ƙarin
  bayani kan dalilan gazawar, duba kuma abubuwan da ke cikin sakamakon gwajin, kuma duba rajistan ayyukan API. Tsohuwar hanyar zuwa rajistan ayyukan API ita ce: APIAPIlogs

Saitin da Web API ɗin sabis akan uwar garken harshe

1. Don ƙaddamar da Changepoint Web API ɗin sabis akan uwar garken harshe, dole ne ka ƙara ko sabunta shi tag a cikin Web API ɗin sabis web.config. Wurin tsoho na Web.config file shine: APICP Web AyyukaWeb.config
2. Idan da tag sun riga sun wanzu, tabbatar da cewa duka al'adu da halayen uiCulture sune "en-US."
3. Idan da tag ba ya wanzu, ƙara da wadannan , sharhi, da kuma abubuwa zuwa gaweb> node:web>
   Zaɓuɓɓukan Kayayyakin Kayayyakin Kayayyakin Kayayyaki: Saita tsattsauran = "gaskiya" don hana duk canjin nau'in bayanai inda asarar bayanai za ta iya faruwa. Saita bayyane =”gaskiya” don tilasta ayyana duk masu canji. –>
4. Sake kunna IIS.

Takardu / Albarkatu

Changepoint API Software [pdf] Jagoran Shigarwa API, Software, API Software

Magana

• Manual mai amfani