Apex غوښتنې له Salesforce څخه وځي، نه ستاسو له VPN څخه
د لیپټاپ VPN ستاسو براوزر ته لاره ورکوي، نه Apex یا Marketing Cloud ته. ریښتینی غوښتونکی له عامه دروازې یا وړ خصوصي اړیکې سره سم کړئ.
په هغه شیبه چې لیپټاپ VPN ته نښلول کېږي، خصوصي API ستاسو په براوزر کې ځواب ورکوي، نو یوځای کول باید کار وکړي. نه کار کوي، ځکه چې غوښتنې کوونکی کوډ په بشپړ ډول بل ځای کې ځي. Apex د Salesforce د غوښتنلیکونو پر سرورونو ځي، او په Marketing Cloud کې د سرور اړخ فعالیت د هغه محصول په چلولو چاپېریال کې ځي. هېڅ یو یې ستاسو د لیپټاپ تونل نه میراث اخلي. دا د لنډ بهیر په توګه ترسره کړئ: غوښتونکی وپېژنئ، هغه ننوتل وټاکئ چې هغه غوښتونکی ورته رسېدلی شي، لاره له پیل څخه تر پای پورې ونښلوئ، بیا د چلولو له چاپېریال څخه پخپله تصدیق کړئ.
له هر ډول شبکې بدلون دمخه د غوښتونکي کارت ولیکئ
پنځه ساحې ډکې کړئ او د هغوی له یوه هم اټکل کولو څخه انکار وکړئ. د پلي کولو محصول او شرایط نور هر څه ټاکي، نو له هماغه ځایه پیل کړئ نه د سرور له فایر وال څخه.
| Field | What it must answer |
|---|---|
| Runtime | Which product and execution context issues the request? |
| Endpoint | Which hostname must that runtime resolve, and to what? |
| Path | Which supported public entry or private connection carries it? |
| Identity | Which credential and which operation is the API asked to authorize? |
| Failure | How do responses return, and what happens when the path is down? |
د براوزر ټب او Apex غوښتنه دوه بېل کسان دي، او کار کوونکی براوزر یوازې دا ثابتوي چې ستاسو له مېز څخه لاره شته. که د چلولو د چاپېریال ساحه Apex ووایي، اړوند پوښتنه دا ده چې Salesforce له کومو پتو راوځي، نه دا چې ستاسو لیپټاپ کوم پتې لري. ځکه هغه تونل چې API په براوزر کې باروي هم کولای شي یوځای کول د پخوا په څېر په هماغه مهال پای کې ناکام پرېږدي. د غوښتونکي کارت د دې لپاره دی چې دا تېروتنه مخکې له دې چې څوک فایر وال سم کړي، ودروي.
هغه ننوتل وټاکئ چې غوښتونکی یې واقعاً کارولی شي
دواړه ډیزاینونه قانوني دي، او دواړه بېلې ستونزې حل کوي. لومړی په قصد عامه ننوتل دي: د HTTPS API دروازه یا د یوځای کولو خدمت چې غوښتونکی تصدیقوي، تنګ اجازې پلي کوي او له خصوصي backend سره ساتل شوې اړیکه لري. دا له هغې سره یو شان نه دی چې هر backend خدمت پرانیستل شي یا د مدیریت پورټ انټرنیټ ته ولېږل شي.
دویمه یوه وړ خصوصي اړیکه ده. د Salesforce د وتلو Private Connect اسناد تشریح کوي چې څنګه ملاتړ شوې غوښتنې د Outbound Network Connection له لارې چې نومول شوي اعتبار ته تړل شوی، د هغې ټاکل شوې AWS PrivateLink ترتیب پر سر لارښوونه کېږي. دا ځانګړتیا د خپرېدو، جواز او محصول محدودیتونه لري، نو مخکې له دې چې شاوخوا یې ډیزاین وکړئ، تصدیق کړئ چې سازمان وړ دی.
هیڅ یو ډیزاین په Salesforce دننه نصب شوی OpenVPN کس نه دی، او دا پخوانی ادعا چې هر یوځای کول باید عامه backend ته ورسیږي، چېرې چې ملاتړ شوې خصوصي اړیکه ځای پر ځای کېږي ډېره پراخه ده. هغه وټاکئ چې د چلولو چاپېریال یې ملاتړ کوي، بیا ریښتیني API ته لاره بشپړه کړئ: AWS پای ټکی ستاسو سیمه ییز سرچینه نه پېژني او ستاسو د لیپټاپ لار نه میراث اخلي. DNS، د backend لارښوونه، د لاسرسي تګلاره او د ځواب ترافیک باید ټول ستاسو ټاکل شوې معماري تعقیب کړي. نیمګړې جوړه شوې خصوصي لاره په داسې ډول ناکامېږي چې دقیقاً د تصدیق ستونزه ښکاري.
خصوصي لاره له پیل څخه تر پای پورې ونښلوئ
له API څخه بهر کار وکړئ او په لومړي تشه کې ودرېږئ. تصدیق کړئ چې backend په سیمه ییز ډول ځواب وایي، بیا چې خصوصي پای ټکی هلته رسېږي، بیا چې نومول شوي اعتبار او د هغه وتلې اړیکه هغه پای ټکی هدف ګرځوي.
curl -sS -m 5 -o /dev/null -w '%{http_code}\n' http://10.40.8.20:8080/health
dig +short api.partner.example
sf apex run --file scripts/apex/callout-check.apex --target-org integrationلومړی حکم ثابتوي چې backend د خصوصي شبکې له داخله روغ دی، دویم ښیي چې نوم څه ته حل کېږي، او دریم د ریښتیني Salesforce چلولو چاپېریال څخه یوه غوښتنه ترسره کوي. له لومړي څخه 200 او له دریم څخه ناکامي تشه خدمت ته نه، بلکې لارې یا اعتبار ته جلا کوي.
د نښلولو پر مهال د هویت حد دقیق وساتئ. نومول شوی اعتبار یوازې نه رسېدونکی پای ټکی نه جوړوي، ځکه اعتبار او خصوصي اړیکه د بېلو دندو اړوند تنظیمات دي. د IP اجازه لړلیک شبکه ای منل تنګوي او د API اعتبار نه دی، نو نورمال TLS تصدیق او د خدمت خپل تصدیق او څرخېدلو بهیر وساتئ. که یوه ازموینه یوازې د سندې چک بندولو وروسته بریالۍ شي، تاسو د لارې نه، د کوربه نوم ستونزه موندلې ده، او سندې باید لا هم سمون ولري.
د چلولو له چاپېریال څخه تصدیق کړئ، بیا بیرته تګ ثبت کړئ
له خپل ماشین نه، د یوځای کولو د چلولو له چاپېریال څخه یوه بې ضرره اجازه شوې غوښتنه ومنئ. د ترلاسه کوونکي خدمت لیدل شوی سرچینه، تصدیق شوی بنسټ، پایله او یوه په قصد رد شوې غوښتنه چې باید ناکامه شي، ثبت کړئ.
curl -sS -o /dev/null -w '%{http_code} %{remote_ip}\n' https://api.partner.example/v1/ping
curl -sS -o /dev/null -w '%{http_code}\n' -H 'Authorization: Bearer invalid' https://api.partner.example/v1/pingهغه دوه ازموینې د backend له خپلې شبکې څخه وچلوئ ترڅو لیدل شوې سرچینه د چلولو چاپېریال له تولید سره پرتله شي. 200 او بیا 401 یا 403 هغه بڼه ده چې غواړئ؛ دوه 200 معنا دا چې د رد لاره واقعاً نه پلي کېږي.
بیرته تګ مخکې له دې چې ورته اړتیا ولرئ ولیکئ: کوم د اجازه لړلیک ننوت، نومول شوی اعتبار یا وتلې اړیکه مو بدله کړه، څوک یې مالک دی او پخوانی ارزښت څنګه بحال کړئ. بیا په ټیکټ کې ورېځ غوښتونکی او د خدمت بشپړه لاره نوموئ او حلقه بنده کړئ، ترڅو څوک هماغه موضوع بیا د VPN ستونزې په توګه نه پرانیزي.