Обновление конечных точек Marketing Cloud на клиентские конечные точки: вопросы и ответы

Программа, запущенная Marketing Cloud, предусматривает обновление всеми клиентами устаревших стековых конечных точек REST, проверки подлинности, SOAP, единой регистрации, SFTP и устройства, а также их замену на клиентские конечные точки. Данное изменение повлияет на всех клиентов Marketing Cloud, которые используют устаревшие интерфейсы API и другие конечные точки.

В рамках постоянно действующего обязательства по повышению доверия и безопасности клиентов, теперь интеграции с Marketing Cloud требуются для использования клиентских конечных точек не позднее 31 августа 2022 года.

Кроме того, данный текущий список подверженных изменению конечных точек может быть обновлен в будущем по мере улучшения архитектуры Marketing Cloud.

Данные обновления не повлияют на клиентов, весь трафик API которых сейчас приходится на маршруты с поддержкой клиентских конечных точек.

Что такое клиентские конечные точки?

Клиентские конечные точки (также известные как клиентские субдомены) появились в Marketing Cloud в октябре 2018 года одновременно с запуском стека EU (S50). Цель архитектуры клиентских конечных точек заключается в предоставлении клиентам повышенной безопасности, надежности услуг, доступности и производительности.

Устаревшие стековые конечные точки используют архитектуру сетчатой репликации, которая пересылает входящий запрос от одного стека к другому до момента попадания запроса в нужный стек. А, клиентские конечные точки направляют входящий запрос прямо в клиентский стек, что более безопасно и эффективно, чем пересылка запроса между стеками до момента его попадания в нужный стек. С этой целью клиентские конечные точки предоставляют каждому клиенту уникальный идентификатор для конечных точек API, который также определяет стек, используемый для размещения данного клиента.

Примеры различий между стековыми и клиентскими конечными точками см. ниже.

Конечная точка	Стековая	Клиентская конечная точка
Проверка подлинности API	auth.exacttargetapis.com	mc123.auth.marketingcloudapis.com
REST API	www.exacttargetapis.com	mc123.rest.marketingcloudapis.com
API устройства	consumer.exacttargetapis.com	mc123.device.marketingcloudapis.com
SOAP API	webservice.s7.exacttarget.com	mc123.soap.marketingcloudapis.com

Какие конечные точки должны быть обновлены?

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/проверка подлинности:

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

Единая регистрация:

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
Любая интеграция SFTP, использующая конкретный жестко запрограммированный IP-адрес

MobilePush SDK:

Если приложение использует указанные ниже версии MobilePush SDK, то оно должно быть обновлено. Следующие версии SDK не используют клиентские конечные точки и являются жестко запрограммированными на использование устаревшей конечной точки device.exacttargetapis.com:

- iOS 6.1.4 или более поздней версии
- Android 6.1.0 или более поздней версии

Если приложение использует указанные ниже версии MobilePush SDK, убедитесь, что настройки SDK, выполненные группой разработчиков, позволяют использовать клиентскую конечную точку приложения. При использовании следующих версий SDK и подтверждении возможности использования клиентской конечной точки приложения дальнейшие действия не требуются:
1. iOS 6.0.0
2. Android 6.0.2
3. Примечание. Указанные выше версии MobilePush SDK являются минимальными для поддержки клиентских конечных точек, поэтому компания Salesforce всегда рекомендует обновлять приложение до последней версии SDK.

Почему прекращается поддержка данных конечных точек?

Компания Salesforce уделяет особое внимание вопросу доверия при обслуживании своих клиентов. Обновление устаревших стековых конечных точек на клиентские конечные точки позволяет повысить безопасность, надежность услуг, доступность и производительность.

Почему клиентские конечные точки лучше устаревших конечных точек?

Как указано выше, клиентская конечная точка повышает общую надежность, доступность и производительность служб Marketing Cloud путем предотвращения пересылки запросов между стеками.

Ниже перечислены некоторые преимущества клиентских конечных точек.

Повышенная безопасность
Каждый клиент, использующий собственную конечную точку, является более безопасным и удобным для управления обновлениями элементов системы безопасности (например, сертификаты).

Уменьшение задержки при маршрутизации запросов клиентов
Клиентские конечные точки помогают направлять запросы клиентов прямо в стек, минимизируя глобальную репликацию и пересылку запросов между стеками.

Улучшение аварийного восстановления
При сбое службы стеки, поддерживающие только клиентские конечные точки, могут сократить время восстановления путем ограничения последствий ремонтных работ только проблемными стеками.

Сокращение проблем производительности, увеличение времени работы
Независимо от типа проблемы, клиентская конечная точка может минимизировать глобальный сбой до проблемы, последствия которой затрагивают только конкретную группу клиентов.

Как определить, используются ли клиентские или устаревшие конечные точки?

Как указано выше, клиентские и устаревшие конечные точки используют разную номенклатуру. Устаревшие конечные точки могут содержать обозначение стека как часть конечной точки (например, "s4" в примере ниже).

https://auth-s4.exacttargetapis.com

В некоторых случаях обозначение стека может отсутствовать. См. пример ниже.

https://auth.exacttargetapis.com/

Тогда как, клиентская конечная точка всегда содержит код клиента как часть URL-адреса. См. пример ниже.

mc563885gzs27c5t9-63k636ttgm.rest.marketingcloudapis.com

Мне необходимо обновить конечные точки. Где можно получить более подробную информацию о рекомендуемых действиях?

Ниже перечислены ссылки на статьи Knowledge, которые содержат рекомендации по обновлению важных конечных точек.

Мне неизвестно, какие конечные точки следует изменить, или где они находятся. Что необходимо сделать?

При возникновении дополнительных вопросов после просмотра указанных выше статей Knowledge создайте обращение по поддержке посредством портала "Справка и обучение".