Een API-bestemming en -verbinding maken in EventBridge

Maak een API-bestemming die een nieuwe verbinding gebruikt. In dit geval is de API-bestemming een REST-API-aanroep naar Salesforce om een platformevent terug te publiceren. De verbinding bevat de authenticatiegegevens voor de API-aanroep. De verbinding accepteert verschillende autorisatiemethoden.

1. Als u een API-bestemming wilt maken in de EventBridge-console, volgt u de stappen in Een API-bestemming maken in de AWS-documentatie. Stel vervolgens de configuraties in, die specifiek zijn voor Salesforce.
2. Haal de Mijn domein-naam van uw Salesforce-organisatie op. Die vindt u op de pagina Mijn domein in Set-up. U gebruikt de naam in het eindpunt in de volgende stap.
3. Voor de event die u naar Salesforce wilt verzenden, gebruikt u een bestaande aangepaste platformevent of definieert u een nieuwe. U kunt bijvoorbeeld een platformevent maken met het label Carbon Estimate (API-naam Carbon_Estimate__e). Zie (Optioneel) Een platformevent definiëren voor informatie over het toevoegen van velden aan een platformevent. Voeg dezelfde velden toe als die in de event Carbon Comparison. Voeg ook dit veld toe.
   Veldtype: Getal (3,0), Label: Percentage CO2-reductie
4. Gebruik voor het API-bestemmingseindpunt deze URL nadat u MijnDomeinNaam hebt vervangen door de domeinnaam van uw organisatie en MijnEvent__e door de API-naam van de te retourneren platformevent: https://MyDomainName.my.salesforce.com/services/data/v58.0/sobjects/MyEvent__e
   Voor de event CO2-schatting is de URL bijvoorbeeld: https://MyDomainName.my.salesforce.com/services/data/v58.0/sobjects/Carbon_Estimate__e
5. Selecteer bij HTTP-methode POST.
6. Selecteer voor de verbinding Een nieuwe verbinding maken en geef een verbindingsnaam op.
7. Selecteer als type bestemming Partners en selecteer vervolgens Salesforce bij Partnerbestemmingen.
   Als u OAuth-autorisatie instelt, geeft u deze informatie op voor uw Salesforce-organisatie.
8. Zorg er bij Type autorisatie voor dat OAuth-inloggegevens van client is geselecteerd.
9. Vervang bij Autorisatie-eindpunt het ingevulde eindpunt door een van deze opties.
   1. Als u een productieorganisatie gebruikt, geeft u deze URL op en vervangt u MijnDomeinNaam door de Mijn domein-naam van uw organisatie: https://MyDomainName.my.salesforce.com/services/oauth2/token
   2. Als u een sandbox zonder uitgebreide domeinen gebruikt, geeft u deze URL op en vervangt u MijnDomeinNaam door de Mijn domein-naam van uw organisatie en SandboxNaam door uw sandbox-naam: https://MyDomainName--SandboxName.my.salesforce.com/services/oauth2/token
   3. Als u een sandbox met uitgebreide domeinen gebruikt, geeft u deze URL op en vervangt u MijnDomeinNaam door de Mijn domein-naam van uw organisatie en SandboxNaam door uw sandbox-naam: https://MyDomainName--SandboxName.sandbox.my.salesforce.com/services/oauth2/token
10. Selecteer bij HTTP-methode POST.
11. Geef bij Client-ID de consumentensleutel op uit de verbonden app in Salesforce.
12. Geef bij Clientgeheim het consumentengeheim op uit de verbonden app in Salesforce.
13. Voeg OAuth HTTP-parameters toe.
    1. Parameter: Veld Hoofdtekst, Sleutel: grant_type, Waarde: client_credentials

Opmerking Als uw Salesforce-organisatie multi-factorenauthenticatie (MFA) voor API-toegang gebruikt, moeten gebruikers een tweede authenticatiecontrole voltooien om toegang te krijgen tot Salesforce-API's. Zie Inlogvereisten voor multi-factorenauthenticatie voor API-toegang instellen voor meer informatie.

Nadat u de API-bestemming hebt gemaakt, kunt u een regel maken waarvan het doel de bestemming is. Zie Een EventBridge-regel maken en deze verbinden met de API-bestemming.