Documentatie Experience Platform Gids voor Source Connectors

Salesforce

Laatst bijgewerkt: 17 april 2025

Onderwerpen:

Gemaakt voor:

Ontwikkelaar

IMPORTANT

U kunt nu de Salesforce -bron gebruiken wanneer u Adobe Experience Platform uitvoert op Amazon Web Services (AWS). Experience Platform die op AWS wordt uitgevoerd, is momenteel beschikbaar voor een beperkt aantal klanten. Meer over de gesteunde infrastructuur van Experience Platform leren, zie het multi-wolkenoverzicht van Experience Platform.

Adobe Experience Platform staat toe dat gegevens uit externe bronnen worden opgenomen en biedt u de mogelijkheid om inkomende gegevens te structureren, labelen en verbeteren met behulp van Experience Platform-services. U kunt gegevens invoeren uit verschillende bronnen, zoals Adobe-toepassingen, opslag in de cloud, databases en vele andere.

Experience Platform biedt ondersteuning voor het opnemen van gegevens van een CRM-systeem van derden. Tot de ondersteuning voor CRM-providers behoren Salesforce .

Stel uw Salesforce source in voor Experience Platform on Azure

Volg de onderstaande stappen om te leren hoe u uw Salesforce -account voor Experience Platform on Azure kunt instellen.

IP adres lijst van gewenste personen voor verbinding aan Azure

U moet gebied-specifieke IP adressen aan uw lijst van gewenste personen toevoegen alvorens uw bronnen aan Experience Platform op Azure aan te sluiten. Het nalaten om uw gebied-specifieke IP adressen aan uw lijst van gewenste personen toe te voegen kan tot fouten of niet-prestaties leiden wanneer het gebruiken van bronnen. Lees de IP pagina van de adreslijst van gewenste personenvoor meer informatie.

VA7

40.70.226.96/28
40.70.226.32/28
52.232.229.255
52.232.229.253
40.70.226.144/28
40.70.226.64/28
40.70.225.240/28
40.70.225.224/28
40.70.224.64/29
40.70.226.80/28
40.70.226.176/28
52.232.229.230
40.70.226.128/28
40.70.226.0/28
40.70.226.16/28
52.138.119.167
40.70.226.160/28
40.70.226.192/28
40.70.226.48/28
20.96.243.176
40.70.226.112/28
40.70.226.208/28

NLD2

40.74.4.144/28
40.74.3.176/28
40.74.5.128/28
40.74.4.176/28
40.74.6.112/28
40.74.7.128/28
40.74.6.144/28
51.105.144.81
52.142.236.87
40.74.6.80/28
20.101.246.9
40.74.7.208/28
40.74.6.128/28
40.74.7.176/28
51.124.70.4
40.74.7.144/28
108.141.12.47
20.50.23.153
51.144.184.248/29
40.74.7.160/28
40.74.7.192/28
51.105.144.1
40.74.4.160/28
40.74.6.96/28

AUS5

20.43.111.32/28
20.43.110.144/28
20.53.111.113
20.227.32.175
20.43.110.96/28
20.43.110.64/28
20.193.56.144/28
20.43.110.192/28
20.43.97.95
20.43.111.16/28
20.43.110.128/28
20.40.185.111
20.193.56.160/28
20.43.110.112/28
40.82.220.111
20.43.111.0/28
20.193.38.208/28
20.43.110.80/28
20.43.110.176/28
20.43.110.48/28
20.193.36.37
20.43.110.208/28
20.43.110.224/28
20.43.110.160/28
20.40.185.225
20.43.110.240/28
20.193.56.128/28
20.40.185.185

CAN2

20.116.159.48/28
20.116.159.144/28
20.116.159.96/28
20.220.243.238
20.116.159.80/28
20.116.159.32/28
20.151.241.138
4.172.28.20
20.151.241.124
20.116.248.0/28
20.116.155.128/28
20.116.159.64/28
20.116.159.192/28
20.116.159.176/28
20.116.175.240/28
20.116.248.16/28
20.116.158.240/28
20.116.159.112/28
20.151.240.247
20.151.241.173
20.116.159.128/28
20.116.159.160/28
20.116.159.0/28
20.104.5.248
20.116.175.224/28
20.116.159.208/28
20.116.159.224/28

GBR9

20.162.155.16/28
20.162.154.96/28
20.26.64.0/28
20.26.64.96/28
20.162.154.64/28
20.108.200.27
20.162.154.80/28
20.162.153.192/28
20.108.200.61
20.162.154.48/28
20.162.154.192/28
20.162.154.0/28
20.26.64.16/28
20.162.154.112/28
20.162.153.32/28
20.254.80.141
20.162.153.208/28
20.108.203.20
20.26.64.48/28
20.162.154.240/28
20.162.154.208/28
20.162.154.160/28
20.108.205.182
20.108.202.198
20.162.154.32/28
20.162.153.16/28

IND2

4.188.92.84
4.224.5.224/28
4.224.7.32/28
4.188.92.87
4.188.89.92
4.224.5.112/28
4.224.6.80/28
4.224.144.224/28
4.224.144.240/28
4.224.6.96/28
4.188.89.255
4.188.94.32/28
4.224.5.96/28
4.224.6.64/28
4.224.7.48/28
4.224.5.208/28
4.188.90.65
4.224.6.16/28
4.224.6.0/28
4.224.5.192/28
4.224.7.16/28
4.188.90.67
4.188.90.17
4.188.94.48/28
4.224.6.112/28
4.224.5.240/28
4.224.7.0/28

Veldtoewijzing van Salesforce naar XDM

Als u een bronverbinding wilt maken tussen Salesforce en Experience Platform, moeten de Salesforce -brongegevensvelden worden toegewezen aan hun juiste doel-XDM-velden voordat ze worden opgenomen in Experience Platform.

Zie het volgende voor meer informatie over de regels voor veldmapping tussen Salesforce datasets en Experience Platform:

Het hulpprogramma voor automatisch genereren van naamruimten en schema Salesforce instellen

Als u de Salesforce bron wilt gebruiken als onderdeel van B2B-CDP , moet u eerst een hulpprogramma Postman instellen om automatisch uw Salesforce naamruimten en schema's te genereren. In de volgende documentatie vindt u aanvullende informatie over het instellen van het hulpprogramma Postman :

U kunt namespace en schema auto-generatie nutsinzameling en milieu van deze bewaarplaats GitHubdownloaden.
Voor informatie bij het gebruiken van Experience Platform APIs met inbegrip van details over hoe te om waarden voor vereiste kopballen te verzamelen en steekproefAPI vraag te lezen, zie de gids op begonnen wordt met Experience Platform APIs.
Voor informatie over hoe te om uw geloofsbrieven voor Experience Platform APIs te produceren, zie het leerprogramma op voor authentiek verklaren en tot Experience Platform APIs toegang heeft.
Voor informatie over hoe te opstelling Postman voor Experience Platform APIs, zie het leerprogramma op vestiging de console van de ontwikkelaar en Postman.

Met een Experience Platform-ontwikkelaarsconsole en Postman -configuratie kunt u nu de juiste omgevingswaarden toepassen op uw Postman -omgeving.

De hulplijn van de variabele tabel weergeven

De volgende tabel bevat voorbeeldwaarden en aanvullende informatie over het vullen van de Postman -omgeving:

Variabele

Beschrijving

Voorbeeld

CLIENT_SECRET

Een unieke id die wordt gebruikt om de {ACCESS_TOKEN} te genereren. Zie het leerprogramma op voor authentiek verklaren en tot Experience Platform APIs toegang hebbenvoor informatie over hoe te om uw {CLIENT_SECRET} terug te winnen.

{CLIENT_SECRET}

JWT_TOKEN

JSON Web Token (JWT) is een verificatiereferentie die wordt gebruikt om uw {ACCESS_TOKEN} te genereren. Zie het leerprogramma op voor authentiek verklaren en tot Experience Platform APIs toegang hebbenvoor informatie over hoe te om uw {JWT_TOKEN} te produceren.

{JWT_TOKEN}

API_KEY

Een unieke id die wordt gebruikt om aanroepen naar Experience Platform API's te verifiëren. Zie het leerprogramma op voor authentiek verklaren en tot Experience Platform APIs toegang hebbenvoor informatie over hoe te om uw {API_KEY} terug te winnen.

c8d9a2f5c1e03789bd22e8efdd1bdc1b

ACCESS_TOKEN

Het toestemmingstoken wordt vereist om vraag aan Experience Platform APIs te voltooien. Zie het leerprogramma op voor authentiek verklaren en tot Experience Platform APIs toegang hebbenvoor informatie over hoe te om uw {ACCESS_TOKEN} terug te winnen.

Bearer {ACCESS_TOKEN}

META_SCOPE

Met betrekking tot Marketo is deze waarde vast en altijd ingesteld op: ent_dataservices_sdk .

ent_dataservices_sdk

CONTAINER_ID

De global container bevat alle standaard door Adobe en Experience Platform verschafte klassen, groepen met schemavelden, gegevenstypen en schema's. Met betrekking tot Marketo is deze waarde vast en altijd ingesteld op global .

global

PRIVATE_KEY

Een referentie die wordt gebruikt om uw Postman -instantie te verifiëren voor Experience Platform API's. Zie het leerprogramma bij de console van de opstellingsontwikkelaar en vestiging de console van de opsteller en Postman voor instructies op hoe te om uw {PRIVATE_KEY} terug te winnen.

{PRIVATE_KEY}

TECHNICAL_ACCOUNT_ID

Een referentie die wordt gebruikt om te integreren in Adobe I/O.

D42AEVJZTTJC6LZADUBVPA15@techacct.adobe.com

IMS

Het Identity Management System (IMS) biedt het framework voor verificatie van Adobe-services. Met betrekking tot Marketo is deze waarde vast en altijd ingesteld op: ims-na1.adobelogin.com .

ims-na1.adobelogin.com

IMS_ORG

Een onderneming die producten en diensten kan bezitten of in licentie kan geven en toegang kan verlenen tot haar leden. Zie het leerprogramma op vestiging de console van de ontwikkelaar en Postman voor instructies op hoe te om uw {ORG_ID} informatie terug te winnen.

ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg

SANDBOX_NAME

De naam van de virtuele sandboxpartitie die u gebruikt.

prod

TENANT_ID

Een id die wordt gebruikt om ervoor te zorgen dat de bronnen die u maakt, correct worden genoemd en zich binnen uw organisatie bevinden.

b2bcdpproductiontest

PLATFORM_URL

Het URL-eindpunt waarnaar u API-aanroepen maakt. Deze waarde is vast en wordt altijd ingesteld op: http://platform.adobe.io/ .

http://platform.adobe.io/

munchkinId

De unieke id voor uw Marketo -account. Zie het leerprogramma op voor authentiek verklaren uw Marketo instantievoor informatie over hoe te om uw munchkinId terug te winnen.

123-ABC-456

sfdc_org_id

De organisatie-id voor uw Salesforce -account. Zie de volgende Salesforce gidsvoor meer informatie bij het verwerven van uw Salesforce organisatie identiteitskaart

00D4W000000FgYJUA0

has_abm

Een booleaanse waarde die aangeeft of u bent geabonneerd op Marketo Account-Based Marketing .

false

has_msi

Een booleaanse waarde die aangeeft of u bent geabonneerd op Marketo Sales Insight .

false

Scripts uitvoeren

Als de verzameling van Postman is ingesteld en de omgeving is ingesteld, kunt u het script nu uitvoeren via de interface van Postman .

Selecteer in de interface Postman de hoofdmap van het hulpprogramma voor automatische generator en selecteer vervolgens Run in de bovenste koptekst.

wortel-omslag

De interface Runner wordt weergegeven. Controleer van hieruit of alle selectievakjes zijn ingeschakeld en selecteer vervolgens Run Namespaces and Schemas Autogeneration Utility .

looppas-generator

Een succesvol verzoek leidt tot B2B namespaces en schema's volgens bètaspecificaties.

De Salesforce source voor Experience Platform instellen op Amazon Web Services

AVAILABILITY

Deze sectie is van toepassing op implementaties van Experience Platform die op Amazon Web Services (AWS) worden uitgevoerd. Experience Platform die op AWS wordt uitgevoerd, is momenteel beschikbaar voor een beperkt aantal klanten. Meer over de gesteunde infrastructuur van Experience Platform leren, zie het multi-wolkenoverzicht van Experience Platform.

Volg de onderstaande stappen om te leren hoe u uw Salesforce -account voor Experience Platform op Amazon Web Services (AWS) kunt instellen.

Vereisten

Als u uw Salesforce -account wilt koppelen aan Experience Platform in een AWS-gebied, moet u over het volgende beschikken:

Een Salesforce -account met API-toegang.
A Salesforce Connected App dat u vervolgens kunt gebruiken om JWT_BEARER OAuth-flow in te schakelen.
De benodigde machtigingen in Salesforce voor toegang tot gegevens.

IP adres lijst van gewenste personen voor verbinding op AWS

U moet gebied-specifieke IP adressen aan uw lijst van gewenste personen toevoegen alvorens uw bronnen aan Experience Platform op AWS aan te sluiten. Voor meer informatie, lees de gids op voegend op lijst van gewenste personen IP adressen om met Experience Platform op AWSvoor meer informatie te verbinden.

Een Salesforce Connected App maken

Gebruik eerst het volgende om een certificaat/sleutelpaar PEM-bestanden te maken.

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

In het Salesforce dashboard, uitgezochte montages ( ) en selecteer vervolgens Setup .
Navigeer naar App Manager en selecteer vervolgens New Connection App .
Geef een naam op voor uw app en zorg dat de overige velden automatisch kunnen worden ingevuld.
Schakel het vak voor Enable OAuth Settings in.
Stel een callback-URL in. Omdat deze optie niet wordt gebruikt voor JWT, kunt u https://localhost gebruiken.
Schakel het vak voor Use Digital Signatures in.
Upload het bestand cert.pem dat eerder is gemaakt.

Vereiste machtigingen toevoegen

Voeg de volgende machtigingen toe:

Gebruikersgegevens beheren via API's (api)
Toegang tot aangepaste machtigingen (custom_permissions)
Toegang tot de dienst van identiteitskaart URL (identiteitskaart, profiel, e-mail, adres, telefoon)
Unieke id's benaderen (openid)
Verzoeken op elk gewenst moment uitvoeren (refresh_token, offline_access)

Nadat u de machtigingen hebt toegevoegd, schakelt u het vak voor Issue JSON Web Token (JWT)-based access tokens for named user in.

Selecteer vervolgens Save , Continue en Manage Customer Details . Gebruik het deelvenster met consumentendetails om het volgende op te halen:

Consumentensleutel: U zult later deze Consumentensleutel als uw cliëntidentiteitskaart gebruiken, wanneer het voor authentiek verklaren van uw Salesforce rekening aan Experience Platform.
Consumentengeheim: U zult later dit consumentengeheim als uw cliëntidentiteitskaart gebruiken, wanneer het voor authentiek verklaren van uw Salesforce rekening aan Experience Platform.

Uw Salesforce -gebruiker autoriseren voor de aangesloten app

Voer de onderstaande stappen uit om toestemming te krijgen voor het gebruik van de Connected App:

Navigeer naar Manage Connected Apps .
Selecteer Edit.
Configureer Permitted Users als Admin approved users are pre-authorized en selecteer Save .
Navigeer naar Settings> Manage Users >Profiles .
Bewerk het profiel dat aan de gebruiker is gekoppeld.
Navigeer naar Connected App Access en selecteer vervolgens de app die u in een eerdere stap hebt gemaakt.

Token voor JWT-tower genereren

Voer de onderstaande stappen uit om uw token voor de JWT-toonder te genereren.

Sleutelpaar omzetten in pkcs12

Als u uw JWT-token voor toonder wilt genereren, moet u eerst de volgende opdracht gebruiken om uw certificaat/sleutelpaar om te zetten in de indeling pkcs12. Tijdens deze stap, moet u ook een uitvoerwachtwoord plaatsen wanneer ertoe aangezet.

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

Java-sleutelarchief maken op basis van pkcs12

Vervolgens gebruikt u de volgende opdracht om een Java-sleutelarchief te maken op basis van de pkcs12 die u zojuist hebt gegenereerd. Tijdens deze stap, moet u a ook een wachtwoord van het bestemmingssleutelarchief plaatsen wanneer ertoe aangezet. Daarnaast moet u het vorige exportwachtwoord opgeven als het bronsleutelarchiefwachtwoord.

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

Bevestig dat keystroke.jks een jwtcert-alias bevat

Gebruik vervolgens de volgende opdracht om te bevestigen dat de keystroke.jks een jwtcert -alias bevat. Tijdens deze stap, zult u worden ertoe aangezet om het wachtwoord van het bestemmingssleutelarchief te verstrekken dat in de vorige stap werd geproduceerd.

keytool -keystore keystore.jks -list

Ondertekend token genereren

Tot slot gebruikt u de Java-klasse JWTExample hieronder om uw ondertekende token te genereren.

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

Eigenschap

Configuraties

claimArray[0]

Werk claimArray[0] bij met uw client-id.

claimArray[1]

Werk claimArray[1] bij met de Salesforce -gebruikersnaam die op basis van de app is geautoriseerd.

claimArray[2]

Werk claimArray[2] bij met de aanmeldings-URL van Salesforce .

claimArray[3]

Werk claimArray[3] bij met een vervaldatum die in milliseconden sinds de epoche-tijd is opgemaakt. 3660624000000 is bijvoorbeeld 12-31-2085.

/path/to/keystore

Vervang /path/to/keystore door het juiste pad naar het bestand keystore.jks

keystorepassword

Vervang keystorepassword door het wachtwoord voor het doelsleutelarchief.

privatekeypassword

Vervang privatekeypassword door het wachtwoord voor het bronsleutelarchief.

Volgende stappen

Zodra u de vereiste configuratie voor uw Salesforce -account hebt voltooid, kunt u doorgaan met het verbinden van uw Salesforce -account met Experience Platform en uw CRM-gegevens invoeren. Lees de documentatie hieronder voor meer informatie:

Verbinding maken Salesforce met Experience Platform via API's

In de onderstaande documentatie vindt u informatie over het tot stand brengen van een verbinding tussen Salesforce en Experience Platform via API's of de gebruikersinterface:

Verbinding maken Salesforce met Experience Platform via de gebruikersinterface

recommendation-more-help