Uppdatera Marketing Cloud-slutpunkter till klientspecifika slutpunkter: Vanliga frågor och svar

Marketing Cloud har börjat ett program för att alla kunder ska uppdatera sina REST-, Auth-, SOAP-, SSO-, SFTP- och enhets-slutpunkter från äldre stackspecifik slutpunktsarkitektur och ersätta den med Klientspecifika slutpunkter (Tenant Specific Endpoints = TSE). Denna ändring påverkar alla Marketing Cloud-kunder som använder äldre API:er och andra slutpunkter.

Som en del av vårt pågående engagemang för kundförtroende och säkerhet måste integrationer i Marketing Cloud nu använda klientspecifika slutpunkter senast den 31 augusti 2022.

Dessutom kan den här aktuella listan över påverkade slutpunkter uppdateras i framtiden när vi fortsätter att förbättra Marketing Cloud-arkitekturen.

Dessa uppdateringar påverkar inte kunder som för närvarande har all sin API-trafik på de TSE-aktiverade rutterna.

Vad är klientspecifika slutpunkter?

Klientspecifika slutpunkter, också kända som Klientspecifika underdomäner, introducerades i Marketing Cloud som en del av lanseringen från oktober 2018, samtidigt som EU stack (S50) lanserades. Målet med TSE-arkitekturen är att ge våra kunder förbättrad säkerhet, tillförlitlighet, tillgänglighet och prestanda.

Äldre stackspecifika slutpunkter utnyttjar en nätreplikationsarkitektur som flyttar en inkommande begäran från en stack till en annan tills begäran hamnar i rätt stack. Däremot dirigerar TSE direkt den inkommande begäran till den klientspecifika stacken, vilket är mycket säkrare och effektivare än att flytta en begäran mellan stackar tills den träffar rätt. TSE gör detta genom att ge varje klient en unik identifierare för sina API-slutpunkter, som också identifierar den stack som klienten är värd för.

Nedan följer några exempel på skillnaderna mellan stackspecifika slutpunkter och TSE:

Slutpunkt	Stack-Specifik	TSE
API Auth	auth.exacttargetapis.com	mc123.auth.marketingcloudapis.com
REST API	www.exacttargetapis.com	mc123.rest.marketingcloudapis.com
Enhets API	consumer.exacttargetapis.com	mc123.device.marketingcloudapis.com
SOAP API	webservice.s7.exacttarget.com	mc123.soap.marketingcloudapis.com

Vilka slutpunkter behöver uppdateras?

SOAP:

https://webservice.exacttarget.com
https://webservice.s4.exacttarget.com
https://webservice.s6.exacttarget.com
https://webservice.s7.exacttarget.com
https://webservice.s10.exacttarget.com
https://webservice-auth.exacttarget.com
https://webservice-sha2.exacttarget.com
https://webservice-test.exacttarget.com
https://webservice-tls.exacttarget.com

REST/Auth:

https://auth.exacttargetapis.com
https://www.exacttargetapis.com
https://auth-s1.exacttargetapis.com
https://auth-s4.exacttargetapis.com
https://auth-s6.exacttargetapis.com
https://auth-s7.exacttargetapis.com
https://auth-s10.exacttargetapis.com

SSO:

auth.s1.exacttarget.com
mc.login.exacttarget.com

SFTP:

sftp://ftp1.exacttarget.com
sftp://ftp.s4.exacttarget.com
sftp://ftp.s6.exacttarget.com
sftp://ftp.s7.exacttarget.com
sftp://ftp.s10.exacttarget.com
sftp://ftp.s11.exacttarget.com
sftp://ftp.s50.exacttarget.com
Alla SFTP-integrationer som använder en hårdkodad, specifik IP-adress

MobilePush SDK:

Om din applikation använder följande MobilePush SDK-versioner måste den uppdateras. Följande versioner av SDK använder inte klientspecifika slutpunkter och är hårdkodade för att använda "äldre" device.exacttargetapis.com-slutpunkt:

- iOS 6.1.4 eller äldre
- Android 6.1.0 eller äldre

Om din applikation använder följande MobilePush SDK-versioner, vänligen bekräfta att ditt utvecklingsteam har konfigurerat SDK för att använda appens klientspecifika slutpunkt. Om du använder dessa versioner av SDK och du har bekräftat att din app har konfigurerat SDK för att använda din apps klientspecifika slutpunkt, krävs ingen ytterligare åtgärd.
1. iOS 6.0.0
2. Android 6.0.2
3. Obs! Medan ovanstående representerar minsta versioner av MobilePush SDK för att stödja klientspecifika slutpunkter, rekommenderar vi alltid best practice för att uppdatera din app till den senaste versionen av SDK.

Varför upphör vi med dessa slutpunkter?

På Salesforce är Förtroende vårt #1 värde när vi betjänar våra kunder. Vi behöver uppdatera de äldre stackspecifika slutpunkterna med TSE för att förbättra säkerhet, tillförlitlighet, tillgänglighet och prestanda.

Varför är TSE bättre än de äldre slutpunkterna?

Som nämnts tidigare förbättrar TSE den totala tillförlitligheten, tillgängligheten och prestandan för Marketing Cloud-tjänster genom att undvika studsande förfrågningar mellan stackar.

Nedan följer några av de målinriktade fördelarna som TSE erbjuder:

Förbättrad säkerhetsställning
Varje kund som använder sin egen slutpunkt ger oss en högre säkerhetsnivå och gör det lättare för oss att hantera uppdaterade säkerhetselement, till exempel certifikat.

Sänker latens vid routing av kundförfrågningar
TSE hjälper till att dirigera kundförfrågningar direkt till sin stack, vilket minimerar global replikering och studsande förfrågningar mellan stackar.

Förbättrar katastrofåterställning
I händelse av ett serviceavbrott kan TSE-enbart stackar förbättra återhämtningstiden genom att isolera effekten av reparationerna till endast de specifika stackarna som hade avbrottet.

Minimerar prestandafrågor, förbättrar drifttiden
Oavsett om det är en kund som använder frekventa token-förfrågningar, obegränsade försök igen, eller om det finns ett problem med en stack eller med en pool av maskiner, kan TSE minimera påverkan till en begränsad grupp kunder istället för att orsaka ett globalt avbrott.

Hur vet jag om jag använder TSE eller äldre slutpunkter?

Som nämnts ovan har de äldre slutpunkterna en annan nomenklatur än TSE slutpunkterna. De gamla legacy slutpunkter kan ha en stackbeteckning som en del av slutpunkten, till exempel “s4” i detta REST/Auth exempel:

https://auth-s4.exacttargetapis.com

I vissa fall kanske de inte har stackbeteckningen, som i detta exempel:

https://auth.exacttargetapis.com/

Den klientspecifika slutpunktversionen har dock alltid ett klient-ID som en del av webbadressen, som den här:

mc563885gzs27c5t9-63k636ttgm.rest.marketingcloudapis.com

Jag måste uppdatera mina slutpunkter. Vart går jag för att hitta information om vad jag behöver göra?

Nedan finns länkar till Knowledge-artiklar som hjälper dig att uppdatera dina relevanta slutpunkter:

Jag vet inte vilka slutpunkter jag behöver ändra eller var de är. Vad ska man göra?

Om du har frågor efter att ha granskat Knowledge-artiklarna som anges ovan, skapa ett supportärende via hjälp- och utbildningsportalen.