Loading
Salesforce から送信されるメールは、承認済ドメインからのみとなります続きを読む

Marketing Cloud - テナントのエンドポイントを利用するための SOAP API 統合の更新

公開日: Jan 28, 2025
説明

状況は?

Salesforce は、お客様のデータとアプリケーションの保護に全力を尽くしています。お客様の信頼とセキュリティへの継続的なコミットメントの一環として、Marketing Cloud へのインテグレーションは、テナント固有のエンドポイントを利用することを推奨しています。

 

テナント固有エンドポイントとは?

Marketing Cloud は、システムが生成した一意のサブドメインを各テナントに割り当てます。テナントは、そのテナント種別に応じて最上位のエンタープライズアカウントとそのビジネスユニット、コアアカウント、最上位のエージェンシーアカウント、またはクライアントアカウントを表します。サブドメインは、「mc」で始まる 28 文字の文字列によって表されます。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

詳細情報はどこで入手できますか?

最新情報、質問、そしてリソースを入手するには、Salesforce Trailblazer コミュニティの Marketing Cloud API Endpoint Updates (Marketing Cloud API エンドポイント更新) グループをフォローしてください。 

解決策

自分のテナントの SOAP API エンドポイントはどこで確認できますか?

  1. テナントの SOAP API URI は、[設定] > [プラットフォームツール] > [アプリケーション] > [インストール済みパッケージ] の [インストール済みパッケージ] にあります。[インストール済みパッケージ] で、以下を行う必要があります。
    1. テナントの SOAP WSDL エンドポイントを作成するには、/etframework.wsdl を付加します。
    2. テナントの SOAP サービスエンドポイントを作成するには、/Service.asmx を付加します。
  2. テナントの SOAP WSDL エンドポイントと SOAP サービスエンドポイントは、[設定] > [会社の設定] > [アカウント設定] でも確認できます。
  3. また、[API ユーザー] が [はい] である場合には、[クラウドの設定] > [ユーザー設定] に移動して、テナントの SOAP WSDL URL と 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