ຄູ່ມືການຕິດຕັ້ງ 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 ອາດ​ຈະ​ປ່ຽນ​ເນື້ອ​ໃນ​ທີ່​ລະ​ບຸ​ໄວ້​ໃນ​ທີ່​ນີ້​ໄດ້​ທຸກ​ເວ​ລາ​, ມີ​ຫຼື​ບໍ່​ມີ​ການ​ແຈ້ງ​ການ​.

ເນື້ອໃນ ເຊື່ອງ
1 ການຕິດຕັ້ງ Changepoint API
2 ການທົດສອບການເຊື່ອມຕໍ່ COM API
3 ການ​ທົດ​ສອບ​ Web ການເຊື່ອມຕໍ່ການບໍລິການ API
4 ເອກະສານ / ຊັບພະຍາກອນ
4.1 ເອກະສານອ້າງອີງ
5 ກະທູ້ທີ່ກ່ຽວຂ້ອງ

ການຕິດຕັ້ງ 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 ລຸ້ນກ່ອນ, ໃຫ້ໃຊ້ແຜງຄວບຄຸມ Windows ເພື່ອຖອນການຕິດຕັ້ງ API ຂອງ Changepoint ເວີຊັນກ່ອນໜ້ານີ້ ແລະອົງປະກອບຂອງມັນກ່ອນທີ່ຈະຕິດຕັ້ງເວີຊັນນີ້.
ຄວາມຕ້ອງການ Changepoint API
ທ່ານຕ້ອງຕິດຕັ້ງ Changepoint ກ່ອນທີ່ທ່ານຈະຕິດຕັ້ງ Changepoint API. ສໍາລັບຄວາມຕ້ອງການຂອງຊອບແວ, ເບິ່ງ Changepoint Software Compatibility Matrix, ເຊິ່ງມີຢູ່ໃນໂຟນເດີຂອງ Release Notes ແລະ Patches team 2021 ໃນ ​​Changepoint.
File ສົນທິສັນຍາເສັ້ນທາງ
ຕະຫຼອດເອກະສານສະບັບນີ້, ສົນທິສັນຍາຕໍ່ໄປນີ້ແມ່ນໃຊ້ສໍາລັບເສັ້ນທາງທົ່ວໄປ:

  • ເສັ້ນທາງຮາກຂອງການຕິດຕັ້ງ Changepoint.
    ເສັ້ນທາງເລີ່ມຕົ້ນແມ່ນ:
    C​: ໂຄງ​ການ​ Files (x86)ຈຸດປ່ຽນຈຸດປ່ຽນ
  • ສະຖານທີ່ຮາກສໍາລັບຜົນປະໂຫຍດທົ່ວໄປຂອງ Changepoint, ເຊັ່ນ: ຜົນປະໂຫຍດການຕັ້ງຄ່າການເຂົ້າສູ່ລະບົບ.
    ເສັ້ນທາງເລີ່ມຕົ້ນແມ່ນ:
    C​: ໂຄງ​ການ​ Files (x86) ທົ່ວໄປ FilesChangepointChangepoint

ການຕິດຕັ້ງ Changepoint API

  1. ຈາກໄດເລກະທໍລີຮາກສື່ Changepoint API, ດໍາເນີນການ setup.exe.
  2. ປະຕິບັດຕາມການເຕືອນຈົນກ່ວາຫນ້າຈໍ Select Features ປະກົດຂຶ້ນ.
  3. ເລືອກຄຸນສົມບັດທີ່ທ່ານຕ້ອງການທີ່ຈະຕິດຕັ້ງ, ຫຼັງຈາກນັ້ນໃຫ້ຄລິກໃສ່ຕໍ່ໄປ.
  4. ເລືອກໂຟເດີປາຍທາງ API, ຄ່າເລີ່ມຕົ້ນ API, ແລະຄລິກ Next.
    ໝາຍເຫດ: ຜົນປະໂຫຍດການຕັ້ງຄ່າການເຂົ້າສູ່ລະບົບ Changepoint ໄດ້ຖືກຕິດຕັ້ງຢູ່ໃນ ການຕັ້ງຄ່າການເຂົ້າສູ່ລະບົບ, ໂດຍບໍ່ຄໍານຶງເຖິງໂຟນເດີປາຍທາງທີ່ທ່ານລະບຸ.
  5. ຖ້າທ່ານເລືອກ Web API ການບໍລິການ: ກ. ເມື່ອເລືອກ
    a Web ໜ້າຈໍເວັບໄຊປະກົດຂຶ້ນ, ເລືອກ a webເວັບ​ໄຊ​ທີ່​ຈະ​ເພີ່ມ​ລະ​ບົບ virtual ກັບ, ແລະ​ຫຼັງ​ຈາກ​ນັ້ນ​ໃຫ້​ຄລິກ​ໃສ່ Next.
    ຂ. ຄລິກຕໍ່ໄປເພື່ອສືບຕໍ່. 6. ເມື່ອການຕິດຕັ້ງ API ສໍາເລັດແລ້ວ, ຄລິກ Finish.

ການຕັ້ງຄ່າ Changepoint API ທີ່ຈະຮູ້ cache
ເພື່ອກໍາຫນົດຄ່າ Changepoint API ໃຫ້ເປັນ cache-aware, ທົດແທນຄ່າສໍາລັບ "cache. ລະຫັດຜ່ານ” ແລະ “cache. ເຊີບເວີ” ຄີໃນ 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.ການບໍລິການ2″… >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 = ດ່ານ

ການຕັ້ງຄ່າການພິສູດຢືນຢັນໄດເລກະທໍລີ virtual ສໍາລັບ Web API ການບໍລິການ
ທ່ານ​ຕ້ອງ​ເປີດ​ໃຊ້​ງານ​ການ​ເຂົ້າ​ເຖິງ​ບໍ່​ລະ​ບຸ​ຊື່​ແລະ​ປິດ​ການ​ທໍາ​ງານ​ການ​ເຊື່ອມ​ໂຍງ Windows authentication ສໍາ​ລັບ CP ໄດ້​Webບໍລິການໄດເລກະທໍລີ virtual ໃນບໍລິການຂໍ້ມູນອິນເຕີເນັດ (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, script ການຕັ້ງຄ່າໃຫ້ແນ່ໃຈວ່າມັນຖືກນໍາໃຊ້.
ສະຄຣິບການຕັ້ງຄ່າສໍາລັບ 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ບໍລິການ_ເສັ້ນທາງ ທີ່ຕັ້ງຂອງ Changepoint WCF Web ການບໍລິການ web ຄໍາຮ້ອງສະຫມັກ files.
ຄ່າເລີ່ມຕົ້ນ: \API\CP Web ການບໍລິການ
ໃບຢັ້ງຢືນການບໍລິການ_
ຊື່		 ຊື່ໃບຢັ້ງຢືນທີ່ຈະໃຊ້ເພື່ອພິສູດຢືນຢັນການບໍລິການໃຫ້ກັບລູກຄ້າໂດຍໃຊ້ໂໝດຄວາມປອດໄພຂອງຂໍ້ຄວາມ.
ຄ່າເລີ່ມຕົ້ນ: ຊື່ໃບຢັ້ງຢືນ “CN=ChangepointAPICertificate”.
ຕ້ອງການ HTTPS ຕ້ອງການ HTTPS (ຖືກ/ຜິດ)
ຄ່າເລີ່ມຕົ້ນ: ບໍ່ຖືກຕ້ອງ.

Stage 2 ປະຕິບັດສະຄຣິບການຕັ້ງຄ່າ
ໃຊ້ຄ່າສໍາລັບພາລາມິເຕີການຕັ້ງຄ່າເພື່ອແກ້ໄຂການຕັ້ງຄ່າຂອງ webສະຖານທີ່.

  1.  ເປີດການເຕືອນ PowerShell.
    ໝາຍເຫດ: ຖ້າເຊີບເວີຂອງທ່ານເປີດໃຊ້ການຄວບຄຸມບັນຊີຜູ້ໃຊ້, ທ່ານຕ້ອງເປີດການເຕືອນ PowerShell ໂດຍໃຊ້ສິດຜູ້ເບິ່ງແຍງລະບົບທີ່ສູງ.
  2. ທ່ອງໄປຫາ CP web ໄດເລກະທໍລີການຕັ້ງຄ່າບໍລິການ, ຄ່າເລີ່ມຕົ້ນ:
    ConfigurationCPWebການບໍລິການ
  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 (ຖືກ/ຜິດ).
ຄ່າເລີ່ມຕົ້ນ: ບໍ່ຖືກຕ້ອງ.
Changepoint_RSA_
Cookie_Transform		 ຊື່ຂອງໃບຢັ້ງຢືນທີ່ທ່ານໃຊ້ສໍາລັບການເຂົ້າລະຫັດຄຸກກີ.
ຄ່າເລີ່ມຕົ້ນ: ຊື່ໃບຢັ້ງຢືນ “CN=ChangepointAPICertificate”.
ServiceCertificate_Name ໃສ່ຊື່ໃບຢັ້ງຢືນທີ່ຈະໃຊ້ເພື່ອພິສູດຢືນຢັນການບໍລິການໃຫ້ກັບລູກຄ້າໂດຍໃຊ້ໂໝດຄວາມປອດໄພຂອງຂໍ້ຄວາມ.
ຄ່າເລີ່ມຕົ້ນ: ຊື່ໃບຢັ້ງຢືນ “CN=ChangepointAPICertificate”.
SigningCertificate_Name ໃສ່ຊື່ໃບຢັ້ງຢືນການລົງນາມ. ນີ້ແມ່ນຊື່ຂອງໃບຢັ້ງຢືນທີ່ທ່ານໃຊ້ສໍາລັບການເຊັນຂໍ້ຄວາມ.
ຄ່າເລີ່ມຕົ້ນ: ຊື່ໃບຢັ້ງຢືນ “CN=ChangepointAPICertificate”.
ISAPI_Mode ໂໝດ ISAPI.
ຄ່າເລີ່ມຕົ້ນ: NT
ISAPI_Header ສ່ວນຫົວທີ່ໃຊ້ເມື່ອ ISAPI_Mode ແມ່ນ “HEADER”, ຕົວຢ່າງເຊັ່ນample, ຫວ່າງເປົ່າ.
ປະເພດການຮຽກຮ້ອງ ໃສ່ປະເພດການຮຽກຮ້ອງ SSO.
ຄ່າເລີ່ມຕົ້ນ: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn

Stage 2 ປະຕິບັດສະຄຣິບການຕັ້ງຄ່າ

  1. ເປີດການເຕືອນ PowerShell.
    ໝາຍເຫດ: ຖ້າເຊີບເວີຂອງທ່ານເປີດໃຊ້ການຄວບຄຸມບັນຊີຜູ້ໃຊ້, ທ່ານຕ້ອງເປີດການເຕືອນ PowerShell ໂດຍໃຊ້ສິດຜູ້ເບິ່ງແຍງລະບົບທີ່ສູງ.
  2. ທ່ອງໄປຫາ CP web ໄດເລກະທໍລີການຕັ້ງຄ່າບໍລິການ, ຄ່າເລີ່ມຕົ້ນ:
    ConfigurationCPWebການບໍລິການ
  3. ປະຕິບັດ: ./Configuration_SSO_ISAPI.ps1
  4. ປະຕິບັດຕາມການເຕືອນ.

ການຕັ້ງຄ່າ SSO ໂດຍໃຊ້ WS-Federation (ADFS 2.0) ສໍາລັບ WCF Web ການບໍລິການ
Stage 1 ລວບລວມພາລາມິເຕີການຕັ້ງຄ່າ
ກໍານົດຄ່າສໍາລັບພາລາມິເຕີການຕັ້ງຄ່າໃນຕາຕະລາງ, ຂ້າງລຸ່ມນີ້. ໃຫ້ແນ່ໃຈວ່າ ADFS_Server_URI ຢູ່ໃນເຂດ Intranet ຂອງຕົວທ່ອງເວັບຂອງຜູ້ໃຊ້ສຸດທ້າຍ.
ໝາຍເຫດ: ໂດຍຄ່າເລີ່ມຕົ້ນ, Changepoint ໄດ້ຖືກຕັ້ງຄ່າເພື່ອອັບເດດກະແຈສາທາລະນະອັດຕະໂນມັດທີ່ຖືກນໍາໃຊ້ເພື່ອເຊັນໂທເຄັນຄວາມປອດໄພໂດຍໃຊ້ເອກະສານ metadata ຂອງສະຫະພັນທີ່ເຜີຍແຜ່. ໃນ ADFS ນີ້ແມ່ນ:
https://ADFS_Federation.ServiceName/FederationMetadata/2007-06/FederationMetadata.xml
ໃນບາງກໍລະນີມັນອາດຈະບໍ່ສາມາດບັນລຸເຄື່ອງແມ່ຂ່າຍ ADFS ຈາກ Changepoint web server ດັ່ງນັ້ນທ່ານຈະຕ້ອງປັບປຸງການຕັ້ງຄ່າດ້ວຍຕົນເອງຫຼັງຈາກແລ່ນສະຄຣິບການຕັ້ງຄ່າ. ສໍາລັບລາຍລະອຽດ, ເບິ່ງ “ການອັບເດດກະແຈສາທາລະນະດ້ວຍຕົນເອງ” ຢູ່ໜ້າ 12.

ພາລາມິເຕີ ລາຍລະອຽດ
Webບໍລິການ_ເສັ້ນທາງ ທີ່ຕັ້ງຂອງ Changepoint WCF Web ການບໍລິການ web ຄໍາຮ້ອງສະຫມັກ fileດ. ຄ່າເລີ່ມຕົ້ນ: \API\CP Web ການບໍລິການ
Webບໍລິການ_URI ຕົວລະບຸໂດເມນທີ່ທ່ານໃຊ້ສໍາລັບ Changepoint WCF Web ການບໍລິການ. ຕົວຢ່າງampເລ., https://changepointapi.abc.corp/CPWebService
Changepoint_RSA_ Cookie_Transform ຊື່ຂອງໃບຢັ້ງຢືນທີ່ທ່ານໃຊ້ສໍາລັບການເຂົ້າລະຫັດຄຸກກີ. ຄ່າເລີ່ມຕົ້ນ: ຊື່ໃບຢັ້ງຢືນ “CN=ChangepointApiCertificate”.
ServiceCertificate_Name ຊື່ໃບຢັ້ງຢືນທີ່ຈະໃຊ້ເພື່ອພິສູດຢືນຢັນການບໍລິການໃຫ້ກັບລູກຄ້າໂດຍໃຊ້ໂໝດຄວາມປອດໄພຂອງຂໍ້ຄວາມ.
ຄ່າເລີ່ມຕົ້ນ: ຊື່ໃບຢັ້ງຢືນ “CN=ChangepointApiCertificate”.
SigningCertificate_Name ຊື່ຂອງໃບຢັ້ງຢືນທີ່ທ່ານໃຊ້ສໍາລັບການເຊັນຂໍ້ຄວາມ.
ຄ່າເລີ່ມຕົ້ນ: ຊື່ໃບຢັ້ງຢືນ “CN=ChangepointApiCertificate” ຖືກໃຊ້.
ADFS_ ຊື່ການບໍລິການສະຫະພັນ ຊື່ການບໍລິການສະຫະພັນ. ເພື່ອເອົາຊື່: ຈາກເຊີບເວີ ADFS, ເປີດ ADFS 2.0 Management console.
•ເລືອກ ADFS 2.0 ຈາກເມນູດ້ານຊ້າຍ.
•ຈາກແຖບປະຕິບັດງານເລືອກແກ້ໄຂຄຸນສົມບັດການບໍລິການສະຫະພັນ.
ຊື່ການບໍລິການສະຫະພັນຢູ່ໃນແຖບທົ່ວໄປ.
ປະເພດການຮຽກຮ້ອງ ປະເພດການຮຽກຮ້ອງ SSO. ຄ່າເລີ່ມຕົ້ນແມ່ນ: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn

Stage 2 ປະຕິບັດສະຄຣິບການຕັ້ງຄ່າ
ຕັ້ງຄ່າ webເວັບໄຊທ໌ທີ່ໃຊ້ຄ່າສໍາລັບພາລາມິເຕີການຕັ້ງຄ່າ.

  1. ເປີດການເຕືອນ PowerShell.
    ໝາຍເຫດ: ຖ້າເຊີບເວີຂອງທ່ານເປີດໃຊ້ການຄວບຄຸມບັນຊີຜູ້ໃຊ້, ທ່ານຕ້ອງເປີດການເຕືອນ PowerShell ໂດຍໃຊ້ສິດຜູ້ເບິ່ງແຍງລະບົບທີ່ສູງ.
  2. ທ່ອງໄປຫາຈຸດປ່ຽນ web ໄດເລກະທໍລີການຕັ້ງຄ່າບໍລິການ, ຄ່າເລີ່ມຕົ້ນ: ConfigurationCPWebການບໍລິການ
  3.  ປະຕິບັດ: ./Configuration_SSO_ADFS.ps1
  4. ປະຕິບັດຕາມການເຕືອນ.

Stage 3 ສ້າງຄວາມເຊື່ອໝັ້ນຂອງພັກ
ສ້າງ Relying Party Trust ໃນ ADFS 2.0 Console.

  1. ໃນເຊີບເວີ ADFS ຂອງທ່ານ, ເປີດ ADFS 2.0 console.
  2. ເລືອກການກະທຳ > ເພີ່ມຄວາມໄວ້ເນື້ອເຊື່ອໃຈຂອງພັກ.
  3. ກົດເລີ່ມຕົ້ນ.
  4. ເລືອກ​ເອົາ​ຂໍ້​ມູນ​ກ່ຽວ​ກັບ​ພາກ​ສ່ວນ​ທີ່​ອີງ​ໃສ່​ການ​ເຜີຍ​ແຜ່​ອອນ​ໄລ​ນ​໌​ຫຼື​ໃນ​ເຄືອ​ຂ່າຍ​ທ້ອງ​ຖິ່ນ​.
  5. ໃສ່ທີ່ຢູ່ metadata ຂອງສະຫະພັນ, ແລະຫຼັງຈາກນັ້ນໃຫ້ຄລິກໃສ່ Next, for example:
    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 Management console.
  2. ເລືອກການບໍລິການ > ໃບຢັ້ງຢືນ, ແລະຄລິກສອງຄັ້ງໃສ່ໃບຢັ້ງຢືນການເຊັນໂທເຄັນ.
  3. ເລືອກແຖບລາຍລະອຽດ.
  4. ເລືອກພາກສະຫນາມ Thumbprint.
  5. ເພື່ອໃຫ້ໄດ້ຄ່າຮູບໂປ້, ເອົາຊ່ອງຫວ່າງທັງໝົດອອກ ລວມທັງຊ່ອງຫວ່າງທຳອິດ.

ເພື່ອປັບປຸງ Web.config file

  1. ແກ້ໄຂ ADFS web.config. ສະຖານທີ່ເລີ່ມຕົ້ນແມ່ນ:
    EnterpriseRP-STS_ADFS
  2. ພາຍ​ໃຕ້​ການ ອົງປະກອບ, ຊອກຫາລະຫັດ ida:FederationMetadataLocation ແລະລຶບມູນຄ່າຂອງມັນ:
  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. ໃນຊ່ອງ String ການເຊື່ອມຕໍ່ຂໍ້ຄວາມທຳມະດາ:
    ກ. ແທນທີ່ SERVERNAME ແລະ DATABASENAME ດ້ວຍຂໍ້ມູນຖານຂໍ້ມູນຂອງທ່ານ.
    ຂ. ປ່ຽນແທນ USERID ແລະ PASSWORD ດ້ວຍຂໍ້ມູນບັນຊີຜູ້ໃຊ້ຂອງຖານຂໍ້ມູນຂອງທ່ານ.
    ຄ. ໃສ່ຄ່າ timeout ຕາມຄວາມຕ້ອງການ.
  4. ກົດເຂົ້າລະຫັດ.
  5. ໃນຊ່ອງ String ເຊື່ອມຕໍ່ເຂົ້າລະຫັດ, ສຳເນົາຂໍ້ຄວາມ.
  6. ປິດກ່ອງໂຕ້ຕອບ.
  7. ໃນເມນູ API Test Kit, ຄລິກ Connection > COM API Connection Tester.
  8. ໃນແຖບເວີຊັນປັດຈຸບັນ, ວາງສາຍການເຊື່ອມຕໍ່ທີ່ເຂົ້າລະຫັດໄວ້ໃສ່ຊ່ອງເຊື່ອມຕໍ່ String.
  9. ໃນ LoginId ແລະລະຫັດຜ່ານຊ່ອງ, ໃສ່ ID ເຂົ້າສູ່ລະບົບແລະລະຫັດຜ່ານສໍາລັບບັນຊີ Changepoint ຂອງທ່ານ.
  10. ໃນ Loglevel (0-8) ພາກສະຫນາມ, ລະບຸລະດັບຂອງຂໍ້ມູນຄວາມຜິດພາດທີ່ຈະສົ່ງຄືນໃນບັນທຶກ COM API. file ຖ້າຜົນການທົດສອບສະແດງໃຫ້ເຫັນບັນຫາກັບການເຊື່ອມຕໍ່.
    0 = ບໍ່ມີການບັນທຶກ
    1 = ແຫຼ່ງວັດຖຸ ແລະວິທີການ
    2 = ຂໍ້​ຄວາມ​ຜິດ​ພາດ​
    3 = ຕົວກໍານົດການປ້ອນຂໍ້ມູນ
    4 = ກັບຄືນ
    5 = ຄໍາເຕືອນ
    8 = ດ່ານ
    ຄ່າເລີ່ມຕົ້ນແມ່ນ 8.
  11. ກົດເຊື່ອມຕໍ່.
    ຖ້າການເຊື່ອມຕໍ່ປະສົບຜົນສໍາເລັດ, ຂໍ້ຄວາມສໍາເລັດຈະຖືກສະແດງຢູ່ໃນພາກສະຫນາມຜົນໄດ້ຮັບ. ຖ້າການເຊື່ອມຕໍ່ລົ້ມເຫລວ, ໃຫ້ກວດເບິ່ງບັນທຶກ COM API file ສໍາລັບຄວາມຜິດພາດ. ສະຖານທີ່ເລີ່ມຕົ້ນຂອງບັນທຶກ file ແມ່ນ APIAPILogs.

ການກວດສອບເວີຊັນຂອງອົງປະກອບ API ທີ່ຕິດຕັ້ງ
ທ່ານ​ສາ​ມາດ​ນໍາ​ໃຊ້​ຜົນ​ປະ​ໂຫຍດ checker ສະ​ບັບ​ເພື່ອ​ໄດ້​ຮັບ​ລາຍ​ລະ​ອຽດ​ກ່ຽວ​ກັບ​ອົງ​ປະ​ກອບ​ທີ່​ຕິດ​ຕັ້ງ​, ລວມ​ທັງ​ສະ​ບັບ​ປ່ອຍ​ແລະ​ເສັ້ນ​ທາງ​.

  1. ແລ່ນ CPVersionChecker.exe. ເສັ້ນທາງເລີ່ມຕົ້ນແມ່ນ: ອົງປະກອບ APIAPI
  2. ກົດອ່ານ.

ການກວດສອບສະບັບຂອງ Web API ການບໍລິການ

  1. ເປີດໃຊ້ Internet Explorer ຈາກເຊີບເວີບ່ອນທີ່ Web ບໍລິການ API ຖືກຕິດຕັ້ງ, ແລະໃສ່ທີ່ຢູ່:
    http://localhost.port/CPWeb.Service/WSLogin.asmx  ບ່ອນທີ່ພອດແມ່ນຫມາຍເລກພອດຂອງ webສະຖານທີ່ທີ່ທ່ານຕິດຕັ້ງ CPWebບໍລິການໄດເລກະທໍລີ virtual.
  2. ໃນໜ້າ WLogin, ຄລິກທີ່ລິ້ງ GetVersion.
  3. ກົດ Invoke.

ການ​ທົດ​ສອບ​ Web ການເຊື່ອມຕໍ່ການບໍລິການ API

  1. ເປີດໃຊ້ Internet Explorer ຈາກເຊີບເວີບ່ອນທີ່ Web ບໍລິການ API ຖືກຕິດຕັ້ງ, ແລະໃສ່ທີ່ຢູ່: http://localhost.port/CPWeb.Service/WSLogin.asmx  ບ່ອນທີ່ພອດແມ່ນຫມາຍເລກພອດຂອງ webສະຖານທີ່ທີ່ທ່ານຕິດຕັ້ງ CPWebບໍລິການໄດເລກະທໍລີ virtual.
  2. ໃນຫນ້າ WLogin ໃຫ້ຄລິກໃສ່ການເຊື່ອມຕໍ່ TestConnection.
  3. ກົດ Invoke. 4. ໃນ​ຜົນ​ການ​ທົດ​ສອບ​:
  • ຖ້າ ອົງປະກອບແມ່ນບໍ່ຖືກຕ້ອງ, ການເຊື່ອມຕໍ່ການທົດສອບສໍາເລັດ.
  • ຖ້າ ອົງປະກອບແມ່ນຄວາມຈິງ, ການເຊື່ອມຕໍ່ການທົດສອບລົ້ມເຫລວ. ສໍາລັບການເພີ່ມເຕີມ
    ຂໍ້ມູນກ່ຽວກັບເຫດຜົນຂອງຄວາມລົ້ມເຫລວ, ເບິ່ງ ແລະ ອົງປະກອບໃນຜົນການທົດສອບ, ແລະກວດເບິ່ງບັນທຶກ API. ເສັ້ນທາງເລີ່ມຕົ້ນຂອງບັນທຶກ API ແມ່ນ: APIAPILogs

ການ​ຕັ້ງ​ຄ່າ Web Services API ໃນເຊີບເວີພາສາ

  1. ເພື່ອນຳໃຊ້ Changepoint Web Services 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: ກຳນົດຢ່າງເຂັ້ມງວດ =” true” ເພື່ອບໍ່ອະນຸຍາດການປ່ຽນປະເພດຂໍ້ມູນທັງໝົດທີ່ການສູນເສຍຂໍ້ມູນສາມາດເກີດຂຶ້ນໄດ້. ກໍານົດ explicit = "true" ເພື່ອບັງຄັບໃຫ້ປະກາດຕົວແປທັງຫມົດ. –>
  4. ປິດເປີດ IIS ຄືນໃ່.

ເອກະສານ / ຊັບພະຍາກອນ

ຊອບແວ Changepoint API [pdf] ຄູ່ມືການຕິດຕັ້ງ
API, Software, API Software

ເອກະສານອ້າງອີງ

ກະທູ້ທີ່ກ່ຽວຂ້ອງ

ອອກຄໍາເຫັນ

ທີ່ຢູ່ອີເມວຂອງເຈົ້າຈະບໍ່ຖືກເຜີຍແຜ່. ຊ່ອງຂໍ້ມູນທີ່ຕ້ອງການຖືກໝາຍໄວ້ *