Apex-köll fara frá Salesforce, ekki frá VPN-inu þínu
VPN á fartölvu gefur vafranum þínum slóð, ekki Apex eða Marketing Cloud. Paraðu raunverulega kallandann við opinbera gátt eða hæfa einkatengingu.
Einkaaðgangs-API-ið svarar í vafranum þínum um leið og fartölvan tengist VPN-inu, svo samþættingin ætti að virka. Hún virkar ekki, því kóðinn sem gerir kallið keyrir allt annars staðar. Apex keyrir á forritamiðlurum Salesforce, og miðlarahliðarstarfsemi í Marketing Cloud keyrir í keyrsluumhverfi þeirrar vöru. Hvorugt erfir göng fartölvunnar þinnar. Farðu að þessu sem stuttri aðferð: greindu kallandann, veldu inngang sem sá kallandi kemst að, tengdu slóðina frá enda til enda og staðfestu síðan úr keyrsluumhverfinu sjálfu.
Skrifaðu kallandaspjaldið áður en nokkuð er breytt í netinu
Fylltu út fimm svæði og neitaðu að giska á nokkurt þeirra. Keyrsluvara og samhengi ráða öllu sem á eftir kemur, svo byrjaðu þar en ekki á eldvegg miðlarans.
| 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? |
Vafraflipi og Apex-kall eru tveir mismunandi biðlar, og virkandi vafri sannar aðeins að slóð sé til frá skrifborðinu þínu. Ef keyrsluumhverfissvæðið segir Apex er viðeigandi spurning frá hvaða vistföngum Salesforce fer út, ekki hvaða vistföng fartölvan þín hefur. Þess vegna getur göng sem láta API-ið hlaðast í vafra látið samþættinguna mistakast með sama tímanum og áður. Kallandaspjaldið er til að stöðva þessi mistök áður en einhver breytir eldvegg.
Veldu innganginn sem kallandinn getur raunverulega notað
Báðar hannanir eru lögmætar og leysa mismunandi vandamál. Sú fyrri er viljandi opinber inngangur: HTTPS API-gátt eða samþættingarþjónusta sem auðkennir kallandann, beitir þröngum heimildum og heldur varðri tengingu við einkabakendann. Það er ekki það sama og að afhjúpa hverja bakendaþjónustu eða senda stjórnport út á internetið.
Sú seinni er hæf einkatenging. Skjöl Salesforce um útleið Private Connect lýsa leiðsögn studdra kalla í gegnum Outbound Network Connection sem er bundin nafngreindu auðkenni, yfir skilgreinda AWS PrivateLink-fyrirkomulagið. Eiginleikinn hefur takmarkanir á útgáfu, leyfi og vöru, svo staðfestu að samtökin uppfylli skilyrðin áður en þú hannar í kringum hann.
Hvorug hönnunin er OpenVPN-biðlari uppsettur inni í Salesforce, og eldri fullyrðingin um að hver samþætting verði að ná opinberum bakenda er of víðtæk þar sem studd einkatenging hentar. Veldu það sem keyrsluumhverfið styður og kláraðu síðan slóðina að raunverulega API-inu: AWS-endapunktur þekkir ekki staðbundna auðlindina þína og erfir ekki leið fartölvunnar þinnar. DNS, leiðsögn bakenda, aðgangstefna og svarumferð verða öll að fylgja þeirri arkitektúr sem þú valdir. Hálfbyggð einkaslóð mistekst á þann hátt að það lítur nákvæmlega út eins og auðkenningarvandamál.
Tengdu einkaslóðina frá enda til enda
Vinndu út frá API-inu og stansuðu við fyrstu eyðu. Staðfestu að bakendinn svari á staðnum, svo að einkendapunkturinn nái til hans, og svo að nafngreinda auðkennið og útleiðartenging þess miði á þann endapunkt.
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 integrationFyrsta skipunin sannar að bakendinn sé heilbrigður innan úr einkanetinu, sú önnur sýnir hvað nafnið leysist í, og sú þriðja keyrir kall úr raunverulegu Salesforce-keyrsluumhverfinu. 200 frá þeirri fyrstu og mistök frá þeirri þriðju einangra eyðuna við slóðina eða auðkennið frekar en þjónustuna.
Hafðu umfang auðkenna nákvæmt meðan þú tengir. Nafngreint auðkenni lagar ekki óaðgengilegan endapunkt eitt og sér, því auðkennið og einkatengingin eru skyld stillingar með aðskilin verkefni. IP-heimildalisti þrengir að netaðgangi og er ekki API-auðkenni, svo haltu venjulegri TLS-staðfestingu og eigin auðkenningar- og snúningsferli þjónustunnar. Ef próf tekst aðeins eftir að þú slökktir á skírteinisathugun hefur þú fundið hýsilnafnavandamál en ekki slóðarvandamál, og skírteinið verður samt að passa.
Staðfestu úr keyrsluumhverfinu og skráðu síðan afturköllunina
Samþykktu skaðlaust leyft beiðni úr keyrsluumhverfi samþættingarinnar, ekki af vélinni þinni. Skráðu séða uppsprettu móttökurþjónustunnar, auðkennda aðilann, niðurstöðuna og eina vísvitandi synjaða beiðni sem verður að mistakast.
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/pingKeyrðu sömu tvær prófanir frá eigin neti bakendans svo hægt sé að bera séða uppsprettu saman við það sem keyrsluumhverfið framleiddi. 200 og svo 401 eða 403 er lögunin sem þú vilt; tvö 200 þýða að synjunarslóðin er ekki í raun framfylgd.
Skrifaðu afturköllunina áður en þú þarft á henni að halda: hvaða heimildalistafærslu, nafngreint auðkenni eða útleiðartengingu þú breyttir, hver á hana og hvernig á að endurheimta fyrra gildi. Lokaðu síðan hringnum með því að nefna skýjakallandann og fulla þjónustuslóð í miðanum, svo enginn opni sama málið aftur sem VPN-vandamál.