Skapa en API-destination och -anslutning i EventBridge

Skapa en API-destination som använder en ny anslutning. I detta fall är API-destinationen ett REST API-anrop till Salesforce för att publicera en plattformshändelse tillbaka. Anslutningen innehåller autentiseringsinformationen för API-anropet. Anslutningen accepterar flera auktoriseringsmetoder.

1. För att skapa en API-destination i EventBridge Console, följ stegen i Skapa en API-destination i AWS-dokumentationen. Konfigurera sedan de konfigurationer som är specifika för Salesforce.
2. Hämta din Salesforce-organisations Min domän-namn, som finns på sidan Min domän i Inställningar. Du använder namnet i slutpunkten i nästa steg.
3. För händelsen som du vill skicka till Salesforce, använd en befintlig egen plattformshändelse eller definiera en ny. Du kan till exempel skapa en plattformshändelse med etiketten Carbon Estimate (API-namn Carbon_Estimate__e). För att få reda på hur du lägger till fält till en plattformshändelse, se (Valfritt) Definiera en plattformshändelse. Lägg till samma fält som de i händelsen Koldioxidjämförelse. Lägg även till detta fält.
   Fälttyp: Nummer (3,0), Etikett: Procentandel koldioxidminskning
4. För API-destinationsslutpunkt, använd denna URL efter att du ersatt MyDomainName med din organisations domännamn och MyEvent__e med API-namnet på plattformshändelsen för att returnera: https://MyDomainName.my.salesforce.com/services/data/v58.0/sobjects/MyEvent__e
   Till exempel, för händelsen Koldioxiduppskattning är URL:en: https://MyDomainName.my.salesforce.com/services/data/v58.0/sobjects/Carbon_Estimate__e
5. För HTTP-metod, välj POST.
6. För anslutningen, välj Skapa en ny anslutning och ange ett anslutningsnamn.
7. För Destinationstyp, välj Partners och välj sedan Salesforce från Partnerdestinationer.
   Om du konfigurerar OAuth-auktorisering, ange denna information för din Salesforce-organisation.
8. För Auktoriseringstyp, se till att OAuth-klientuppgifter har valts.
9. För Auktoriseringsslutpunkt, ersätt den ifyllda slutpunkten med ett av dessa alternativ.
   1. Om du använder en produktionsorganisation, ange denna URL och ersätt MyDomainName med din organisations Min domän-namn: https://MyDomainName.my.salesforce.com/services/oauth2/token
   2. Om du använder en sandbox utan utökade domäner, ange denna URL och ersätt MyDomainName med din organisations Min domän-namn och SandboxName med ditt sandboxnamn: https://MyDomainName--SandboxName.my.salesforce.com/services/oauth2/token
   3. Om du använder en sandbox med utökade domäner, ange denna URL och ersätt MyDomainName med din organisations Min domän-namn och SandboxName med ditt sandboxnamn: https://MyDomainName--SandboxName.sandbox.my.salesforce.com/services/oauth2/token
10. För HTTP-metod, välj POST.
11. För Klient-ID, ange konsumentnyckeln från den anslutna appen i Salesforce.
12. För Klienthemlighet, ange konsumenthemligheten från den anslutna appen i Salesforce.
13. Lägg till OAuth HTTP-parametrar.
    1. Parameter: Body field, Key: grant_type, Value: client_credentials

Anteckning Om din Salesforce-organisation använder flerfaktorsautentisering (MFA) för API-åtkomst måste användare utföra en andra autentiseringsutmaning för att komma åt Salesforce API. Mer information finns i Ange inloggningskrav för flerfaktorsautentisering för API-åtkomst.

När du har skapat API-destinationen kan du skapa en regel vars mål är destinationen. Se Skapa en EventBridge-regel och anslut den till API-destinationen.