Salesforce

Adobe Experience Platform consente di acquisire i dati da origini esterne e allo stesso tempo di strutturare, etichettare e migliorare i dati in arrivo tramite i servizi di Platform. È possibile acquisire dati da diverse origini, ad esempio applicazioni Adobe, archiviazione basata su cloud, database e molte altre.

Experience Platform fornisce supporto per l’acquisizione di dati da un sistema CRM di terze parti. Il supporto per i provider di gestione delle relazioni con i clienti include Salesforce.

Configura l'origine Salesforce, ad Experience Platform in Azure azure

Segui i passaggi seguenti per scoprire come configurare l'account Salesforce, ad Experience Platform in Azure.

ELENCO CONSENTITI di indirizzo IP

Prima di utilizzare i connettori di origine, è necessario aggiungere un elenco di indirizzi IP a un elenco consentiti. La mancata aggiunta all’elenco consentiti degli indirizzi IP specifici per l’area geografica potrebbe causare errori o prestazioni non ottimali durante l’utilizzo delle origini. Per ulteriori informazioni, vedere la pagina elenco consentiti indirizzo IP.

Mappatura campo da Salesforce a XDM

Per stabilire una connessione di origine tra Salesforce e Platform, i campi dati di origine Salesforce devono essere mappati sui campi XDM di destinazione appropriati prima di essere acquisiti in Platform.

Per informazioni dettagliate sulle regole di mappatura dei campi tra Salesforce set di dati e Platform, consulta:

Configurare l'utilità di generazione automatica dello spazio dei nomi e dello schema Salesforce

Per utilizzare l'origine Salesforce come parte di B2B-CDP, è necessario prima impostare un'utilità Postman per generare automaticamente gli spazi dei nomi e gli schemi Salesforce. La documentazione seguente fornisce ulteriori informazioni sulla configurazione dell'utilità Postman:

Con una console per sviluppatori Platform e Postman configurati, puoi iniziare ad applicare i valori di ambiente appropriati all'ambiente Postman.

Eseguire gli script

Dopo aver configurato la raccolta Postman e l'ambiente, è ora possibile eseguire lo script tramite l'interfaccia Postman.

Nell'interfaccia Postman, selezionare la cartella principale dell'utilità di generazione automatica, quindi selezionare Run dall'intestazione superiore.

Viene visualizzata l'interfaccia Runner. Da qui, assicurarsi che tutte le caselle di controllo siano selezionate, quindi selezionare Run Namespaces and Schemas Autogeneration Utility.

In caso di esito positivo, la richiesta crea gli spazi dei nomi e gli schemi B2B in base alle specifiche beta.

Configura l'origine Salesforce, ad Experience Platform su Amazon Web Services aws

Segui i passaggi seguenti per scoprire come configurare l'account Salesforce, ad Experience Platform su Amazon Web Services (AWS).

Prerequisiti

Per connettere l'account Salesforce all'Experience Platform in un'area geografica AWS, è necessario disporre dei seguenti elementi:

Per connettere l'account Salesforce all'Experience Platform su Amazon Web Services (AWS), è necessario aggiungere anche i seguenti indirizzi IP al inserisco nell'elenco Consentiti di:

Crea un Salesforce Connected App

Innanzitutto, utilizza quanto segue per creare una coppia certificato/chiave di file PEM.

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

Aggiungere le autorizzazioni richieste

Aggiungi le seguenti autorizzazioni:

Dopo aver aggiunto le autorizzazioni, assicurarsi di abilitare la casella per Issue JSON Web Token (JWT)-based access tokens for named user.

Selezionare Save, Continue e quindi Manage Customer Details. Utilizza il pannello dei dettagli del consumatore per recuperare quanto segue:

Autorizza l'utente Salesforce all'app connessa

Segui i passaggi seguenti per ottenere l’autorizzazione all’utilizzo dell’app connessa:

Genera token JWT bearer

Per generare il token JWT bearer, segui la procedura riportata di seguito.

Converti coppia di chiavi in pkcs12

Per generare il token JWT bearer, devi innanzitutto usare il seguente comando per convertire il certificato/coppia di chiavi in formato pkcs12. Durante questo passaggio, devi anche impostare una password di esportazione quando richiesto.

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

Creare un keystore Java basato su pkcs12

Quindi, utilizza il seguente comando per creare un keystore Java basato sul pkcs12 appena generato. Durante questo passaggio, devi anche impostare una password per il keystore di destinazione quando richiesto. Inoltre, devi fornire la password di esportazione precedente come password del keystore di origine.

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

Verifica che il file keystroke.jks includa un alias jwtcert

Utilizzare quindi il comando follow per verificare che keystroke.jks includa un alias jwtcert. Durante questo passaggio, verrà richiesto di fornire la password del keystore di destinazione generata nel passaggio precedente.

keytool -keystore keystore.jks -list

Genera token firmato

Infine, utilizza la classe Java JWTExample seguente per generare il token firmato.

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();
        }
    }
}

Passaggi successivi

Dopo aver completato la configurazione dei prerequisiti per l'account Salesforce, puoi procedere con la connessione dell'account Salesforce per l'Experience Platform e l'acquisizione dei dati CRM. Per ulteriori informazioni, consulta la documentazione seguente:

Connetti Salesforce a Platform tramite API

La documentazione seguente fornisce informazioni su come connettere Salesforce a Platform tramite API o tramite l'interfaccia utente:

Connetti Salesforce a Platform tramite l'interfaccia utente