Aktualisieren von Marketing Cloud-Endpunkten auf mandantenspezifische Endpunkte: Häufig gestellte Fragen

Für Marketing Cloud wurde ein Programm gestartet, damit alle Kunden ihre REST-, Auth-, SOAP-, SSO-, SFTP- und Geräteendpunkte von ihrer veralteten Stack-spezifischen Endpunktarchitektur aktualisieren und durch mandantenspezifische Endpunkte ersetzen. Diese Änderung betrifft alle Marketing Cloud-Kunden, die veraltete APIs und andere Endpunkte verwenden.

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.

Zusätzlich kann diese aktuelle Liste der betroffenen Endpunkte künftig aktualisiert werden, da die Marketing Cloud-Architektur fortwährend verbessert wird.

Diese Aktualisierungen wirken sich nicht auf Kunden aus, deren gesamter API-Datenverkehr sich derzeit auf Routen befindet, die für mandantenspezifische Endpunkte aktiviert sind.

Was sind mandantenspezifische Endpunkte?

Mandantenspezifische Endpunkte, die auch als mandantenspezifische Unterdomänen bezeichnet werden, wurden in Marketing Cloud ihm Rahmen der Version von Oktober 2018 parallel mit dem EU-Stack-Start (S50) eingeführt. Die Architektur der mandantenspezifischen Endpunkte soll unseren Kunden eine verbesserte Sicherheit, Servicezuverlässigkeit, -verfügbarkeit und -leistung gewährleisten.

Veraltete Stack-spezifische Endpunkte nutzen eine Maschenabgleichsarchitektur, die eine eingehende Anforderung von einem Stack zum anderen schiebt, bis die Anforderung den richtigen Stack erreicht. Dagegen leiten mandantenspezifische Endpunkte die eingehende Anforderung direkt an den kundenspezifischen Stack. Dieser Ansatz ist wesentlich sicherer und effizienter als eine Anforderung zwischen den Stacks hin- und herzuschieben, bis der richtige erreicht wird. Dazu ordnen mandantenspezifische Endpunkte jedem Mandanten eine eindeutige Kennung für ihre API-Endpunkte zu. Dadurch wird auch der Stack identifiziert, auf dem dieser Mandant gehostet wird.

Nachfolgend finden Sie einige Beispiele der Unterschiede zwischen Stack-spezifischen Endpunkten und mandantenspezifischen Endpunkten:

Endpunkt	Stack-spezifisch	Mandantenspezifischer Endpunkt
API-Auth	auth.exacttargetapis.com	mc123.auth.marketingcloudapis.com
REST-API	www.exacttargetapis.com	mc123.rest.marketingcloudapis.com
Geräte-API	consumer.exacttargetapis.com	mc123.device.marketingcloudapis.com
SOAP-API	webservice.s7.exacttarget.com	mc123.soap.marketingcloudapis.com

Welche Endpunkte müssen aktualisiert werden?

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
SFTP-Integrationen, die eine spezifische, hartcodierte IP-Adresse verwenden

MobilePush-SDK

Verwendet Ihre Anwendung die folgenden MobilePush-SDK-Versionen, muss sie aktualisiert werden. Die folgenden SDK-Versionen verwenden keine mandantenspezifischen Endpunkte. Sie sind hartcodiert, um den "veralteten" Endpunkt "device.exacttargetapis.com" zu verwenden:

- iOS 6.1.4 oder älter
- Android 6.1.0 oder älter

Verwendet Ihre Anwendung die folgenden MobilePush-SDK-Versionen, sollten Sie mit Ihrem Entwicklungsteam abstimmen, ob das SDK für die Verwendung des mandantenspezifischen Endpunkts Ihrer Anwendung konfiguriert wurde. Wenn Sie diese SDK-Versionen verwenden und bestätigt haben, dass Ihre Anwendung das SDK so konfiguriert hat, dass es den mandantenspezifischen Endpunkt Ihrer Anwendung verwendet, sind keine weiteren Maßnahmen erforderlich.
1. iOS 6.0.0
2. Android 6.0.2
3. Hinweis: Obwohl die oben genannten Versionen die Mindestversionen des MobilePush-SDKs für die Unterstützung von mandantenspezifischen Endpunkten darstellen, sollten Sie Ihre Anwendung stets auf die neueste Version des SDKs aktualisieren.

Warum werden diese Endpunkte außer Kraft gesetzt?

Bei Salesforce steht das Vertrauen unserer Kunden an erster Stelle. Zum Verbessern der Sicherheit, der Servicezuverlässigkeit, -verfügbarkeit und -leistung müssen die veralteten Stack-spezifischen Endpunkte durch mandantenspezifische Endpunkte ersetzt werden.

Inwiefern sind mandantenspezifische Endpunkte besser als die veralteten Endpunkte?

Wie oben erwähnt, verbessern mandantenspezifische Endpunkte die Gesamtzuverlässigkeit, -verfügbarkeit und -leistung der Marketing Cloud-Services, da Anforderungen nicht mehr zwischen den Stacks verschoben werden.

Nachfolgend finden Sie einige zielspezifische Leistungen mandantenspezifischer Endpunkte:

Erweiterter Sicherheitsstatus
Durch jeden Kunden, der seinen eigenen Endpunkt verwendet, erhöht sich das Maß an Sicherheit. Außerdem lässt sich dadurch die Aktualisierung von Sicherheitselementen wie Zertifikaten einfacher verwalten.

Niedrigere Latenz beim Weiterleiten von Kundenanforderungen
Mithilfe von mandantenspezifischen Endpunkten können Kundenanforderungen direkt an den gewünschten Stack weitergeleitet werden, was den globalen Abgleich und das Zurückweisen von Stack-übergreifenden Anforderungen minimiert.

Verbesserte Notfallwiederherstellung
Im Falle eines Serviceausfalls können die ausschließlich für mandantenspezifische Endpunkte vorgesehenen Stacks die Wiederherstellungszeit verbessern. Dazu wird die Auswirkung der Reparaturen lediglich auf die Stacks isoliert, die vom Ausfall betroffen sind.

Minimierung von Leistungsproblemen, verbesserte Betriebszeit
Unabhängig davon, ob es sich um einen Kunden handelt, der häufig Tokenanforderungen nutzt, ob ungedrosselte Wiederholungen vorliegen oder ob ein Problem mit einem Stack oder mit einem Pool der Computer vorliegt, kann die Auswirkung mithilfe von mandantenspezifischen Endpunkten auf einen bestimmten Satz an Kunden eingeschränkt werden, anstatt einen globalen Ausfall zu verursachen.

Woran erkenne ich, ob ich die mandantenspezifischen oder die veralteten Endpunkte verwende?

Wie oben erwähnt, weisen die veralteten Endpunkte eine andere Fachbezeichnung als die veralteten Endpunkte auf. Die veralteten Endpunkte weisen möglicherweise eine Stack-Bezeichnung als Teil des Endpunkts auf, beispielsweise "s4" in diesem Beispiel zu REST/Auth:

https://auth-s4.exacttargetapis.com

In einigen Fällen kann die Stack-Bezeichnung fehlen, so wie in diesem Beispiel:

https://auth.exacttargetapis.com/

Die Version des mandantenspezifischen Endpunkts enthält jedoch im URL immer eine Mandanten-ID, etwa diese:

mc563885gzs27c5t9-63k636ttgm.rest.marketingcloudapis.com

Ich muss meine Endpunkte aktualisieren. Wo finde ich eine entsprechende Anleitung?

Nachfolgend finden Sie Links zu Knowledge-Artikeln, in denen die Aktualisierung Ihrer entsprechenden Endpunkte beschrieben ist:

Ich weiß weder, welche Endpunkte geändert werden müssen, noch wo sie sich befinden. Was muss ich tun?

Wenn Sie nach dem Lesen der oben aufgelisteten Knowledge-Artikel Fragen haben, erstellen Sie über das Portal "Hilfe und Schulung" einen Support-Kundenvorgang.