Salesforce
Adobe Experience Platform staat toe dat gegevens uit externe bronnen worden opgenomen terwijl u de mogelijkheid krijgt om inkomende gegevens te structureren, te labelen en te verbeteren met behulp van de platformservices. U kunt gegevens uit diverse bronnen invoeren, zoals toepassingen voor Adobe, 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 .
Uw Salesforce source instellen voor Experience Platform op Azure azure
Volg de onderstaande stappen om te leren hoe u uw Salesforce -account kunt instellen voor Experience Platform in Azure.
IP adres lijst van gewenste personen
Een lijst van IP adressen moet aan een lijst van gewenste personen worden toegevoegd alvorens met bronschakelaars te werken. Het niet toevoegen van uw regio-specifieke IP adressen aan uw lijst van gewenste personen kan tot fouten of niet-prestaties leiden wanneer het gebruiken van bronnen. Zie de 🔗 pagina van de lijst van gewenste personen van het 0} IP adres {voor meer informatie.
Veldtoewijzing van Salesforce naar XDM
Om een bronverbinding tussen Salesforce en Platform tot stand te brengen, moeten de Salesforce brongegevensgebieden aan hun aangewezen doelXDM gebieden worden in kaart gebracht alvorens in Platform wordt opgenomen.
Zie het volgende voor gedetailleerde informatie over de regels voor het in kaart brengen van velden tussen Salesforce datasets en 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 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 Platform APIs.
- Voor informatie over hoe te om uw geloofsbrieven voor 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 Platform APIs, zie het leerprogramma op vestiging de console van de ontwikkelaar en Postman.
Met een platformontwikkelaarsconsole en Postman -configuratie kunt u nu de juiste omgevingswaarden toepassen op uw Postman -omgeving.
De volgende tabel bevat voorbeeldwaarden en aanvullende informatie over het vullen van de Postman -omgeving:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 17-row-3 layout-auto | ||
---|---|---|
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 heeftvoor 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 heeftvoor informatie over hoe te om uw {JWT_TOKEN} te produceren. |
{JWT_TOKEN} |
API_KEY |
Een unieke id die wordt gebruikt om aanroepen van Experience Platform-API's te verifiëren. Zie het leerprogramma op voor authentiek verklaren en tot Experience Platform APIs toegang heeftvoor informatie over hoe te om uw {API_KEY} terug te winnen. |
c8d9a2f5c1e03789bd22e8efdd1bdc1b |
ACCESS_TOKEN |
Het toestemmingstoken dat wordt vereist om vraag aan Experience Platform APIs te voltooien. Zie het leerprogramma op voor authentiek verklaren en tot Experience Platform APIs toegang heeftvoor 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 houdt alle standaard Adobe en partner van het Experience Platform verstrekte klassen, de groepen van het schemagebied, gegevenstypes, 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 de 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.
De interface Runner wordt weergegeven. Controleer van hieruit of alle selectievakjes zijn ingeschakeld en selecteer vervolgens Run Namespaces and Schemas Autogeneration Utility .
Een succesvol verzoek leidt tot B2B namespaces en schema's volgens bètaspecificaties.
De Salesforce -bron instellen voor Experience Platform op Amazon Web Services aws
Volg de onderstaande stappen om te leren hoe u uw Salesforce -account kunt instellen voor Experience Platform op Amazon Web Services (AWS).
Vereisten
Als u uw Salesforce -account wilt koppelen aan een Experience Platform in een AWS-gebied, hebt u het volgende nodig:
- 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.
U moet ook de volgende IP-adressen toevoegen aan uw lijst van gewenste personen om uw Salesforce -account te koppelen aan het Experience Platform op Amazon Web Services (AWS):
34.193.63.59
44.217.93.240
44.194.79.229
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 (
- 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();
}
}
}
claimArray[0]
claimArray[0]
bij met uw client-id.claimArray[1]
claimArray[1]
bij met de Salesforce -gebruikersnaam die op basis van de app is geautoriseerd.claimArray[2]
claimArray[2]
bij met de aanmeldings-URL van Salesforce .claimArray[3]
claimArray[3]
bij met een vervaldatum die in milliseconden sinds de epoche-tijd is opgemaakt. 3660624000000
is bijvoorbeeld 12-31-2085./path/to/keystore
/path/to/keystore
door het juiste pad naar het bestand keystore.jkskeystorepassword
keystorepassword
door het wachtwoord voor het doelsleutelarchief.privatekeypassword
privatekeypassword
door het wachtwoord voor het bronsleutelarchief.Volgende stappen
Nadat 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 platform met behulp van API's
In de onderstaande documentatie vindt u informatie over het tot stand brengen van een verbinding tussen Salesforce en Platform via API's of de gebruikersinterface: