Aggiornamento degli endpoint Marketing Cloud a endpoint specifici del tenant: Domande frequenti

Marketing Cloud ha avviato un programma per l'aggiornamento degli endpoint REST, Auth, SOAP, SSO, SFTP e di dispositivo di tutti i clienti dall'architettura legacy degli endpoint specifici dello stack agli endpoint specifici del tenant (TSE, Tenant Specific Endpoint). Questa modifica interesserà tutti i clienti Marketing Cloud che utilizzano API legacy e altri endpoint.

Nell'ambito del nostro costante impegno per garantire affidabilità e sicurezza ai clienti, le integrazioni in Marketing Cloud dovranno utilizzare gli endpoint specifici del tenant entro il 31 agosto 2022.

Inoltre, l'elenco attuale degli endpoint interessati potrebbe essere aggiornato in futuro, di pari passo con il costante miglioramento dell'architettura di Marketing Cloud.

Questi aggiornamenti non interesseranno i clienti il cui traffico API attualmente utilizza instradamenti abilitati per TSE.

Che cosa sono gli endpoint specifici del tenant?

Gli endpoint specifici del tenant, detti anche sottodomini specifici del tenant, sono stati introdotti in Marketing Cloud nell'ambito del rilascio di ottobre 2018, contemporaneamente al lancio dello stack EU (S50). L'obiettivo dell'architettura TSE è di fornire ai clienti maggiore sicurezza e affidabilità dei servizi, nonché disponibilità e prestazioni ancora migliori.

L'architettura legacy degli endpoint specifici dello stack sfrutta un'architettura di replica mesh nella quale una richiesta in ingresso viene rimbalzata da uno stack all'altro finché non arriva allo stack corretto. I TSE, invece, instradano direttamente le richieste in ingresso allo stack specifico del cliente, garantendo protezione ed efficienza maggiori rispetto al bounce delle richieste da uno stack all'altro appena descritto. I TSE assegnano a ciascun tenant un identificatore univoco per i rispettivi endpoint API. Tale identificatore caratterizza anche lo stack su cui il tenant è ospitato.

Di seguito sono riportati alcuni esempi delle differenze tra endpoint specifici dello stack e TSE:

Endpoint	Specifico dello stack	TSE
API Auth	auth.exacttargetapis.com	mc123.auth.marketingcloudapis.com
API REST	www.exacttargetapis.com	mc123.rest.marketingcloudapis.com
API dispositivo	consumer.exacttargetapis.com	mc123.device.marketingcloudapis.com
API SOAP	webservice.s7.exacttarget.com	mc123.soap.marketingcloudapis.com

Quali endpoint devono essere aggiornati?

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
Qualsiasi integrazione SFTP che utilizzi un indirizzo IP specifico hardcoded

SDK MobilePush:

Se l'applicazione in uso utilizza le seguenti versioni dell'SDK MobilePush, deve essere aggiornata. Le seguenti versioni dell'SDK non utilizzano endpoint specifici del tenant e sono codificate per utilizzare l'endpoint legacy device.exacttargetapis.com:

- iOS 6.1.4 o precedenti
- Android 6.1.0 o precedenti

Se l'applicazione in uso utilizza le seguenti versioni dell'SDK MobilePush, verificare che il team di sviluppo dell'organizzazione abbia configurato l'SDK per l'impiego dell'endpoint specifico del tenant. Se si utilizzano queste versioni dell'SDK e si è verificato che per l'applicazione in uso l'SDK è configurato per l'impiego dell'endpoint specifico del tenant, non sono necessarie ulteriori azioni.
1. iOS 6.0.0
2. Android 6.0.2
3. Nota: quelle indicate in precedenza sono le versioni minime dell'SDK MobilePush in grado di supportare gli endpoint specifici del tenant. È sempre consigliabile, tuttavia, seguire la best practice di aggiornare l'app con la versione più recente dell'SDK.

Perché questi endpoint verranno ritirati?

Per noi di Salesforce la fiducia è al primo posto. È necessario aggiornare gli endpoint legacy specifici dello stack con gli endpoint TSE per migliorare la sicurezza, l'affidabilità dei servizi, la disponibilità e le prestazioni.

Perché i TSE sono migliori degli endpoint legacy?

Come indicato in precedenza, l'architettura TSE aumenta complessivamente l'affidabilità, la disponibilità e le prestazioni dei servizi Marketing Cloud evitando il bounce delle richieste da uno stack all'altro.

Ecco alcuni dei vantaggi mirati offerti dagli endpoint TSE:

Ottimizzazione del piano di sicurezza complessivo
L'uso di un proprio endpoint da parte di ciascun cliente ci garantisce un livello più elevato di sicurezza e semplifica per noi la gestione dell'aggiornamento degli elementi di sicurezza, ad esempio dei certificati.

Riduzione della latenza nell'instradamento delle richieste dei clienti
I TSE consentono di instradare le richieste dei clienti direttamente nel loro stack, riducendo al minimo la replica globale e il bounce delle richieste tra i vari stack.

Maggiore efficienza del ripristino di emergenza
In caso di interruzione del servizio, gli stack solo TSE consentono di migliorare i tempi di ripristino limitando l'impatto delle riparazioni ai soli stack interessati dall'interruzione.

Riduzione al minimo dei problemi di prestazioni e aumento del tempo di attività
Sia che un cliente invii frequenti richieste di token o un numero illimitato di tentativi, o che si verifichi un problema con uno stack o un pool di computer, l'architettura TSE è in grado di limitare l'impatto a un insieme specifico di clienti anziché causare un'interruzione globale.

Come faccio a sapere se sto utilizzando TSE o endpoint legacy?

Come indicato in precedenza, per gli endpoint TSE è utilizzata una nomenclatura diversa rispetto agli endpoint legacy. I vecchi endpoint legacy possono contenere la designazione di uno stack, come "s4" in questo esempio REST/Auth:

https://auth-s4.exacttargetapis.com

In alcuni casi, potrebbero non contenere tale designazione, come in questo esempio:

https://auth.exacttargetapis.com/

Tuttavia, la versione specifica del tenant include sempre l'ID del tenant all'interno dell'URL, ad esempio:

mc563885gzs27c5t9-63k636ttgm.rest.marketingcloudapis.com

Se devo aggiornare gli endpoint, dove posso trovare le informazioni sulle operazioni da eseguire?

Di seguito sono riportati i collegamenti ad alcuni articoli della Knowledge Base con le indicazioni su come aggiornare i propri endpoint:

Se non so quali sono o dove si trovano gli endpoint da modificare, cosa devo fare?

In caso di dubbi anche dopo la lettura degli articoli della Knowledge Base sopra indicati, creare un caso di assistenza tramite il portale Assistenza & formazione.