Loading

Marketing Cloud: обновление интеграций SOAP API для использования конечных точек клиента

Дата публикации: Jul 6, 2022
Описание

Что изменилось?

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

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

Marketing Cloud автоматически назначает каждому клиенту уникальный созданный системой субдомен. В зависимости от типа клиента, под клиентом понимается корпоративный аккаунт верхнего уровня и его бизнес-единицы, базовый аккаунт, агентский аккаунт верхнего уровня или клиентский аккаунт. Субдомен представляет собой 28-значную строку, начинающуюся с букв "mc". При добавлении субдомена к интерфейсам Marketing Cloud API создаются конечные точки, являющиеся уникальными для клиента.
 

Кого затрагивает данное изменение?

Данное изменение может повлиять на клиентов, использующих Email Studio, Mobile Studio, Automation Studio или Audience Builder и выполняющих запросы SOAP API.
 

Как определить, требуется ли обновление интеграций SOAP API?

Интеграции SOAP API должны быть обновлены при использовании одной из конечных точек ниже.
  • 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

Где можно получить дополнительную информацию?

Для получения обновлений, публикации вопросов и просмотра ресурсов воспользуйтесь группой Marketing Cloud API Endpoint Updates в Salesforce Trailblazer Community. 

Решение

Где можно найти конечные точки SOAP API клиента?

  1. URI интерфейса SOAP API клиента может быть найден на странице "Установленные пакеты" путем последовательного выбора пунктов "Настройка" > "Инструменты платформы" > "Приложения" > "Установленные пакеты". На странице "Установленные пакеты" выполните указанные ниже действия.
    1. Чтобы создать конечную точку SOAP WSDL клиента, добавьте: /etframework.wsdl.
    2. Чтобы создать конечную точку службы SOAP клиента, добавьте: /Service.asmx.
  2. Конечная точка службы SOAP и SOAP WSDL клиента может быть также найдена путем последовательного выбора пунктов "Настройка" > "Параметры компании" > "Параметры организации".
  3. Кроме того, если пользователю API задано значение "Да", то URL-адрес SOAP WSDL и конечная точка службы SOAP клиента могут быть найдены путем последовательного выбора пунктов "Настройки облака" > "Параметры пользователя".
 

Как обновить конечную точку службы и SOAP WSDL?

После обнаружения конечной точки службы и SOAP WSDL клиента обновите интеграции Marketing Cloud путем замены любых существующих конечных точек на соответствующую конечную точку клиента.

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

POST /Service.asmx HTTP/1.1
Host: mclf6n1asf8FAKEwy4p4r86k0b31.soap.marketingcloudapis.com

Content-Type: text/xml
Cache-Control: no-cache

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/08/addressing" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
<soap:Header>
<wsa:Action>GetSystemStatus</wsa:Action>
<wsa:To>https://mclf6n1asf8FAKEwy4p4r86k0b31.soap.marketingcloudapis.com/Service.asmx</wsa:To>
<wsse:Security soap:mustUnderstand="1">
<wsse:UsernameToken
xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" wsu:Id="SecurityToken-db1066a9-acf1-4f1b-a455-12e721913742">
<wsse:Username>XXXX</wsse:Username>
<wsse:Password
Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">XXXX</wsse:Password>
</wsse:UsernameToken>
</wsse:Security>
</soap:Header>
<soap:Body>
<SystemStatusRequestMsg xmlns="http://exacttarget.com/wsdl/partnerAPI" />
</soap:Body>
</soap:Envelope>
 

 

Номер статьи базы знаний

000392834

 
Загрузка
Salesforce Help | Article