Loading

Marketing Cloud: aggiornamento delle integrazioni API SOAP per l'utilizzo di endpoint del proprio tenant

Data pubblicazione: Jul 6, 2022
Descrizione

Cosa sta accadendo?

Salesforce si fonda sulla volontà di proteggere i dati e le applicazioni dei clienti. Nell'ambito del nostro costante impegno per garantire affidabilità e sicurezza ai clienti, le integrazioni in Marketing Cloud dovranno utilizzare gli endpoint specifici del tenant entro il 31 agosto 2022.
 

Che cos'è un endpoint specifico del tenant?

Marketing Cloud assegna automaticamente un sottodominio univoco generato dal sistema a ciascuno dei propri tenant. Il tenant rappresenta l'account Enterprise di livello più elevato e le relative unità operative, l'account Core, l'account Agency di livello più elevato o l'account Cliente, a seconda del tipo di tenant del cliente. Il sottodominio è rappresentato da una stringa di 28 caratteri che inizia con le lettere "mc". Quando il sottodominio viene aggiunto alle API Marketing Cloud, crea endpoint esclusivi del tenant.
 

Chi è interessato?

Possono essere interessati i clienti che utilizzano Email Studio, Mobile Studio, Automation Studio o Audience Builder ed eseguono richieste API SOAP.
 

Come stabilisco se le mie integrazioni API SOAP devono essere aggiornate?

Le integrazioni API SOAP dovranno essere aggiornate se si utilizza almeno uno dei seguenti endpoint:
  • 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

Dove è possibile trovare ulteriori informazioni?

Per aggiornamenti, domande e risorse, seguire il gruppo Marketing Cloud API Endpoint Updates nella Salesforce Trailblazer Community 

Risoluzione

Dove posso trovare gli endpoint API SOAP del mio tenant?

  1. L'URI dell'API SOAP del proprio tenant è disponibile in Pacchetti installati in Imposta> Strumenti piattaforma> App> Pacchetti installati. All'interno di Pacchetti installati è necessario
    1. Creare l'endpoint WSDL SOAP del tenant, aggiungere: /etframework.wsdl
    2. Creare l'endpoint di servizio SOAP del tenant, aggiungere: /Service.asmx
  2. L'endpoint WSDL SOAP e l'endpoint di servizio SOAP sono inoltre disponibili in Imposta > Impostazioni azienda > Impostazioni account.
  3. Inoltre, se Utente API corrisponde a "Sì", è inoltre possibile passare a Preferenze Cloud > Impostazioni utente e trovare l'endpoint WSDL SOAP, l'URL e l'endpoint di servizio SOAP.
 

Come aggiorno l'endpoint WSDL SOAP e l'endpoint di servizio SOAP?

Dopo aver individuato l'endpoint WSDL SOAP e l'endpoint di servizio SOAP, aggiornare le integrazioni Marketing Cloud sostituendo tutti gli endpoint esistenti con l'endpoint specifico del tenant appropriato.

Esempio di richiesta con endpoint di servizio specifico del tenant aggiornato

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>
 

 

Numero articolo Knowledge

000392834

 
Caricamento
Salesforce Help | Article