Salesforce

Adobe Experience Platform を使用すると、外部ソースからデータを取り込みながら、Platform サービスを使用して受信データの構造化、ラベル付けおよび拡張を行うことができます。アドビのアプリケーション、クラウドベースのストレージ、データベースなど、様々なソースからデータを取り込むことができます。

Experience Platform は、サードパーティの CRM システムからのデータ取り込みをサポートしています。CRM プロバイダーのサポートは Salesforce を含みます。

Azure にExperience Platformするための Salesforce ソースの設定 azure

Azure にExperience Platformするための Salesforce アカウントを設定する方法については、次の手順に従います。

IP アドレス許可リスト

ソースコネクタを操作する前に、IP アドレスのリストを許可リストに追加する必要があります。 地域固有の IP アドレスを許可リストに追加しないと、ソースを使用する際にエラーが発生したり、パフォーマンスが低下する場合があります。 詳しくは、IP アドレスの許可リストページを参照してください。

Salesforce から XDM へのフィールドマッピング

Salesforce と Platform の間にソース接続を確立するには、Salesforce のソースデータフィールドを、Platform に取り込む前に、適切なターゲット XDM フィールドにマッピングする必要があります。

Salesforce データセットと Platform 間のフィールドマッピングルールについて詳しくは、次を参照してください。

Salesforce 名前空間とスキーマ自動生成ユーティリティの設定

Salesforce ソースを B2B-CDP の一部として使用するには、まず Postman ユーティリティを設定して、Salesforce 名前空間とスキーマを自動生成する必要があります。 次のドキュメントでは、Postman ユーティリティの設定に関する追加情報を示します。

Platform 開発者コンソールをセットアップす Postman と、適切な環境値の Postman 環境への適用を開始できます。

スクリプトの実行

Postman コレクションと環境を設定すると、Postman インターフェイスを使用してスクリプトを実行できます。

Postman インターフェイスで、自動生成ユーティリティのルートフォルダーを選択し、上部のヘッダーから「Run」を選択します。

Runner インターフェイスが表示されます。 ここから、すべてのチェックボックスが選択されていることを確認してから選択し Run Namespaces and Schemas Autogeneration Utility す。

リクエストが成功すると、ベータ版の仕様に従って B2B 名前空間とスキーマが作成されます。

Amazon Web Services上でのExperience Platform用の Salesforce ソースの設定 aws

Amazon Web Services（AWS）でExperience Platform用に Salesforce アカウントを設定する方法については、次の手順に従います。

前提条件

Salesforce アカウントをAWS リージョンのExperience Platformに接続するには、次が必要です。

また、Salesforce アカウントをAmazon Web Services（AWS）のExperience Platformに接続するには、次の IP アドレスを許可リストに追加する必要があります。

Salesforce Connected App の作成

まず、以下を使用して PEM ファイルの証明書とキーペアを作成します。

openssl req -newkey rsa:4096 -new -nodes -x509 -days 3650 -keyout key.pem -out cert.pem

必要な権限を追加

次の権限を追加します。

権限が追加されたら、必ずこのチェックボックスを有効に Issue JSON Web Token (JWT)-based access tokens for named user ます。

次に、「Save」、「Continue」の順に選択し、「Manage Customer Details」を選択します。 消費者の詳細パネルを使用して、以下を取得します。

接続されたアプリへの Salesforce ユーザーの認証

接続されたアプリを使用するための認証を取得するには、次の手順に従います。

JWT ベアラートークンの生成

JWT ベアラートークンを生成するには、次の手順に従います。

キーペアを pkcs12 に変換する

JWT ベアラートークンを生成するには、まず次のコマンドを使用して、証明書とキーのペアを pkcs12 形式に変換する必要があります。 この手順では、プロンプトが表示されたら 書き出しパスワードを設定 する必要もあります。

openssl pkcs12 -export -in cert.pem -inkey key.pem -name jwtcert >jwtcert.p12

pkcs12 に基づく java キーストアの作成

次に、次のコマンドを使用して、生成したばかりの pkcs12 に基づいて java キーストアを作成します。 この手順では、プロンプトが表示されたら 宛先キーストアパスワードを設定 も入力する必要があります。 さらに、ソースキーストアのパスワードとして、以前の書き出しパスワードを指定する必要があります。

keytool -importkeystore -srckeystore jwtcert.p12 -destkeystore keystore.jks -srcstoretype pkcs12 -alias jwtcert

keystroke.jks に jwtcert エイリアスが含まれていることを確認します

次に、次のコマンドを使用して、keystroke.jks に jwtcert エイリアスが含まれていることを確認します。 この手順では、前の手順で生成した宛先キーストアのパスワードを指定するように求められます。

keytool -keystore keystore.jks -list

署名済みトークンの生成

最後に、以下の Java クラス JWTExample を使用して、署名済みトークンを生成します。

package org.example;

import org.apache.commons.codec.binary.Base64;

import java.io.*;
import java.security.*;
import java.text.MessageFormat;

public class Main {

    public static void main(String[] args) {

        String header = "{\"alg\":\"RS256\"}";
        String claimTemplate = "'{'\"iss\": \"{0}\", \"sub\": \"{1}\", \"aud\": \"{2}\", \"exp\": \"{3}\"'}'";

        try {
            StringBuffer token = new StringBuffer();

            //Encode the JWT Header and add it to our string to sign
            token.append(Base64.encodeBase64URLSafeString(header.getBytes("UTF-8")));

            //Separate with a period
            token.append(".");

            //Create the JWT Claims Object
            String[] claimArray = new String[5];
            claimArray[0] = "{CLIENT_ID}";
            claimArray[1] = "{AUTHORIZED_SALESFORCE_USERNAME}";
            claimArray[2] = "{SALESFORCE_LOGIN_URL}";
            claimArray[3] = Long.toString((System.currentTimeMillis() / 1000) + 2629746*4);
            MessageFormat claims;
            claims = new MessageFormat(claimTemplate);
            String payload = claims.format(claimArray);

            //Add the encoded claims object
            token.append(Base64.encodeBase64URLSafeString(payload.getBytes("UTF-8")));

            //Load the private key from a keystore
            KeyStore keystore = KeyStore.getInstance("JKS");
            keystore.load(new FileInputStream("path/to/keystore"), "keystorepassword".toCharArray());
            PrivateKey privateKey = (PrivateKey) keystore.getKey("jwtcert", "privatekeypassword".toCharArray());

            //Sign the JWT Header + "." + JWT Claims Object
            Signature signature = Signature.getInstance("SHA256withRSA");
            signature.initSign(privateKey);
            signature.update(token.toString().getBytes("UTF-8"));
            String signedPayload = Base64.encodeBase64URLSafeString(signature.sign());

            //Separate with a period
            token.append(".");

            //Add the encoded signature
            token.append(signedPayload);

            System.out.println(token.toString());

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

次の手順

Salesforce アカウントの前提条件の設定が完了したら、Salesforce アカウントをExperience Platformに接続して CRM データを取り込む手順に進むことができます。 詳しくは、以下のドキュメントを参照してください。

API を使用して Salesforce と Platform を接続する

以下のドキュメントでは、API やユーザーインターフェイスを使用して Salesforce と Platform を接続する方法について説明します。

UI を使用した Salesforce の Platform への接続