Verbind Salesforce met Experience Platform gebruikend Flow Service API

Lees deze gids om te leren hoe u uw Salesforce bronrekening met Adobe Experience Platform kunt verbinden gebruikend Flow Service API.

Aan de slag

Deze handleiding vereist een goed begrip van de volgende onderdelen van Adobe Experience Platform:

  • Bronnen: Experience Platform staat gegevens toe om van diverse bronnen worden opgenomen terwijl het voorzien van u van de capaciteit om, inkomende gegevens te structureren te etiketteren en te verbeteren gebruikend Platform diensten.
  • Sandboxen: Experience Platform verstrekt virtuele zandbakken die één enkele Platform instantie in afzonderlijke virtuele milieu's verdelen helpen digitale ervaringstoepassingen ontwikkelen en ontwikkelen.

Platform-API's gebruiken

Voor informatie over hoe te om vraag aan Platform APIs met succes te maken, zie de gids op begonnen wordt met Platform APIs.

Verbinden Salesforce met Experience Platform op Azure azure

Lees de onderstaande stappen voor informatie over hoe u de Salesforce -bron kunt verbinden met het Experience Platform op Azure .

Vereiste referenties verzamelen

De Salesforce -bron ondersteunt basisverificatie en OAuth2 Client Credential.

Basisauthentificatie

Als u uw Salesforce -account wilt verbinden met Flow Service via basisverificatie, geeft u waarden op voor de volgende referenties:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
Credentials Beschrijving
environmentUrl De URL van de broninstantie Salesforce . De notatie voor environmentUrl is https://[domain].my.salesforce.com .
username De gebruikersnaam voor de gebruikersaccount van Salesforce .
password Het wachtwoord voor de Salesforce -gebruikersaccount.
securityToken Het beveiligingstoken voor de gebruikersaccount van Salesforce .
apiVersion (Optioneel) De REST API-versie van de instantie Salesforce die u gebruikt. De waarde voor de API-versie moet met een decimaal worden opgemaakt. Als u bijvoorbeeld API-versie 52 gebruikt, moet u de waarde invoeren als 52.0 . Als dit veld niet wordt ingevuld, gebruikt het Experience Platform automatisch de meest recente beschikbare versie.
connectionSpec.id De verbindingsspecificatie keert de schakelaareigenschappen van een bron, met inbegrip van authentificatiespecificaties met betrekking tot het creëren van de basis en bronverbindingen terug. De verbindingsspecificatie-id voor Salesforce is: cfc0fee1-7dc0-40ef-b73e-d8b134c436f5 .

Voor meer informatie bij begonnen worden, bezoek dit document van Salesforce.

OAuth 2 de Credentials van de Cliënt

Als u uw Salesforce -account wilt verbinden met Flow Service via OAuth 2 Client Credential, geeft u waarden op voor de volgende referenties:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
Credentials Beschrijving
environmentUrl De URL van de broninstantie Salesforce . De notatie voor environmentUrl is https://[domain].my.salesforce.com
clientId De client-id wordt gebruikt in combinatie met het clientgeheim als onderdeel van OAuth2-verificatie. Met de client-id en het clientgeheim kan uw toepassing samen namens uw account werken door uw toepassing aan te duiden op Salesforce .
clientSecret Het clientgeheim wordt gebruikt in combinatie met de client-id als onderdeel van OAuth2-verificatie. Met de client-id en het clientgeheim kan uw toepassing samen namens uw account werken door uw toepassing aan te duiden op Salesforce .
apiVersion De REST API-versie van de instantie Salesforce die u gebruikt. De waarde voor de API-versie moet met een decimaal worden opgemaakt. Als u bijvoorbeeld API-versie 52 gebruikt, moet u de waarde invoeren als 52.0 . Als dit veld niet wordt ingevuld, gebruikt het Experience Platform automatisch de meest recente beschikbare versie. Deze waarde is verplicht voor OAuth2 Client Credential-verificatie.
connectionSpec.id De verbindingsspecificatie keert de schakelaareigenschappen van een bron, met inbegrip van authentificatiespecificaties met betrekking tot het creëren van de basis en bronverbindingen terug. De verbindingsspecificatie-id voor Salesforce is: cfc0fee1-7dc0-40ef-b73e-d8b134c436f5 .

Voor meer informatie bij het gebruiken van OAuth voor Salesforce, lees de Salesforce gids over de Stroom van de Vergunning OAuth.

Een basisverbinding maken voor Salesforce in Experience Platform op Azure

Een basisverbinding behoudt informatie tussen uw bron en Platform, met inbegrip van de de authentificatiegeloofsbrieven van uw bron, de huidige staat van de verbinding, en uw unieke identiteitskaart van de basisverbinding. Met de ID van de basisverbinding kunt u bestanden verkennen en door bestanden navigeren vanuit uw bron en kunt u de specifieke items identificeren die u wilt opnemen, inclusief informatie over hun gegevenstypen en indelingen.

Als u een basisverbinding wilt maken en uw Salesforce -account wilt verbinden met een Experience Platform op Azure , vraagt u een POST naar het /connections -eindpunt en geeft u de Salesforce verificatiegegevens op in de aanvraaginstantie.

API formaat

POST /connections
Basisauthentificatie
accordion
verzoek

Met de volgende aanvraag wordt een basisverbinding voor Salesforce gemaakt met behulp van basisverificatie:

code language-shell
curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "ACME Salesforce account",
      "description": "Salesforce account using basic authentication",
      "auth": {
          "specName": "Basic Authentication",
          "params":
            "environmentUrl": "https://acme-enterprise-3126.my.salesforce.com",
            "username": "acme-salesforce",
            "password": "xxxx",
            "securityToken": "xxxx"
        }
      },
      "connectionSpec": {
          "id": "cfc0fee1-7dc0-40ef-b73e-d8b134c436f5",
          "version": "1.0"
      }
  }'
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
Eigenschap Beschrijving
auth.params.environmentUrl De URL van de instantie Salesforce .
auth.params.username De gebruikersnaam die aan uw Salesforce -account is gekoppeld.
auth.params.password Het wachtwoord dat aan uw Salesforce account is gekoppeld.
auth.params.securityToken Het beveiligingstoken dat aan uw Salesforce -account is gekoppeld.
connectionSpec.id The Salesforce connection specification ID: cfc0fee1-7dc0-40ef-b73e-d8b134c436f5 .
accordion
Response

Een geslaagde reactie retourneert de nieuwe basisverbinding samen met de unieke id.

code language-json
{
    "id": "4cb0c374-d3bb-4557-b139-5712880adc55",
    "etag": "\"1700df7b-0000-0200-0000-5e3b424f0000\""
}
OAuth 2 de Credentials van de Cliënt
accordion
verzoek

Met de volgende aanvraag wordt een basisverbinding voor Salesforce gemaakt met OAuth 2 Client Credential:

code language-shell
curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "ACME Salesforce account",
      "description": "Salesforce account using OAuth 2",
      "auth": {
          "specName": "OAuth2 Client Credential",
          "params":
            "environmentUrl": "https://acme-enterprise-3126.my.salesforce.com",
            "clientId": "xxxx",
            "clientSecret": "xxxx",
            "apiVersion": "60.0"
        }
      },
      "connectionSpec": {
          "id": "cfc0fee1-7dc0-40ef-b73e-d8b134c436f5",
          "version": "1.0"
      }
  }'
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
Eigenschap Beschrijving
auth.params.environmentUrl De URL van de instantie Salesforce .
auth.params.clientId De client-id die aan uw Salesforce -account is gekoppeld.
auth.params.clientSecret Het clientgeheim dat aan uw Salesforce -account is gekoppeld.
auth.params.apiVersion De REST API-versie van de instantie Salesforce die u gebruikt.
connectionSpec.id The Salesforce connection specification ID: cfc0fee1-7dc0-40ef-b73e-d8b134c436f5 .
accordion
Response

Een geslaagde reactie retourneert de nieuwe basisverbinding samen met de unieke id.

code language-json
{
    "id": "4cb0c374-d3bb-4557-b139-5712880adc55",
    "etag": "\"1700df7b-0000-0200-0000-5e3b424f0000\""
}

Verbinding maken Salesforce met Experience Platform op Amazon Web Services (AWS) aws

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

Lees de onderstaande stappen voor informatie over hoe u de Salesforce -bron kunt verbinden met het Experience Platform op AWS.

Vereisten

Voor informatie over hoe te opstelling uw Salesforce rekening om met Experience Platform op AWS te kunnen verbinden, lees het Salesforce overzicht.

Een basisverbinding maken voor Salesforce op Experience Platform op AWS

Als u een basisverbinding wilt maken en uw Salesforce -account wilt verbinden met het Experience Platform op AWS, dient u een verzoek in bij de POST naar het /connections -eindpunt en geeft u de juiste waarden voor uw referenties op.

API formaat

POST /connections

Verzoek

Selecteren om verzoek weer te geven

Met de volgende aanvraag wordt een basisverbinding voor de Salesforce -bron in Experience Platform op AWS gemaakt.

code language-shell
curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "ACME Salesforce account on AWS",
      "description": "ACME Salesforce account on AWS",
      "auth": {
          "specName": "OAuth2 JWT Token Credential",
          "params":
            "jwtToken": "{JWT_TOKEN},
            "clientId": "xxxx",
            "clientSecret": "xxxx",
            "instanceUrl": "https://acme-enterprise-3126.my.salesforce.com"
        }
      },
      "connectionSpec": {
          "id": "cfc0fee1-7dc0-40ef-b73e-d8b134c436f5",
          "version": "1.0"
      }
  }'

Voor informatie over hoe te om uw Salesforce terug te winnen jwtToken, lees de gids op hoe te opstelling a Salesforce bron om met Experience Platform op AWSte verbinden.

Reactie

Selecteren om reactie weer te geven

Een geslaagde reactie retourneert de nieuwe basisverbinding samen met de unieke id.

code language-json
{
    "id": "3e908d3f-c390-482b-9f44-43d3d4f2eb82",
    "etag": "\"1700df7b-0000-0200-0000-5e3b424f0000\""
}

De verbindingsstatus controleren

Om uw verbindingsstatus te verifiëren, doe een verzoek van de GET aan het /connections eindpunt en verstrek identiteitskaart van de basisverbinding die in de aanmaakstap werd geproduceerd.

API formaat

GET /connections

Verzoek

Selecteren om verzoek weer te geven

Met de volgende aanvraag wordt informatie opgehaald voor de id van de basisverbinding: 3e908d3f-c390-482b-9f44-43d3d4f2eb82 .

code language-shell
curl -X GET \
  'https://platform.adobe.io/data/foundation/flowservice/connections/3e908d3f-c390-482b-9f44-43d3d4f2eb82' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'Content-Type: application/json' \

Reactie

initialiserend
accordion
Selecteren om reactievoorbeeld weer te geven

In het volgende antwoord wordt informatie weergegeven voor de basis-verbindings-id: 3e908d3f-c390-482b-9f44-43d3d4f2eb82 in de status initializing .

code language-json
{
  "items": [
    {
      "id": "3e908d3f-c390-482b-9f44-43d3d4f2eb82",
      "createdAt": 1736506325115,
      "updatedAt": 1736506325717,
      "createdBy": "acme@techacct.adobe.com",
      "updatedBy": "acme@techacct.adobe.com",
      "createdClient": "{CREATED_CLIENT}",
      "updatedClient": "{UPDATED_CLIENT}",
      "sandboxId": "{SANDBOX_ID}",
      "sandboxName": "{SANDBOX_NAME}",
      "imsOrgId": "{ORG_ID}",
      "name": "JWT Token Auth Authentication E2E-1736506322",
      "description": "Base Connection for salesforce E2E",
      "connectionSpec": {
        "id": "cfc0fee1-7dc0-40ef-b73e-d8b134c436f5",
        "version": "1.0"
      },
      "state": "initializing",
      "auth": {
        "specName": "OAuth2 JWT Token Credential",
        "params": {
          "jwtToken": "{JWT_TOKEN}",
          "clientId": "{CLIENT_ID}",
          "clientSecret": "{CLIENT_SECRET}",
          "instanceUrl": "https://acme-enterprise-3126.my.salesforce.com"
        }
      }
    }
  }
]
Toegelaten
accordion
Selecteren om reactievoorbeeld weer te geven

In het volgende antwoord wordt informatie weergegeven voor de basis-verbindings-id: 3e908d3f-c390-482b-9f44-43d3d4f2eb82 in de status enabled .

code language-json
{
  "items": [
      {
        "id": "3e908d3f-c390-482b-9f44-43d3d4f2eb82",
        "createdAt": 1736506325115,
        "updatedAt": 1736506413299,
        "createdBy": "acme@techacct.adobe.com",
        "updatedBy": "acme@AdobeID",
        "createdClient": "{CREATED_CLIENT}",
        "updatedClient": "acme",
        "sandboxId": "{SANDBOX_ID}",
        "sandboxName": "{SANDBOX_NAME}",
        "imsOrgId": "{ORG_ID}",
        "name": "JWT Token Auth Authentication E2E-1736506322",
        "description": "Base Connection for salesforce E2E",
        "connectionSpec": {
          "id": "cfc0fee1-7dc0-40ef-b73e-d8b134c436f5",
          "version": "1.0"
        },
        "state": "enabled",
        "auth": {
          "specName": "OAuth2 JWT Token Credential",
          "params": {
            "jwtToken": "{JWT_TOKEN}",
            "clientId": "{CLIENT_ID}",
            "clientSecret": "{CLIENT_SECRET}",
            "instanceUrl": "https://adb8-dev-ed.develop.my.salesforce.com",
            "orgId": "00DdL000001iPRxUAM"
          }
        },
        "version": "\"6d27f305-40be-41c3-97d4-a701827c34df\"",
        "etag": "\"6d27f305-40be-41c3-97d4-a701827c34df\""
    }
  ]
}

Volgende stappen

Aan de hand van deze zelfstudie hebt u een Salesforce basisverbinding gemaakt met de Flow Service API. U kunt deze basis verbindings-id in de volgende zelfstudies gebruiken:

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089