API ఇన్‌స్టాలేషన్ గైడ్
రిఫరెన్స్ గైడ్
చేంజ్ పాయింట్ 2021

© 2021 చేంజ్‌పాయింట్ కెనడా ULC అన్ని హక్కులు ప్రత్యేకించబడ్డాయి. US ప్రభుత్వ హక్కులు-ఉపయోగించడం, నకిలీ చేయడం లేదా US ప్రభుత్వం ద్వారా బహిర్గతం చేయడం అనేది చేంజ్‌పాయింట్ కెనడా 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 ఇక్కడ పేర్కొన్న కంటెంట్‌ను నోటీసుతో లేదా లేకుండా ఎప్పుడైనా మార్చవచ్చు.

కంటెంట్‌లు దాచు
1 చేంజ్‌పాయింట్ APIని ఇన్‌స్టాల్ చేస్తోంది
2 COM API కనెక్షన్‌ని పరీక్షిస్తోంది
3 పరీక్షిస్తోంది Web సేవల API కనెక్షన్
4 పత్రాలు / వనరులు
4.1 సూచనలు
5 సంబంధిత పోస్ట్‌లు

చేంజ్‌పాయింట్ APIని ఇన్‌స్టాల్ చేస్తోంది

చేంజ్‌పాయింట్ APIని ఇన్‌స్టాల్ చేయడం గురించి
చేంజ్‌పాయింట్ API COM APIగా అందుబాటులో ఉంది, ఒక Windows కమ్యూనికేషన్ ఫౌండేషన్ (WCF) సేవ మరియు వెనుకకు అనుకూలత కోసం, ఒక Web సేవల మెరుగుదలలు (WSE) సేవ. చేంజ్‌పాయింట్ API గురించిన సమాచారం కోసం, చేంజ్‌పాయింట్ API సూచనను చూడండి. అప్‌గ్రేడ్ గమనికలు, హెచ్చరికలు మరియు తెలిసిన సమస్యల కోసం, చేంజ్‌పాయింట్‌లోని టీమ్ ఫోల్డర్‌లలో విడుదల గమనికలను చూడండి.
చేంజ్‌పాయింట్ APIని అప్‌గ్రేడ్ చేస్తోంది
మీరు చేంజ్‌పాయింట్ యొక్క మునుపటి విడుదల నుండి అప్‌గ్రేడ్ చేస్తుంటే, ఈ సంస్కరణను ఇన్‌స్టాల్ చేసే ముందు Changepoint API మరియు దాని భాగాల యొక్క మునుపటి సంస్కరణను అన్‌ఇన్‌స్టాల్ చేయడానికి Windows కంట్రోల్ ప్యానెల్‌ని ఉపయోగించండి.
చేంజ్‌పాయింట్ API అవసరాలు
మీరు చేంజ్‌పాయింట్ APIని ఇన్‌స్టాల్ చేసే ముందు తప్పనిసరిగా చేంజ్‌పాయింట్‌ను ఇన్‌స్టాల్ చేయాలి. సాఫ్ట్‌వేర్ అవసరాల కోసం, ఛేంజ్‌పాయింట్‌లోని 2021 విడుదల నోట్స్ మరియు ప్యాచెస్ టీమ్ ఫోల్డర్‌లో అందుబాటులో ఉన్న చేంజ్‌పాయింట్ సాఫ్ట్‌వేర్ అనుకూలత మ్యాట్రిక్స్‌ను చూడండి.
File మార్గం సమావేశాలు
ఈ పత్రం అంతటా, సాధారణ మార్గాల కోసం క్రింది సమావేశాలు ఉపయోగించబడతాయి:

  • చేంజ్‌పాయింట్ ఇన్‌స్టాలేషన్ యొక్క రూట్ పాత్.
    డిఫాల్ట్ మార్గం:
    సి: ప్రోగ్రామ్ Files (x86)ChangepointChangepoint
  • లాగిన్ సెట్టింగ్‌ల యుటిలిటీ వంటి సాధారణ చేంజ్‌పాయింట్ యుటిలిటీల కోసం మూల స్థానం.
    డిఫాల్ట్ మార్గం:
    సి: ప్రోగ్రామ్ Fileలు (x86) సాధారణం FilesChangepointChangepoint

చేంజ్‌పాయింట్ APIని ఇన్‌స్టాల్ చేస్తోంది

  1. Changepoint API మీడియా రూట్ డైరెక్టరీ నుండి, setup.exeని అమలు చేయండి.
  2. ఫీచర్స్ ఎంచుకోండి స్క్రీన్ కనిపించే వరకు ప్రాంప్ట్‌లను అనుసరించండి.
  3. మీరు ఇన్‌స్టాల్ చేయాలనుకుంటున్న ఫీచర్‌లను ఎంచుకుని, తర్వాత క్లిక్ చేయండి.
  4. API డెస్టినేషన్ ఫోల్డర్, డిఫాల్ట్‌ని ఎంచుకోండి API, మరియు తదుపరి క్లిక్ చేయండి.
    గమనిక: చేంజ్‌పాయింట్ లాగిన్ సెట్టింగ్‌ల యుటిలిటీ ఇన్‌స్టాల్ చేయబడింది లాగిన్ సెట్టింగ్‌లు, మీరు పేర్కొన్న గమ్య ఫోల్డర్‌తో సంబంధం లేకుండా.
  5. మీరు ఎంచుకున్నట్లయితే Web సేవల API: a. ఎంపిక చేసినప్పుడు
    a Web సైట్ స్క్రీన్ కనిపిస్తుంది, a ఎంచుకోండి webవర్చువల్ డైరెక్టరీని జోడించడానికి సైట్, ఆపై తదుపరి క్లిక్ చేయండి.
    బి. కొనసాగించడానికి తదుపరి క్లిక్ చేయండి. 6. API యొక్క ఇన్‌స్టాలేషన్ పూర్తయినప్పుడు, ముగించు క్లిక్ చేయండి.

చేంజ్‌పాయింట్ APIని కాష్ తెలుసుకోవడం కోసం కాన్ఫిగర్ చేస్తోంది
చేంజ్‌పాయింట్ APIని కాష్-అవేర్‌గా కాన్ఫిగర్ చేయడానికి, “కాష్ కోసం విలువలను భర్తీ చేయండి. పాస్వర్డ్" మరియు "కాష్. 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.services2″ …>webసేవలు>web.services2>
    గమనిక: దిwebసేవలు> వ్యాఖ్యానించబడని మూలకం చిన్నదిweb>.

కోసం లాగింగ్‌ని కాన్ఫిగర్ చేస్తోంది Web సేవల API
మీరు తప్పనిసరిగా లాగ్‌ను సెట్ చేయాలి file మార్గం మరియు లాగ్ స్థాయిలు. లాగ్ స్థాయిలు సంచితమైనవి. ఉదాహరణకుample, మీరు స్థాయి 3ని పేర్కొంటే, 1, 2 మరియు 3 స్థాయిలు లాగ్ చేయబడతాయి. డిఫాల్ట్ లాగ్ స్థాయి 8.

  1. సవరించండి web సేవలు Web.config. డిఫాల్ట్ స్థానం:
    APICP Web సేవలుWeb.config
  2. లాగ్ సెట్ చేయండిFileమార్గం. డిఫాల్ట్ విలువ APIAPILలాగ్స్. 3. లాగ్‌లెవెల్‌ను సెట్ చేయండి. చెల్లుబాటు అయ్యే విలువలు:
    0 = లాగింగ్ లేదు
    1 = మూల వస్తువు మరియు పద్ధతి
    2 = ఎర్రర్ సందేశం
    3 = ఇన్‌పుట్ పారామితులు
    4 = రిటర్న్స్
    5 = హెచ్చరిక
    8 = తనిఖీ కేంద్రం

కోసం వర్చువల్ డైరెక్టరీ ప్రమాణీకరణను కాన్ఫిగర్ చేస్తోంది Web సేవల API
మీరు తప్పనిసరిగా అనామక ప్రాప్యతను ప్రారంభించాలి మరియు CP కోసం ఇంటిగ్రేటెడ్ విండోస్ ప్రమాణీకరణను నిలిపివేయాలిWebఇంటర్నెట్ ఇన్ఫర్మేషన్ సర్వీసెస్ (IIS)లో సర్వీస్ వర్చువల్ డైరెక్టరీ. మరింత సమాచారం కోసం, Microsoft 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 సేవలు అప్లికేషన్ ప్రమాణీకరణ.
ఈ విభాగంలోని విధానాలను ఉపయోగించండి:

  • Changepoint WCFని కాన్ఫిగర్ చేయండి Web SSLతో అప్లికేషన్ ప్రమాణీకరణను ఉపయోగించడానికి సేవలు
  • చేంజ్‌పాయింట్ WCFని తిరిగి మార్చండి Web SSO అమలులలో ఒకదాన్ని అమలు చేసిన తర్వాత అప్లికేషన్ ప్రమాణీకరణకు సేవలు

PowerShellని కాన్ఫిగర్ చేయండి

  1. Windows PowerShell ప్రాంప్ట్ తెరవండి.
  2. అమలు విధానాన్ని సవరించండి:
    సెట్-ఎగ్జిక్యూషన్ పాలసీ అనియంత్రిత

Stagఇ 1 కాన్ఫిగరేషన్ పారామితులను సేకరించండి
కాన్ఫిగరేషన్ పారామితుల కోసం విలువలను నిర్ణయించండి.

పరామితి వివరణ
Webసేవా_మార్గం చేంజ్‌పాయింట్ WCF యొక్క స్థానం Web సేవలు web అప్లికేషన్ files.
డిఫాల్ట్: \API\CP Web సేవలు
సేవా ధృవీకరణ పత్రం_
పేరు		 మెసేజ్ సెక్యూరిటీ మోడ్‌ని ఉపయోగించి క్లయింట్‌లకు సేవను ప్రామాణీకరించడానికి ఉపయోగించే సర్టిఫికెట్ పేరు.
డిఫాల్ట్: “CN=ChangepointAPICertificate” సర్టిఫికెట్ పేరు.
HTTPS అవసరం HTTPS అవసరం (ఒప్పు/తప్పు)
డిఫాల్ట్: తప్పు.

Stagఇ 2 కాన్ఫిగరేషన్ స్క్రిప్ట్‌లను అమలు చేయండి
యొక్క కాన్ఫిగరేషన్‌ను సవరించడానికి కాన్ఫిగరేషన్ పారామితుల కోసం విలువలను ఉపయోగించండి webసైట్లు.

  1.  పవర్‌షెల్ ప్రాంప్ట్‌ను తెరవండి.
    గమనిక: మీ సర్వర్ వినియోగదారు ఖాతా నియంత్రణను ప్రారంభించినట్లయితే, మీరు ఎలివేటెడ్ అడ్మినిస్ట్రేటర్ అనుమతులను ఉపయోగించి పవర్‌షెల్ ప్రాంప్ట్‌ను తప్పక తెరవాలి.
  2. CPకి నావిగేట్ చేయండి web సర్వీస్ కాన్ఫిగరేషన్ డైరెక్టరీ, డిఫాల్ట్:
    కాన్ఫిగరేషన్CPWebసేవ
  3.  ./Configuration_AppAuth.ps1ని అమలు చేయండి
  4. ప్రాంప్ట్‌లను అనుసరించండి.

WCF కోసం సింగిల్ సైన్-ఆన్ (SSO)ని కాన్ఫిగర్ చేస్తోంది Web సేవలు
PowerShellని కాన్ఫిగర్ చేయండి

  1. Windows PowerShell ప్రాంప్ట్ తెరవండి.
  2. అమలు విధానాన్ని సవరించండి:
    సెట్-ఎగ్జిక్యూషన్ పాలసీ అనియంత్రిత

WCF కోసం ISAPIని ఉపయోగించి SSOని కాన్ఫిగర్ చేస్తోంది Web సేవలు
Stagఇ 1 కాన్ఫిగరేషన్ పారామితులను సేకరించండి
కింది కాన్ఫిగరేషన్ పారామితుల కోసం విలువలను నిర్ణయించండి.

పరామితి వివరణ
Webసేవా_మార్గం చేంజ్‌పాయింట్ WCF యొక్క స్థానం Web సేవలు web అప్లికేషన్ files.
డిఫాల్ట్: \API\CP Web సేవలు
HTTPS అవసరం HTTPS అవసరం (నిజం/తప్పు).
డిఫాల్ట్: తప్పు.
చేంజ్ పాయింట్_RSA_
కుకీ_పరివర్తన		 మీరు కుక్కీ ఎన్‌క్రిప్షన్ కోసం ఉపయోగించే ప్రమాణపత్రం పేరు.
డిఫాల్ట్: “CN=ChangepointAPICertificate” సర్టిఫికెట్ పేరు.
సర్వీస్ సర్టిఫికేట్_పేరు మెసేజ్ సెక్యూరిటీ మోడ్‌ని ఉపయోగించి క్లయింట్‌లకు సేవను ప్రామాణీకరించడానికి ఉపయోగించే సర్టిఫికెట్ పేరును నమోదు చేయండి.
డిఫాల్ట్: “CN=ChangepointAPICertificate” సర్టిఫికెట్ పేరు.
SigningCertificate_Name సంతకం సర్టిఫికేట్ పేరును నమోదు చేయండి. సందేశాలపై సంతకం చేయడానికి మీరు ఉపయోగించే ప్రమాణపత్రం పేరు ఇది.
డిఫాల్ట్: “CN=ChangepointAPICertificate” సర్టిఫికెట్ పేరు.
ISAPI_Mode ISAPI మోడ్.
డిఫాల్ట్: NT
ISAPI_హెడర్ ISAPI_Mode “HEADER” అయినప్పుడు ఉపయోగించే హెడర్, ఉదాహరణకుampలే, ఖాళీ.
దావా రకం SSO క్లెయిమ్ రకాన్ని నమోదు చేయండి.
డిఫాల్ట్: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn

Stagఇ 2 కాన్ఫిగరేషన్ స్క్రిప్ట్‌లను అమలు చేయండి

  1. పవర్‌షెల్ ప్రాంప్ట్‌ను తెరవండి.
    గమనిక: మీ సర్వర్ వినియోగదారు ఖాతా నియంత్రణను ప్రారంభించినట్లయితే, మీరు ఎలివేటెడ్ అడ్మినిస్ట్రేటర్ అనుమతులను ఉపయోగించి పవర్‌షెల్ ప్రాంప్ట్‌ను తప్పక తెరవాలి.
  2. CPకి నావిగేట్ చేయండి web సర్వీస్ కాన్ఫిగరేషన్ డైరెక్టరీ, డిఫాల్ట్:
    కాన్ఫిగరేషన్CPWebసేవ
  3. అమలు చేయండి: ./Configuration_SSO_ISAPI.ps1
  4. ప్రాంప్ట్‌లను అనుసరించండి.

WCF కోసం WS-ఫెడరేషన్ (ADFS 2.0)ని ఉపయోగించి SSOని కాన్ఫిగర్ చేస్తోంది Web సేవలు
Stagఇ 1 కాన్ఫిగరేషన్ పారామితులను సేకరించండి
దిగువ పట్టికలోని కాన్ఫిగరేషన్ పారామితుల కోసం విలువలను నిర్ణయించండి. ADFS_Server_URI తుది వినియోగదారు బ్రౌజర్‌లోని ఇంట్రానెట్ జోన్‌లో ఉందని నిర్ధారించుకోండి.
గమనిక: డిఫాల్ట్‌గా, ప్రచురించబడిన ఫెడరేషన్ మెటాడేటా పత్రాన్ని ఉపయోగించి భద్రతా టోకెన్‌లపై సంతకం చేయడానికి ఉపయోగించే పబ్లిక్ కీలను స్వయంచాలకంగా నవీకరించడానికి చేంజ్‌పాయింట్ కాన్ఫిగర్ చేయబడింది. ADFSలో ఇది:
https://ADFS_Federation.ServiceName/FederationMetadata/2007-06/FederationMetadata.xml
కొన్ని సందర్భాల్లో చేంజ్‌పాయింట్ నుండి ADFS సర్వర్‌ని చేరుకోవడం సాధ్యం కాకపోవచ్చు web సర్వర్ కాబట్టి మీరు కాన్ఫిగరేషన్ స్క్రిప్ట్‌ని అమలు చేసిన తర్వాత కాన్ఫిగరేషన్‌ను మాన్యువల్‌గా అప్‌డేట్ చేయాలి. వివరాల కోసం, పేజీ 12లోని “పబ్లిక్ కీలను మాన్యువల్‌గా అప్‌డేట్ చేయడం” చూడండి.

పరామితి వివరణ
Webసేవా_మార్గం చేంజ్‌పాయింట్ WCF యొక్క స్థానం Web సేవలు web అప్లికేషన్ fileలు. డిఫాల్ట్: \API\CP Web సేవలు
Webసర్వీస్_URI మీరు Changepoint WCF కోసం ఉపయోగించే డొమైన్ ఐడెంటిఫైయర్ Web సేవలు. ఉదాహరణకుample., https://changepointapi.abc.corp/CPWebService
Changepoint_RSA_ Cookie_Transform మీరు కుక్కీ ఎన్‌క్రిప్షన్ కోసం ఉపయోగించే సర్టిఫికెట్ పేరు. డిఫాల్ట్: “CN=ChangepointApiCertificate” సర్టిఫికెట్ పేరు.
సర్వీస్ సర్టిఫికేట్_పేరు మెసేజ్ సెక్యూరిటీ మోడ్‌ని ఉపయోగించి క్లయింట్‌లకు సేవను ప్రామాణీకరించడానికి ఉపయోగించే సర్టిఫికెట్ పేరు.
డిఫాల్ట్: “CN=ChangepointApiCertificate” సర్టిఫికెట్ పేరు.
SigningCertificate_Name సందేశాలపై సంతకం చేయడానికి మీరు ఉపయోగించే ప్రమాణపత్రం పేరు.
డిఫాల్ట్: “CN=ChangepointApiCertificate” సర్టిఫికెట్ పేరు ఉపయోగించబడుతుంది.
ADFS_ ఫెడరేషన్ సర్వీస్ పేరు ఫెడరేషన్ సర్వీస్ పేరు. పేరు పొందడానికి: ADFS సర్వర్ నుండి, ADFS 2.0 మేనేజ్‌మెంట్ కన్సోల్‌ను ప్రారంభించండి.
•ఎడమవైపు మెను నుండి ADFS 2.0ని ఎంచుకోండి.
•యాక్షన్ పేన్ నుండి ఎడిట్ ఫెడరేషన్ సర్వీస్ ప్రాపర్టీలను ఎంచుకోండి.
ఫెడరేషన్ సర్వీస్ పేరు జనరల్ ట్యాబ్‌లో ఉంది.
దావా రకం SSO క్లెయిమ్ రకం. డిఫాల్ట్: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn

Stagఇ 2 కాన్ఫిగరేషన్ స్క్రిప్ట్‌లను అమలు చేయండి
కాన్ఫిగర్ చేయండి webకాన్ఫిగరేషన్ పారామితుల కోసం విలువలను ఉపయోగించే సైట్‌లు.

  1. పవర్‌షెల్ ప్రాంప్ట్‌ను తెరవండి.
    గమనిక: మీ సర్వర్ వినియోగదారు ఖాతా నియంత్రణను ప్రారంభించినట్లయితే, మీరు ఎలివేటెడ్ అడ్మినిస్ట్రేటర్ అనుమతులను ఉపయోగించి పవర్‌షెల్ ప్రాంప్ట్‌ను తప్పక తెరవాలి.
  2. చేంజ్ పాయింట్‌కి నావిగేట్ చేయండి web సర్వీస్ కాన్ఫిగరేషన్ డైరెక్టరీ, డిఫాల్ట్: కాన్ఫిగరేషన్CPWebసేవ
  3.  అమలు చేయండి: ./Configuration_SSO_ADFS.ps1
  4. ప్రాంప్ట్‌లను అనుసరించండి.

Stagఇ 3 ఆధారపడే పార్టీ నమ్మకాన్ని సృష్టించండి
ADFS 2.0 కన్సోల్‌లో ఆధారపడే పార్టీ ట్రస్ట్‌ను సృష్టించండి.

  1. మీ ADFS సర్వర్‌లో, ADFS 2.0 కన్సోల్‌ను ప్రారంభించండి.
  2. చర్యను ఎంచుకోండి > ఆధారపడే పార్టీ ట్రస్ట్‌ను జోడించండి.
  3. ప్రారంభం క్లిక్ చేయండి.
  4. ఆన్‌లైన్‌లో లేదా స్థానిక నెట్‌వర్క్‌లో ప్రచురించబడిన ఆధారపడే పార్టీ గురించి డేటాను దిగుమతి చేయి ఎంచుకోండి.
  5. ఫెడరేషన్ మెటాడేటా చిరునామాను నమోదు చేసి, ఆపై తదుపరి క్లిక్ చేయండి, ఉదాహరణకుampలే:
    https://changepointapi.abc.corp/cpwebservice/federationmetadata/2007-06/federationmetadata.xml
  6. డిస్ప్లే పేరును నమోదు చేయండి, ఉదా చేంజ్‌పాయింట్ WCF API, మరియు తదుపరి, తదుపరి, తదుపరి, ఆపై మూసివేయి క్లిక్ చేయండి.
  7. ఎగువ చేంజ్‌పాయింట్ రిలయింగ్ పార్టీ కోసం క్లెయిమ్ నియమాన్ని జోడించండి. చేంజ్‌పాయింట్ కోసం, డిఫాల్ట్ క్లెయిమ్ రూల్ పేరు “UPN”.
  8. అవుట్‌గోయింగ్ క్లెయిమ్ రకానికి "* UPN" లేదా "UPN"కి LDAP అట్రిబ్యూట్ “యూజర్-ప్రిన్సిపల్-నేమ్” మ్యాప్ చేయండి.

పబ్లిక్ కీలను మాన్యువల్‌గా అప్‌డేట్ చేస్తోంది
ADFS సర్వర్ టోకెన్ సంతకం థంబ్ప్రింట్ పొందేందుకు

  1. ADFS సర్వర్ నుండి, ADFS 2.0 మేనేజ్‌మెంట్ కన్సోల్‌ను ప్రారంభించండి.
  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 భాగాలుApiTestKit.exe.
  2. కనెక్షన్ స్ట్రింగ్ > ఎన్క్రిప్టర్ క్లిక్ చేయండి.
  3. సాదా వచన కనెక్షన్ల స్ట్రింగ్ ఫీల్డ్‌లో:
    a. మీ డేటాబేస్ సమాచారంతో SERVERNAME మరియు DATABASENAMEని భర్తీ చేయండి.
    బి. USERID మరియు PASSWORDని మీ డేటాబేస్ అడ్మిన్ యూజర్ ఖాతా సమాచారంతో భర్తీ చేయండి.
    సి. అవసరమైన విధంగా గడువు ముగింపు విలువను నమోదు చేయండి.
  4. ఎన్క్రిప్ట్ క్లిక్ చేయండి.
  5. ఎన్‌క్రిప్టెడ్ కనెక్షన్ స్ట్రింగ్ ఫీల్డ్‌లో, టెక్స్ట్‌ను కాపీ చేయండి.
  6. డైలాగ్ బాక్స్‌ను మూసివేయండి.
  7. API టెస్ట్ కిట్ మెనులో, కనెక్షన్ > COM API కనెక్షన్ టెస్టర్ క్లిక్ చేయండి.
  8. ప్రస్తుత సంస్కరణ ట్యాబ్‌లో, ఎన్‌క్రిప్టెడ్ కనెక్షన్ స్ట్రింగ్‌ను కనెక్షన్ స్ట్రింగ్ ఫీల్డ్‌లో అతికించండి.
  9. LoginId మరియు పాస్‌వర్డ్ ఫీల్డ్‌లలో, మీ చేంజ్‌పాయింట్ ఖాతా కోసం లాగిన్ ID మరియు పాస్‌వర్డ్‌ను నమోదు చేయండి.
  10. లాగ్‌లెవెల్ (0-8) ఫీల్డ్‌లో, COM API లాగ్‌లో తిరిగి ఇవ్వాల్సిన ఎర్రర్ సమాచారం స్థాయిని పేర్కొనండి file పరీక్ష ఫలితం కనెక్షన్‌తో సమస్యను చూపిస్తే.
    0 = లాగింగ్ లేదు
    1 = మూల వస్తువు మరియు పద్ధతి
    2 = ఎర్రర్ సందేశం
    3 = ఇన్‌పుట్ పారామితులు
    4 = రిటర్న్స్
    5 = హెచ్చరిక
    8 = తనిఖీ కేంద్రం
    డిఫాల్ట్ 8.
  11. కనెక్ట్ క్లిక్ చేయండి.
    కనెక్షన్ విజయవంతమైతే, ఫలితాల ఫీల్డ్‌లో విజయ సందేశం ప్రదర్శించబడుతుంది. కనెక్షన్ విఫలమైతే, COM API లాగ్‌ని తనిఖీ చేయండి file లోపాల కోసం. లాగ్ యొక్క డిఫాల్ట్ స్థానం file ఉంది APIAPILలాగ్స్.

ఇన్‌స్టాల్ చేయబడిన API భాగాల సంస్కరణను తనిఖీ చేస్తోంది
విడుదల సంస్కరణ మరియు మార్గంతో సహా ఇన్‌స్టాల్ చేయబడిన భాగాల గురించి వివరాలను పొందేందుకు మీరు సంస్కరణ చెకర్ యుటిలిటీని ఉపయోగించవచ్చు.

  1. CPVersionChecker.exeని అమలు చేయండి. డిఫాల్ట్ మార్గం: APIAPI భాగాలు
  2. చదవండి క్లిక్ చేయండి.

యొక్క సంస్కరణను తనిఖీ చేస్తోంది Web సేవల API

  1. సర్వర్ నుండి ఇంటర్నెట్ ఎక్స్‌ప్లోరర్‌ను ప్రారంభించండి Web సేవల API ఇన్‌స్టాల్ చేయబడింది మరియు చిరునామాను నమోదు చేయండి:
    http://localhost.port/CPWeb.Service/WSLogin.asmx  ఇక్కడ పోర్ట్ అనేది పోర్ట్ సంఖ్య webమీరు CPని ఇన్‌స్టాల్ చేసిన సైట్Webసర్వీస్ వర్చువల్ డైరెక్టరీ.
  2. WSLlogin పేజీలో, GetVersion లింక్‌పై క్లిక్ చేయండి.
  3. ఇన్వోక్ క్లిక్ చేయండి.

పరీక్షిస్తోంది Web సేవల API కనెక్షన్

  1. సర్వర్ నుండి ఇంటర్నెట్ ఎక్స్‌ప్లోరర్‌ను ప్రారంభించండి Web సేవల API ఇన్‌స్టాల్ చేయబడింది మరియు చిరునామాను నమోదు చేయండి: http://localhost.port/CPWeb.Service/WSLogin.asmx  ఇక్కడ పోర్ట్ అనేది పోర్ట్ సంఖ్య webమీరు CPని ఇన్‌స్టాల్ చేసిన సైట్Webసర్వీస్ వర్చువల్ డైరెక్టరీ.
  2. WSLlogin పేజీలో TestConnection లింక్‌పై క్లిక్ చేయండి.
  3. ఇన్వోక్ క్లిక్ చేయండి. 4. పరీక్ష ఫలితాలలో:
  • ఉంటే మూలకం తప్పు, పరీక్ష కనెక్షన్ విజయవంతమైంది.
  • ఉంటే మూలకం నిజం, పరీక్ష కనెక్షన్ విఫలమైంది. ఇంకా కావాలంటే
    వైఫల్యానికి కారణాలపై సమాచారం, చూడండి మరియు పరీక్ష ఫలితాలలోని అంశాలు మరియు API లాగ్‌లను తనిఖీ చేయండి. API లాగ్‌లకు డిఫాల్ట్ మార్గం: APIAPILలాగ్స్

ఏర్పాటు చేస్తోంది Web భాషా సర్వర్‌లో సేవల API

  1. చేంజ్‌పాయింట్‌ని అమలు చేయడానికి Web భాషా సర్వర్‌లో సేవల API, మీరు తప్పనిసరిగా జోడించాలి లేదా నవీకరించాలి tag లో Web సేవల API web.config. యొక్క డిఫాల్ట్ స్థానం Web.config file ఉంది: APICP Web సేవలుWeb.config
  2. ఉంటే tag ఇప్పటికే ఉనికిలో ఉంది, సంస్కృతి మరియు uiCulture గుణాలు రెండూ “en-US” అని నిర్ధారించుకోండి.
  3. ఉంటే tag ఇప్పటికే ఉనికిలో లేదు, కింది వాటిని జోడించండి , వ్యాఖ్య, మరియు మూలకాలుweb> నోడ్:web>
    విజువల్ బేసిక్ ఎంపికలు: డేటా నష్టం సంభవించే అన్ని డేటా రకం మార్పిడులను అనుమతించకుండా ఉండటానికి స్ట్రిక్ట్ =” true”ని సెట్ చేయండి. అన్ని వేరియబుల్స్‌ని బలవంతంగా డిక్లరేషన్ చేయడానికి స్పష్టమైన=”ట్రూ” సెట్ చేయండి. –>
  4. IIS పునప్రారంభించండి.

పత్రాలు / వనరులు

చేంజ్‌పాయింట్ API సాఫ్ట్‌వేర్ [pdf] ఇన్‌స్టాలేషన్ గైడ్
API, సాఫ్ట్‌వేర్, API సాఫ్ట్‌వేర్

సూచనలు

సంబంధిత పోస్ట్‌లు

వ్యాఖ్యానించండి

మీ ఇమెయిల్ చిరునామా ప్రచురించబడదు. అవసరమైన ఫీల్డ్‌లు గుర్తించబడ్డాయి *