Mise à jour des points de terminaison Marketing Cloud vers des points de terminaison spécifiques au locataire : Forum aux questions

Marketing Cloud a lancé un programme pour que tous les clients mettent à jour leurs points de terminaison d’appareil, REST, Auth, SOAP, SSO et SFTP à partir de l’architecture de point de terminaison spécifique à la pile hérité et qu'ils la remplacent par des points de terminaison spécifiques au locataire (Tenant Specific Endpoints ou TSE). Cette modification affectera tous les clients Marketing Cloud qui utilisent des API héritées et d’autres points de terminaison.

Dans le cadre de notre engagement permanent envers la confiance et la sécurité des clients, les intégrations dans Marketing Cloud seront désormais requises pour utiliser des points de terminaison spécifiques aux locataires d'ici le 31 août 2022.

De plus, il se peut que la liste actuelle des points de terminaison impactés soit mise à jour à l’avenir, à mesure que nous continuons à améliorer l’architecture Marketing Cloud.

Ces mises à jour n’affecteront pas les clients qui ont actuellement tout leur trafic API sur les routes activées par TSE.

Que sont les points de terminaison spécifiques au locataire (TSE) ?

Les points de terminaison spécifiques au locataire, également appelés Sous-domaines spécifiques au locataire, ont été introduits dans Marketing Cloud lors de la version d’octobre 2018, parallèlement au lancement de la pile EU (S50). L’objectif de l’architecture TSE est de fournir à nos clients une sécurité, une fiabilité de service, une disponibilité et des performances améliorées.

Les points de terminaison spécifiques à la pile hérités utilisent une architecture de réplication de maillage qui renvoie une demande entrante d’une pile à l’autre jusqu’à ce que la demande arrive dans la bonne pile. À l’inverse, les TSE acheminent directement la demande entrante vers la pile spécifique au client, ce qui est beaucoup plus sûr et efficace que de renvoyer une demande entre les piles jusqu’à ce qu’elle atteigne la bonne. Pour ce faire, les TSE donnent à chaque locataire un identifiant unique pour ses points de terminaison d'API, qui identifie également la pile sur laquelle ce locataire est hébergé.

Voici quelques exemples des différences entre les points de terminaison spécifiques à la pile et les TSE :

Point de terminaison	Spécifique à la pile	TSE
API Auth	auth.exacttargetapis.com	mc123.auth.marketingcloudapis.com
API REST	www.exacttargetapis.com	mc123.rest.marketingcloudapis.com
API d’appareil	consumer.exacttargetapis.com	mc123.device.marketingcloudapis.com
API SOAP	webservice.s7.exacttarget.com	mc123.soap.marketingcloudapis.com

Quels points de terminaison doivent être mis à jour ?

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
Toute intégration SFTP qui utilise une adresse IP spécifique codée en dur.

MobilePush SDK :

Si votre application utilise les versions MobilePush SDK suivantes, elle doit être mise à jour. Les versions suivantes du kit de développement logiciel n'utilisent pas les points de terminaison spécifiques au locataire et sont codées en dur pour utiliser le point de terminaison « hérité » device.exacttargetapis.com :

- iOS 6.1.4 ou versions antérieures
- Android 6.1.0 ou versions antérieures

Si votre application utilise les versions MobilePush SDK suivantes, confirmez avec votre équipe de développement que le kit de développement logiciel a été configuré pour utiliser le point de terminaison spécifique au locataire de votre application. Si vous utilisez ces versions du kit de développement logiciel et que vous avez confirmé que votre application a configuré le kit de développement logiciel pour utiliser le point de terminaison spécifique au locataire de votre application, aucune autre action n’est requise.
1. iOS 6.0.0
2. Android 6.0.2
3. Remarque : Bien que les considérations ci-dessus représentent les versions minimales de MobilePush SDK pour prendre en charge les points de terminaison spécifiques au locataire, nous recommandons toujours de mettre à jour votre application vers la dernière version du kit de développement logiciel.

Pourquoi retirons-nous ces points de terminaison ?

Chez Salesforce, la confiance est notre première valeur lorsque nous servons nos clients. Nous devons mettre à jour les points de terminaison spécifiques à la pile hérités avec des TSE pour améliorer la sécurité, la fiabilité du service, la disponibilité et la performance.

Pourquoi les TSE sont-ils mieux que les points de terminaison hérités ?

Comme indiqué ci-dessus, les TSE améliorent la fiabilité, la disponibilité et les performances des services Marketing Cloud en évitant le renvoi des demandes entre les piles.

Voici quelques-un des avantages ciblés offerts par les TSE :

Dispositif de sécurité amélioré
Chaque client utilisant son propre point de terminaison nous donne un niveau de sécurité plus élevé et nous aide à gérer les éléments de sécurité de mise à jour, tels que les certificats.

Réduction de la latence lors du routage des demandes des clients
Les TSE permettent d’acheminer les demandes des clients directement vers leur pile, en réduisant la réplication globale et en renvoyant les demandes entre les piles.

Amélioration de la reprise après sinistre
En cas de panne de service, les piles uniquement TSE peuvent améliorer le temps de récupération en isolant l’impact des réparations seulement sur les piles spécifiques qui ont subi une panne

Diminution des problèmes de performance, amélioration du temps de fonctionnement
Qu'il s’agisse d'un client qui utilise fréquemment des demandes de jeton ou des tentatives non limitées, ou d’un problème avec une pile ou un pool de machines, les TSE peuvent diminuer l’impact sur un ensemble spécifique de clients au lieu de provoquer une panne globale.

Comment savoir si j’utilise des TSE ou des points de terminaison hérités ?

Comme indiqué ci-dessus, les points de terminaison hérités ont une nomenclature différente de celle des TSE. Les anciens points de terminaison hérités peuvent avoir une désignation de pile dans le cadre du point de terminaison, comme « s4 » dans cet exemple REST/Auth :

https://auth-s4.exacttargetapis.com

Dans certains cas, ils peuvent ne pas avoir de désignation de pile, comme dans cet exemple :

https://auth.exacttargetapis.com/

Cependant, la version du point de terminaison spécifique au locataire aura toujours un ID de locataire dans l’URL, comme ici :

mc563885gzs27c5t9-63k636ttgm.rest.marketingcloudapis.com

Je dois mettre à jour mes points de terminaison. Où puis-je trouver des informations sur les mesures à prendre ?

Vous trouverez ci-dessous des liens vers les articles Knowledge qui vous guideront sur la façon de mettre à jour vos points de terminaison pertinents :

Je ne sais pas quels points de terminaison je dois modifier, ni où ils se trouvent. Quelle est la procédure à suivre ?

Si vous avez des questions après avoir lu les articles Knowledge répertoriés ci-dessus, créez une requête de support via le portail Aide et formation.