
د API نصبولو لارښود
د حوالې لارښود
د بدلون نقطه 2021
© 2021 چینج پواینټ کاناډا ULC ټول حقونه خوندي دي. د متحده ایالاتو د حکومت حقونه - د متحده ایالاتو د حکومت لخوا کارول، نقل کول، یا افشا کول د محدودیتونو تابع دي لکه څنګه چې د چینج پواینټ کاناډا 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)، لکه څنګه چې د تطبیق وړ وي. دا محصول د چینج پواینټ کاناډا ULC محرم معلومات او سوداګریز رازونه لري. افشا کول د چینج پواینټ کاناډا ULC مخکینۍ څرګند لیکلي اجازې پرته منع دي. د دې محصول کارول د چینج پواینټ کاناډا ULC سره د کارونکي جواز تړون شرایطو او شرایطو تابع دي. اسناد یوازې د داخلي کارونې لپاره د جواز اخیستونکي لخوا تولید کیدی شي. د دې سند مینځپانګه ممکن د چینج پواینټ کاناډا ULC څرګند لیکلي رضایت پرته بدله ، تعدیل یا بدله نشي. چینج پواینټ کاناډا ULC کولی شي هر وخت د خبرتیا سره یا پرته له دې چې دلته مشخص شوي مینځپانګه بدله کړي.
د Changepoint API نصب کول
د Changepoint API نصبولو په اړه
د بدلون نقطه API د COM API په توګه شتون لري، د وینډوز ارتباط بنسټ (WCF) خدمت او د شاته مطابقت لپاره، د Web د خدماتو وده (WSE) خدمت. د Changepoint API په اړه د معلوماتو لپاره، د Changepoint API حواله وګورئ. د نوي کولو نوټونو، احتیاطونو او پیژندل شویو مسلو لپاره، د بدلون پوائنټ کې د ټیم فولډرونو کې د ریلیز یادښتونه وګورئ.
د بدلون نقطې API ته وده ورکول
که تاسو د چینج پواینټ پخوانۍ خپرونې څخه اپ گریڈ کوئ، د وینډوز کنټرول پینل وکاروئ ترڅو د دې نسخې نصبولو دمخه د چینج پواینټ API پخوانی نسخه او د هغې برخې غیر نصب کړئ.
د API اړتیاو بدلول
تاسو باید د بدلون نقطه نصب کړئ مخکې لدې چې تاسو د چینج پواینټ API نصب کړئ. د سافټویر اړتیاو لپاره ، د چینج پواینټ سافټویر مطابقت میټریکس وګورئ ، کوم چې د 2021 ریلیز نوټونو او پیچ ټیم فولډر کې د چینج پواینټ کې شتون لري.
File د لارې کنوانسیونونه
د دې سند په اوږدو کې، لاندې کنوانسیونونه د عامو لارو لپاره کارول کیږي:
- د چینج پواینټ نصبولو ریښه لاره.
اصلي لاره ده:
ج: برنامه Files (x86)ChangepointChangepoint - د عام بدلون نقطې اسانتیاو لپاره د ریښې موقعیت، لکه د ننوتلو ترتیباتو اسانتیا.
اصلي لاره ده:
ج: برنامه Files (x86) عام FilesChangepointChangepoint
د Changepoint API نصب کول
- د Changepoint API میډیا روټ لارښود څخه، setup.exe چل کړئ.
- لارښوونې تعقیب کړئ تر هغه چې د انتخاب ځانګړتیاو سکرین څرګند شي.
- هغه ځانګړتیاوې غوره کړئ چې تاسو یې نصب کول غواړئ، بیا وروسته کلیک وکړئ.
- د API منزل فولډر غوره کړئ، ډیفالټ API، او بیا کلیک وکړئ.
یادونه: د Changepoint Login Settings یوټیلیټ په کې نصب شوی دی د ننوتلو ترتیبات، پرته له دې چې د منزل فولډر چې تاسو یې مشخص کړئ. - که تاسو غوره کړئ Web د خدماتو API: a. کله چې وټاکئ
a Web د سایټ سکرین څرګندیږي ، غوره کړئ a webسایټ ته د مجازی لارښود اضافه کولو لپاره، او بیا وروسته کلیک وکړئ.
ب. د دوام لپاره بل کلیک وکړئ. 6. کله چې د API نصب کول بشپړ شي، په پای کې کلیک وکړئ.
د کیچ خبرتیا لپاره د Changepoint API ترتیب کول
د کیچ خبرتیا لپاره د Changepoint API تنظیم کولو لپاره ، د "کیچ" لپاره ارزښتونه ځای په ځای کړئ. پټنوم" او "کیچ. په CP کې د سرورونو کیلي Web خدمتونهWeb.config file په تصدۍ کې کارول شوي ارزښتونو سرهWeb.config file.
فعالول Web د خدماتو وده (WSE)
- ایډیټ کړئ Web.config file لپاره web خدمتونه اصلي ځای دا دی:
APICP Web خدمتونهWeb.config - د لاندې تبصرې کرښې درې مثالونه ومومئ:
< !- که تاسو کاروئ نو لاندې عنصر غیر تبصره کړئ Web د خدماتو وده (WSE) API. نظرونه پریږدئ که چیرې د WCF خدمتونه کاروئ او نصب نه وي Web د خدماتو وده (WSE) –> - هغه عنصر غیر تبصره کړئ چې د تبصرې کرښې هر مثال تعقیبوي:
<د برخې نوم="مائیکروسافټ.webخدمات2″ … >webخدمتونه>web.services2>
یادونه: دwebخدمتونه> عنصر باید غیر تبصره شي د ماشوم دیweb>.
د ننوتلو ترتیب کول Web د خدماتو API
تاسو باید لاګ تنظیم کړئ file د لارې او ننوتلو کچه. د ننوتلو کچه مجموعي ده. د مثال لپارهample، که تاسو 3 کچه مشخص کړئ، نو بیا 1، 2، او 3 کچه ثبت شوي. د ډیفالټ لاګ کچه 8 ده.
- ایډیټ کړئ web خدمتونه Web.config. اصلي ځای دا دی:
APICP Web خدمتونهWeb.config - لاګ تنظیم کړئFileلاره. ډیفالټ ارزښت دی APIAPILogs. 3. د Log Level تنظیم کړئ. معتبر ارزښتونه دا دي:
0 = هیڅ ننوتل
1 = سرچینه اعتراض او طریقه
2 = د خطا پیغام
3 = د ننوتلو پیرامیټونه
4 = بیرته راګرځي
5 = خبرداری
8 = پوسته
د مجازی لارښود تصدیق تنظیم کول Web د خدماتو API
تاسو باید نامعلوم لاسرسی فعال کړئ او د CP لپاره مدغم وینډوز تصدیق غیر فعال کړئWebد انټرنیټ معلوماتو خدماتو (IIS) کې د خدمت مجازی لارښود. د نورو معلوماتو لپاره، د مایکروسافټ IIS اسناد وګورئ.
لپاره د ډیټابیس پیوستون تنظیمات تنظیم کول Web د خدماتو API
د ډیټابیس پیوستون تنظیماتو کوډ کولو لپاره د ننوتلو ترتیباتو کارول وکاروئ Web د خدماتو API Web.config file. د نورو معلوماتو لپاره، د بدلون پوائنټ نصبولو لارښود کې "د ډیټابیس اتصال ترتیبات تنظیم کول" لټون وکړئ.
د بدلون پوائنټ WCF لپاره تصدیق کول Web خدمتونه
تاسو کولی شئ د بدلون پوائنټ WCF لپاره د غوښتنلیک تصدیق او واحد لاسلیک (SSO) تنظیم کړئ Web خدمتونه.
د خوندي ټوکن خدمت (STS) په کارولو سره د پلي کولو لاندې اختیارونه شتون لري:
- SSO د ISAPI SSL اختیاري کاروي
- SSO د WS-Federation (ADFS 2.0) په کارولو سره SSL ته اړتیا لري
که SSL ته اړتیا وي، د ترتیب سکریپټ ډاډ ورکوي چې دا کارول کیږي.
د ISAPI او غوښتنلیک تصدیق لپاره د ترتیب سکریپټ کولی شي په اختیاري توګه SSL فعال کړي.
د WCF لپاره د غوښتنلیک تصدیق کول Web خدمتونه
د چینج پواینټ WCF لپاره د ډیفالټ تصدیق ډول Web خدمتونه د غوښتنلیک تصدیق دی.
په دې برخه کې پروسیجرونه وکاروئ:
- د بدلون نقطه WCF تنظیم کړئ Web د SSL سره د غوښتنلیک تصدیق کارولو لپاره خدمتونه
- د بدلون ټکی WCF بیرته راګرځول Web د SSO پلي کولو څخه یو پلي کولو وروسته د غوښتنلیک تصدیق کولو خدمتونه
PowerShell تنظیم کړئ
- د وینډوز پاور شیل پرامپټ خلاص کړئ.
- د اجرا کولو پالیسي تعدیل کړئ:
د سیټ اجرا کولو پالیسي غیر محدوده ده
Stage 1 د ترتیب کولو پیرامیټونه راټول کړئ
د ترتیب کولو پیرامیټونو لپاره ارزښتونه مشخص کړئ.
| پیرامیټر | تفصیل |
| Webخدمت_پاته | د WCF د بدلون ځای Web خدمتونه web غوښتنلیک files. ډیفالټ: \API\CP Web خدمتونه |
| د خدمت سند_ نوم |
د سند نوم چې د پیغام امنیت حالت په کارولو سره پیرودونکو ته د خدمت تصدیق کولو لپاره کارول کیږي. ډیفالټ: "CN=ChangepointAPICertificate" د سند نوم. |
| HTTPS ته اړتیا لري | HTTPS ته اړتیا لري (رښتیا/غلط) ډیفالټ: غلط. |
Stage 2 د ترتیب سکریپټ اجرا کول
د ترتیب کولو پیرامیټونو لپاره ارزښتونه وکاروئ ترڅو د ترتیب ترتیب بدل کړئ webسایټونه.
- د پاور شیل پرامپټ خلاص کړئ.
یادونه: که ستاسو سرور د کارن حساب کنټرول فعال کړی وي، نو تاسو باید د لوړ شوي مدیر اجازې په کارولو سره د پاور شیل پرامپټ خلاص کړئ. - CP ته لاړ شئ web د خدمت ترتیب لارښود، ډیفالټ:
ترتیب سي.پيWebخدمت - اجرا کول ./Configuration_AppAuth.ps1
- لارښوونې تعقیب کړئ.
د WCF لپاره د واحد لاسلیک (SSO) تنظیم کول Web خدمتونه
PowerShell تنظیم کړئ
- د وینډوز پاور شیل پرامپټ خلاص کړئ.
- د اجرا کولو پالیسي تعدیل کړئ:
د سیټ اجرا کولو پالیسي غیر محدوده ده
د WCF لپاره د ISAPI په کارولو سره د SSO تنظیم کول Web خدمتونه
Stage 1 د ترتیب کولو پیرامیټونه راټول کړئ
د لاندې ترتیب کولو پیرامیټونو لپاره ارزښتونه مشخص کړئ.
| پیرامیټر | تفصیل |
| Webخدمت_پاته | د WCF د بدلون ځای Web خدمتونه web غوښتنلیک files. ډیفالټ: \API\CP Web خدمتونه |
| HTTPS ته اړتیا لري | HTTPS ته اړتیا لري (ریښتیا/غلط). ډیفالټ: غلط. |
| د بدلون نقطه_RSA_ کوکی_ترانسفارم |
د هغه سند نوم چې تاسو یې د کوکي کوډ کولو لپاره کاروئ. ډیفالټ: "CN=ChangepointAPICertificate" د سند نوم. |
| د خدمت سند_نوم | د سند نوم دننه کړئ چې د پیغام امنیت حالت په کارولو سره پیرودونکو ته د خدمت تصدیق کولو لپاره کارول کیږي. ډیفالټ: "CN=ChangepointAPICertificate" د سند نوم. |
| د لاسلیک کولو سند_نوم | د لاسلیک کولو سند نوم دننه کړئ. دا د هغه سند نوم دی چې تاسو یې د پیغامونو لاسلیک کولو لپاره کاروئ. ډیفالټ: "CN=ChangepointAPICertificate" د سند نوم. |
| ISAPI_Mode | د ISAPI حالت. ډیفالټ: NT |
| ISAPI_Header | سرلیک هغه وخت کارول کیږي کله چې ISAPI_Mode "HEADER" وي، د مثال لپارهampلی، خالي. |
| د ادعا ډول | د SSO د ادعا ډول داخل کړئ. ډیفالټ: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn |
Stage 2 د ترتیب سکریپټ اجرا کول
- د پاور شیل پرامپټ خلاص کړئ.
یادونه: که ستاسو سرور د کارن حساب کنټرول فعال کړی وي، نو تاسو باید د لوړ شوي مدیر اجازې په کارولو سره د پاور شیل پرامپټ خلاص کړئ. - CP ته لاړ شئ web د خدمت ترتیب لارښود، ډیفالټ:
ترتیب سي.پيWebخدمت - اجرا کول: ./Configuration_SSO_ISAPI.ps1
- لارښوونې تعقیب کړئ.
د WCF لپاره د WS-Federation (ADFS 2.0) په کارولو سره د SSO تنظیم کول Web خدمتونه
Stage 1 د ترتیب کولو پیرامیټونه راټول کړئ
په لاندې جدول کې د ترتیب کولو پیرامیټونو لپاره ارزښتونه مشخص کړئ. ډاډ ترلاسه کړئ چې ADFS_Server_URI د پای کارونکي براوزر د انټرانیټ زون کې دی.
یادونه: په ډیفالټ ، د بدلون نقطه د عامه کیليونو په اوتومات ډول تازه کولو لپاره تنظیم شوې چې د خپاره شوي فدراسیون میټاډاټا سند په کارولو سره د امنیت نښه کولو لپاره کارول کیږي. په ADFS کې دا دی:
https://ADFS_Federation.ServiceName/FederationMetadata/2007-06/FederationMetadata.xml
په ځینو مواردو کې دا ممکن نه وي چې د بدلون پوائنټ څخه ADFS سرور ته ورسیږئ web سرور نو تاسو باید د ترتیب سکریپټ چلولو وروسته په لاسي ډول ترتیب تازه کړئ. د جزیاتو لپاره، په 12 مخ کې "په لاسي ډول د عامه کیلي تازه کول" وګورئ.
| پیرامیټر | تفصیل |
| Webخدمت_پاته | د WCF د بدلون ځای Web خدمتونه web غوښتنلیک files. ډیفالټ: \API\CP Web خدمتونه |
| Webخدمت_URI | د ډومین پیژندونکی چې تاسو د بدلون پوائنټ WCF لپاره کاروئ Web خدمتونه. د مثال لپارهampلی. ، https://changepointapi.abc.corp/CPWebService |
| د بدلولو_RSA_ کوکي_ټرانسفارم | د هغه سند نوم چې تاسو یې د کوکي کوډ کولو لپاره کاروئ. ډیفالټ: "CN=ChangepointApiCertificate" د سند نوم. |
| د خدمت سند_نوم | د سند نوم چې د پیغام امنیت حالت په کارولو سره پیرودونکو ته د خدمت تصدیق کولو لپاره کارول کیږي. ډیفالټ: "CN=ChangepointApiCertificate" د سند نوم. |
| د لاسلیک کولو سند_نوم | د هغه سند نوم چې تاسو د پیغامونو لاسلیک کولو لپاره کاروئ. ډیفالټ: "CN=ChangepointApiCertificate" د سند نوم کارول کیږي. |
| ADFS_ FederationServiceName | د فدراسیون د خدماتو نوم. د نوم ترلاسه کولو لپاره: د ADFS سرور څخه، د ADFS 2.0 مدیریت کنسول لانچ کړئ. • د کیڼ مینو څخه ADFS 2.0 غوره کړئ. • د عمل پین څخه د فیډریشن خدماتو ملکیتونو ترمیم غوره کړئ. د فدراسیون خدمت نوم په عمومي ټب کې دی. |
| د ادعا ډول | د SSO د ادعا ډول. ډیفالټ دا دی: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn |
Stage 2 د ترتیب سکریپټ اجرا کول
ترتیب کړئ webسایټونه د ترتیب کولو پیرامیټونو لپاره ارزښتونه کاروي.
- د پاور شیل پرامپټ خلاص کړئ.
یادونه: که ستاسو سرور د کارن حساب کنټرول فعال کړی وي، نو تاسو باید د لوړ شوي مدیر اجازې په کارولو سره د پاور شیل پرامپټ خلاص کړئ. - د بدلون نقطې ته لاړشئ web د خدمت ترتیب لارښود، ډیفالټ: ترتیب سي.پيWebخدمت
- اجرا کول: ./Configuration_SSO_ADFS.ps1
- لارښوونې تعقیب کړئ.
Stage 3 د تکیه لرونکی ګوند باور رامینځته کړئ
په ADFS 2.0 کنسول کې د تکیه کونکي ګوند باور رامینځته کړئ.
- ستاسو په ADFS سرور کې، د ADFS 2.0 کنسول پیل کړئ.
- عمل غوره کړئ> د تکیه کونکي ګوند باور اضافه کړئ.
- په پیل کلیک وکړئ.
- په آنلاین یا محلي شبکه کې خپاره شوي تکیه کونکي ګوند په اړه د وارداتو ډاټا غوره کړئ.
- د فدراسیون میټاډاټا پته دننه کړئ، او بیا د مثال لپاره، بل کلیک وکړئampLe:
https://changepointapi.abc.corp/cpwebservice/federationmetadata/2007-06/federationmetadata.xml - د ښودلو نوم دننه کړئ، د بیلګې په توګه د WCF API بدل کړئ، او بیا وروسته، بل، بل، بیا بند کړئ کلیک وکړئ.
- د پورتنۍ بدلون ټکي تکیه کونکي ګوند لپاره د ادعا قاعده اضافه کړئ. د بدلون نقطې لپاره، د اصلي ادعا قاعده نوم "UPN" دی.
- د LDAP خاصیت "د کارونکي-پرنسپل-نوم" د وتلو ادعا ډول "* UPN" یا "UPN" ته نقشه کړئ.
په لاسي ډول د عامه کیلي تازه کول
د ADFS سرور د نښه کولو نښه نښه ترلاسه کولو لپاره
- د ADFS سرور څخه، د ADFS 2.0 مدیریت کنسول لانچ کړئ.
- خدمت> سندونه وټاکئ، او د ټوکن لاسلیک کولو سند دوه ځله کلیک وکړئ.
- د جزیاتو ټب غوره کړئ.
- د ګوتو نښې ساحه غوره کړئ.
- د ګوتو نښان ارزښت ترلاسه کولو لپاره، د لومړي ځای په شمول ټول ځایونه لرې کړئ.
د تازه کولو لپاره Web.config file
- ADFS ترمیم کړئ web.config. اصلي ځای دا دی:
EnterpriseRP-STS_ADFS - لاندې له عنصر، ida ومومئ: FederationMetadataLocation کلي او د هغې ارزښت پاک کړئ:
- لاندې ، موندل عنصر او دا د لاندې سره بدل کړئ: https://ADFS_Federation.ServiceName/adfs/services/trust">https://ADFS_Federation.ServiceName/adfs/services/trust" />
د COM API پیوستون معاینه کول
- د API ټیسټ کټ چل کړئ. اصلي ځای دا دی:
APIAPI اجزاءApiTestKit.exe. - د اتصال سټرینګ> کوډ کوونکی کلیک وکړئ.
- د ساده متن اتصال سټرینګ ډګر کې:
a. د خپل ډیټابیس معلوماتو سره SERVERNAME او DATABASENAME بدل کړئ.
ب. USERID او PASSWORD د خپل ډیټابیس اډمین کارن حساب معلوماتو سره بدل کړئ.
ج. د اړتیا سره سم د وخت پای ارزښت دننه کړئ. - په کوډ کولو کلیک وکړئ.
- د کوډ شوي پیوستون سټینګ ساحه کې، متن کاپي کړئ.
- د ډیالوګ بکس وتړئ.
- د API ټیسټ کټ مینو کې، د پیوستون> COM API کنکشن ټیسټر کلیک وکړئ.
- په اوسنۍ نسخه ټب کې، د کوډ شوي پیوستون تار د اتصال سټرینګ ساحه کې پیسټ کړئ.
- د LoginId او پاسورډ په برخو کې، د خپل د بدلولو حساب حساب لپاره د ننوتلو ID او پټنوم دننه کړئ.
- په Loglevel (0-8) ساحه کې، د غلطۍ معلوماتو کچه مشخص کړئ چې د COM API لاګ کې بیرته راستانه شي file که د ازموینې پایله د پیوستون سره ستونزه ښیي.
0 = هیڅ ننوتل
1 = سرچینه اعتراض او طریقه
2 = د خطا پیغام
3 = د ننوتلو پیرامیټونه
4 = بیرته راګرځي
5 = خبرداری
8 = پوسته
ډیفالټ 8 دی. - په نښلولو کلیک وکړئ.
که اړیکه بریالۍ وه، د بریالیتوب پیغام به د پایلې په ډګر کې ښکاره شي. که پیوستون ناکام شو، د COM API لاګ وګورئ file د تېروتنو لپاره. د لاګ اصلي ځای file دی APIAPILogs.
د نصب شوي API اجزاوو نسخه چک کول
تاسو کولی شئ د نصب شوي اجزاو په اړه توضیحاتو ترلاسه کولو لپاره د نسخې چیکر افادیت وکاروئ ، پشمول د خوشې نسخه او لاره.
- CPVersionChecker.exe چل کړئ. اصلي لاره ده: د APIAPI اجزا
- په لوستلو کلیک وکړئ.
د نسخې چک کول Web د خدماتو API
- انټرنیټ اکسپلورر له سرور څخه لانچ کړئ چیرې چې Web د خدماتو API نصب شوی، او پته دننه کړئ:
http://localhost.port/CPWeb.Service/WSLogin.asmx چیرته چې پورټ د پورټ شمیره ده webهغه سایټ چیرې چې تاسو CP نصب کړیWebد خدمت مجازی لارښود. - په WSLlogin پاڼه کې، د GetVersion لینک کلیک وکړئ.
- په بلنه کلیک وکړئ.
معاینه کول Web د خدماتو API پیوستون
- انټرنیټ اکسپلورر له سرور څخه لانچ کړئ چیرې چې Web د خدماتو API نصب شوی، او پته دننه کړئ: http://localhost.port/CPWeb.Service/WSLogin.asmx چیرته چې پورټ د پورټ شمیره ده webهغه سایټ چیرې چې تاسو CP نصب کړیWebد خدمت مجازی لارښود.
- په WSLlogin پاڼه کې د ټیسټ کنکشن لینک کلیک وکړئ.
- په بلنه کلیک وکړئ. 4. د ازموینې پایلې کې:
- که عنصر غلط دی، د ازموینې اړیکه بریالۍ شوه.
- که عنصر ریښتیا دی، د ازموینې اړیکه ناکامه شوه. د لازیاتو لپاره
د ناکامۍ د لاملونو په اړه معلومات، وګورئ او د ازموینې پایلو کې عناصر، او د API لاګونه وګورئ. د API لاګونو لپاره ډیفالټ لاره دا ده: APIAPILogs
تنظیم کول Web د ژبې په سرور کې د خدماتو API
- د بدلون ځای ځای په ځای کولو لپاره Web د ژبې په سرور کې د خدماتو API، تاسو باید اضافه یا تازه کړئ tag په Web د خدماتو API web.config. د اصلي ځای Web.config file دی: APICP Web خدمتونهWeb.config
- که د tag لا دمخه شتون لري، ډاډ ترلاسه کړئ چې کلتور او uiCulture دواړه ځانګړتیاوې "en-US" دي.
- که د tag لا دمخه شتون نلري، لاندې اضافه کړئ تبصره، او عناصرو تهweb> نوډ:web>
بصری اساسی اختیارونه: د ټولو ډیټا ډولونو تبادلو منع کولو لپاره سخت = "ریښتین" تنظیم کړئ چیرې چې د ډیټا ضایع کیدی شي. د ټولو متغیرونو جبري اعلان کولو لپاره واضح = "ریښتیا" تنظیم کړئ. --> - IIS بیا پیل کړئ.
اسناد / سرچینې
![]() |
د بدلون نقطه API سافټویر [pdf] د نصبولو لارښود API، سافټویر، API سافټویر |




