Tagann glaonna Apex ó Salesforce, ní ó do VPN
Tugann VPN ar an ríomhaire glúine cosán do do bhrabhsálaí, ní do Apex ná do Marketing Cloud. Meaitseáil an fíor-ghlaoiteoir le geata poiblí nó le nasc príobháideach cáilithe.
Freagraíonn an API príobháideach i do bhrabhsálaí an nóiméad a théann an ríomhaire glúine isteach sa VPN, mar sin ba cheart don chomhtháthú oibriú. Ní oibríonn sé, mar ritheann an cód a dhéanann an ghlao áit iomlán eile. Ritheann Apex ar fhreastalaithe feidhmchláir Salesforce, agus ritheann gníomhaíocht taobh an fhreastalaí i Marketing Cloud i runtime an táirge sin. Ní fhaigheann ceachtar acu tollán do ríomhaire glúine le hoidhreacht. Déan é seo mar ghnás gairid: aithin an glaóiteoir, roghnaigh bealach isteach ar féidir leis an nglaóiteoir sin rochtain a fháil air, sreangaigh an cosán ó cheann go ceann, agus ansin fíoraigh ón runtime féin.
Scríobh cárta an ghlaoiteora sula ndéantar aon athrú líonra
Líon cúig réimse agus diúltaigh aon cheann acu a thomhas. Cinneann an táirge forghníomhaithe agus an comhthéacs gach rud ina dhiaidh, mar sin tosaigh ansin seachas ag balla dóiteáin an fhreastalaí.
| 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? |
Is dhá chliant éagsúla iad cluaisín brabhsálaí agus glao Apex, agus ní chruthaíonn brabhsálaí atá ag obair ach go bhfuil cosán ann ó do dheasc. Má deir réimse an runtime Apex, is í an cheist ábhartha ó cén seoladh a thagann Salesforce amach, ní cé na seoltaí atá ar do ríomhaire glúine. Sin é an fáth gur féidir le tollán a lódálann an API i mbrabhsálaí an comhtháthú a fhágáil ag teip leis an am istigh céanna a bhí ann roimhe. Tá cárta an ghlaoiteora ann chun an botún sin a stopadh sula ndéanann duine ar bith balla dóiteáin a chur in eagar.
Roghnaigh an bealach isteach is féidir leis an nglaóiteoir a úsáid i ndáiríre
Tá an dá dhearadh dlisteanach, agus réitíonn siad fadhbanna éagsúla. Is é an chéad cheann bealach isteach poiblí d’aon ghnó: geata API HTTPS nó seirbhís chomhtháthaithe a fhíoraíonn an glaóiteoir, a chuireann ceadanna cúnga i bhfeidhm agus a choinníonn nasc cosanta leis an backend príobháideach. Ní hé sin an rud céanna le gach seirbhís backend a nochtadh nó port bainistíochta a atreorú chuig an idirlíon.
Is é an dara ceann nasc príobháideach cáilithe. Déanann doiciméadú Private Connect amach Salesforce cur síos ar ródú glaonna tacaithe trí Outbound Network Connection atá ceangailte le dintiúir ainmnithe, thar a shocrú sainithe AWS PrivateLink. Tá srianta eagráin, ceadúnais agus táirge ar an ngné, mar sin deimhnigh go gcáilíonn an eagraíocht sula ndéanann tú dearadh timpeall uirthi.
Ní cliant OpenVPN suiteáilte laistigh de Salesforce ceachtar den dá dhearadh, agus tá an seanmhaíomh go gcaithfidh gach comhtháthú backend poiblí a bhaint amach ró-leathan áit ar bith a n-oireann nasc príobháideach tacaithe. Roghnaigh an ceann a thacaíonn an runtime leis, ansin críochnaigh an cosán chuig an API fíor: ní bhíonn aithne ag deireadh AWS ar do acmhainn áitiúil agus ní fhaigheann sé ródú do ríomhaire glúine le hoidhreacht. Caithfidh DNS, ródú backend, beartas rochtana agus trácht freagartha go léir leanúint na hailtireachta a roghnaigh tú. Teipeann cosán príobháideach leath-thógtha ar bhealach a fhéachann go beacht cosúil le fadhb fhíordhachtaithe.
Sreangaigh an cosán príobháideach ó cheann go ceann
Oibrigh amach ón API agus stop ag an gcéad bhearna. Deimhnigh go bhfreagraíonn an backend go háitiúil, ansin go sroicheann an deireadh príobháideach é, agus ansin go bhfuil na dintiúir ainmnithe agus a nasc amach dírithe ar an deireadh sin.
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 integrationCruthaíonn an chéad ordú go bhfuil an backend sláintiúil ó thaobh istigh den líonra príobháideach, taispeánann an dara ceann cad chuige a réitítear an t-ainm, agus forghníomhaíonn an tríú ceann glao ó fhíor-runtime Salesforce. Déanann 200 ón gcéad cheann agus teip ón tríú ceann an bhearna a leithlisiú chuig an gcosán nó na dintiúir seachas chuig an tseirbhís.
Coinnigh scóip na féiniúlachta beacht agus tú ag sreangú. Ní dheisíonn dintiúir ainmnithe deireadh nach féidir a shroicheadh as a stuaim féin, mar is socruithe gaolmhara iad na dintiúir agus an nasc príobháideach a bhfuil jabanna ar leith acu. Cuimsíonn liosta cead IP an ligean isteach líonra agus ní dintiúir API é, mar sin coinnigh gnáth-bhailíochtú TLS agus próiseas fíordhachtaithe agus rothlaithe na seirbhíse féin. Má éiríonn le tástáil amháin tar éis duit an tseiceáil teastais a dhíchumasú, tá fadhb ainm ósta aimsithe agat seachas fadhb cosáin, agus caithfidh an teastas teacht le chéile fós.
Fíoraigh ón runtime, ansin taifead an t-aisiompú
Glac le hiarratas neamhurchóideach ceadaithe ó runtime an chomhtháthaithe, ní ó do mheaisín. Taifead foinse bhreathnaithe na seirbhíse a fhaigheann é, an príomhpháirtí fíordhachtaithe, an toradh agus iarratas amháin a diúltaíodh d’aon ghnó agus ar gá dó teip.
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/pingRith na dhá phromhadh céanna ó líonra an backend féin ionas gur féidir an fhoinse bhreathnaithe a chur i gcomparáid leis an méid a tháirg an runtime. Is é 200 agus 401 nó 403 ina dhiaidh an chruth atá uait; ciallaíonn dhá 200 nach gcuirtear an cosán diúltaithe i bhfeidhm i ndáiríre.
Scríobh an t-aisiompú sula mbeidh sé uait: cén iontráil liosta ceada, dintiúir ainmnithe nó nasc amach a d'athraigh tú, cé leis é, agus conas an luach roimhe a athchóiriú. Ansin dún an lúb trí ghlaoiteoir an néil agus cosán iomlán na seirbhíse a ainmniú sa ticéad, ionas nach n-osclóidh éinne an cheist chéanna arís mar fhadhb VPN.