Apex ඇමතුම් ඔබේ VPN එකෙන් නොව Salesforce එකෙන් පිටවේ
ලැප්ටොප් 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 එක බ්‍රවුසරයේ පූරණය කරන උමං මාර්ගයකට ඒකාබද්ධතාව පෙර තිබූ එම කාල සීමාවෙන්ම අසාර්ථක කර තැබිය හැකිය. යමෙකු ගිනිපවුරක් සංස්කරණය කිරීමට පෙර එම වැරැද්ද නතර කිරීමට ඇමතුම්කරු කාඩ්පත ඇත.
ඇමතුම්කරුට සැබවින්ම භාවිත කළ හැකි පිවිසුම තෝරන්න
දෙකම ව්‍යුහයන් නීත්‍යානුකූලය, ඒවා වෙනස් ගැටලු විසඳයි. පළමුවැන්න හිතාමතා සාදන ලද පොදු පිවිසුමකි: ඇමතුම්කරු සත්‍යාපනය කරන, පටු අවසර යොදන, පුද්ගලික backend එකට ආරක්ෂිත සම්බන්ධතාවක් තබා ගන්නා HTTPS API ද්වාරයක් හෝ ඒකාබද්ධතා සේවාවක්. මෙය සෑම 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 ගැටලුවක් ලෙස නොවිවෘත කරයි.