Loading

Marketing Cloud – Aktualisieren von SOAP-API-Integrationen zum Verwenden der Endpunkte Ihres Mandanten

Veröffentlichungsdatum: Jul 6, 2022
Beschreibung

Was passiert?

Salesforce wird von Grund auf erstellt, um Ihre Daten und Anwendungen zu schützen. Da uns die Sicherheit und das Vertrauen unserer Kunden besonders wichtig sind, ist für Integrationen in Marketing Cloud nun ab spätestens 31. August 2022 die Verwendung mandandenspezifischer Endpunkte obligatorisch.
 

Was ist ein mandantenspezifischer Endpunkt?

Von Marketing Cloud wird jedem einzelnen Mandanten automatisch eine eindeutige, vom System generierte Unterdomäne zugewiesen. Ein Mandant ist Ihr Enterprise-Account auf oberster Ebene sowie seine Business Units, Ihr Kernaccount, Ihr Agenturaccount auf oberster Ebene oder Ihr Kundenaccount. Dies ist abhängig von Ihrem Mandantentyp. Ihre Unterdomäne wird durch eine Zeichenfolge aus 28 Zeichen dargestellt, die mit den Buchstaben "mc" beginnt. Wird Ihre Unterdomäne an Marketing Cloud-APIs angehängt, werden mandantenspezifische Endpunkte erstellt.
 

Wer ist betroffen?

Kunden, die Email Studio, Mobile Studio, Automation Studio oder Audience Builder verwenden und SOAP-API-Anforderungen ausführen, könnten betroffen sein.
 

Wie kann ich bestimmen, ob meine SOAP-API-Integrationen aktualisiert werden müssen?

Ihre SOAP-API-Integrationen müssen aktualisiert werden, wenn einer der folgenden Endpunkte verwendet wird:
  • 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

Wo erhalte ich zusätzliche Informationen?

Informationen zu Aktualisierungen, Fragen und Ressourcen finden Sie in der Gruppe zu den Marketing Cloud-API-Endpunkt-Aktualisierungen in der Salesforce Trailblazer Community. 

Lösung

Wo finde ich die SOAP-API-Endpunkte meines Mandanten?

  1. Sie finden den SOAP-API-URI Ihres Mandanten in Installierte Pakete unter "Setup" > "Plattform-Tools" > "Apps" > "Installierte Pakete". In "Installierte Pakete" müssen Sie:
    1. Zum Erstellen des SOAP-WSDL-Endpunkts Ihres Mandanten Folgendes anhängen: /etframework.wsdl
    2. Zum Erstellen des SOAP-Service-Endpunkts Ihres Mandanten Folgendes anhängen: /Service.asmx
  2. Den SOAP-WSDL- und SOAP-Service-Endpunkt Ihres Mandanten finden Sie zudem unter "Setup" > "Unternehmenseinstellungen" > "Accounteinstellungen".
  3. Zusätzlich können Sie zu "Cloudpräferenzen" > "Benutzereinstellungen" navigieren und nach dem SOAP-WSDL-URL und SOAP-Service-Endpunkt Ihres Mandanten suchen, wenn "Ja" für "API-Benutzer" festgelegt ist.
 

Wie aktualisiere ich meinen SOAP-WSDL- und -Service-Endpunkt?

Aktualisieren Sie nach dem Ermitteln des SOAP-WSDL- und -Service-Endpunkts Ihres Mandanten Ihre Marketing Cloud-Integrationen. Ersetzen Sie dazu vorhandene Endpunkte durch den entsprechenden Mandantenendpunkt.

Beispiel einer Anforderung mit einem aktualisierten mandantenspezifischen Service-Endpunkt

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>
 

 

Nummer des Knowledge-Artikels

000392834

 
Laden
Salesforce Help | Article