Einrichtung von Echtzeitbenachrichtigungen für AWS Partner Central und AWS Marketplace Ereignisse - AWS-Partnerzentrale

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Einrichtung von Echtzeitbenachrichtigungen für AWS Partner Central und AWS Marketplace Ereignisse

In den folgenden Themen wird erklärt, wie Sie EventBridge Echtzeitbenachrichtigungen für AWS Partner Central und AWS Marketplace Ereignisse einrichten. Sie können Benachrichtigungen in Salesforce einrichten, indem Sie eine verbundene Anwendung konfigurieren, oder Sie können AWS CloudFormation Vorlagen verwenden.

Konfiguration einer mit Salesforce verbundenen Anwendung

In den folgenden Schritten wird erklärt, wie Sie eine verbundene Anwendung in Salesforce konfigurieren. Sie müssen eine verbundene Anwendung erstellen, um die OAuth Authentifizierung für Zielverbindungen verwenden zu können. Weitere Informationen finden Sie weiter Manuelles Erstellen von Benachrichtigungskomponenten unten in diesem Handbuch.

  1. Melden Sie sich als Systemadministrator bei Ihrer Salesforce-Organisation an.

  2. Geben Sie unter „Setup“ im Feld „Schnellsuche“ den Text apps App Manager ein und wählen Sie ihn aus.

  3. Wählen Sie auf der Lightning Experience App Manager-SeiteNeue verbundene Anwendung“, wählen Sie „Verbundene Anwendung erstellen“ und anschließend „Fortfahren“.

    Die Seite „Neue verbundene Anwendung“ wird angezeigt.

  4. Gehen Sie wie folgt vor:

    1. Geben Sie im Feld Name der verbundenen App einen Namen für die App ein.

    2. Geben Sie im Feld Kontakt-E-Mail Ihre E-Mail-Adresse ein.

    3. (Optional) Füllen Sie die verbleibenden Felder aus, wie in der Salesforce-Dokumentation unter Grundeinstellungen für verbundene Anwendungen konfigurieren beschrieben.

  5. Aktivieren Sie das Kontrollkästchen OAuth „Einstellungen aktivieren“ und gehen Sie dann wie folgt vor:

    1. Wählen Sie das Kontrollkästchen „Für Gerätefluss aktivieren“ aus. Sie können die resultierende Rückruf-URL ignorieren.

    2. Wählen Sie unter Verfügbare OAuth Bereiche die Option Benutzerdaten verwalten über aus APIs und verschieben Sie den Bereich mithilfe der Schaltfläche Hinzufügen in die Liste der ausgewählten Bereiche.

    3. Wählen Sie die folgenden Kontrollkästchen aus:

      • Für unterstützte Autorisierungsabläufe ist die Erweiterung Proof Key for Code Exchange (PKCE) erforderlich

      • Für den Webserver-Flow ist ein geheimer Schlüssel erforderlich

      • Für den Token-Aktualisierungsfluss ist ein geheimer Schlüssel erforderlich

      • Aktivieren Sie den Fluss der Client-Anmeldeinformationen

    4. Wählen Sie in der Meldung, die angezeigt wird, nachdem Sie „Fluss der Client-Anmeldeinformationen aktivieren“ ausgewählt haben, die Option OK aus.

    5. Scrollen Sie auf der Seite nach unten und wählen Sie Speichern aus.

  6. Wählen Sie „Weiter“ und anschließend „Kundendaten verwalten“.

    Die Seite „Verifizieren Sie Ihre Identität“ wird angezeigt, und das System sendet einen Bestätigungscode an Ihre Kontakt-E-Mail-Adresse.

  7. Geben Sie den Bestätigungscode in das Feld Bestätigungscode ein und wählen Sie Verifizieren aus.

    Die Seite für Ihre verbundene App wird angezeigt.

  8. Wählen Sie unter Kundendetails die Schaltflächen Kopieren für den Verbraucherschlüssel und das Kundengeheimnis aus.

  9. Geben Sie unter „Setup“ im Feld „Schnellsuche“ den Text Apps ein, wählen Sie Verbundene Apps verwalten aus und wählen Sie dann die verbundene App aus, die Sie gerade erstellt haben.

  10. Wähle „Richtlinien bearbeiten“ und gehe dann wie folgt vor:

    1. Wählen Sie in der Liste Zulässige Benutzer die Option Alle Benutzer können sich selbst autorisieren aus.

    2. Wählen Sie in der Liste IP-Entspannung die Option IP-Einschränkungen erzwingen aus.

    3. Wählen Sie aus der Liste „Ausführen als“ den Ausführungsbenutzer aus, d. h. den Benutzer, dem Sie den Client-Anmeldeinformationsfluss zuweisen. Salesforce verlangt vom Ausführungsbenutzer, dass er Zugriffstoken im Namen des Benutzers zurückgibt.

    4. Wählen Sie Speichern.

Verwenden eines AWS CloudFormation Stacks zum Einrichten von Benachrichtigungen

In den folgenden Themen wird erklärt, wie Sie mithilfe von AWS CloudFormation Vorlagen EventBridge Benachrichtigungen in Echtzeit einrichten können. Die Schritte gelten nur für Version 3.0 und höher des AWS Partner CRM-Connectors.

Für AWS Partner CRM Connector Version 3.0 und höher können Sie eine AWS CloudFormation Vorlage verwenden, um die AWS Komponenten für die EventBridge Amazon-Integration zu konfigurieren, oder Sie können die Komponenten manuell erstellen. Um sie zu verwenden AWS CloudFormation, laden Sie die Vorlagen herunter von:

Finden Sie Ihre Domain-URL

Die AWS CloudFormation Vorlage verwendet Ihre Domain-URL als einen der erforderlichen Parameter.

Um die URL zu finden
  1. Melden Sie sich bei Salesforce an.

  2. Geben Sie im Abschnitt Setup im Feld Schnellsuche den Text einmy domain.

  3. Wählen Sie im linken Bereich unter Unternehmenseinstellungen den Link Meine Domain aus.

  4. Kopieren Sie die Adresse in das Feld Aktuelle URL für meine Domain.

Anmerkung

Sie müssen das Präfix https://verwenden, wenn Sie die URL in die AWS CloudFormation Vorlage eingeben.

Den AWS CloudFormation Stack verwenden

Die Schritte in den folgenden Themen erläutern, wie Sie einen AWS CloudFormation Stack erstellen und bereitstellen, der Benachrichtigungen in Echtzeit einrichtet.

  1. Laden Sie die folgenden Vorlagen herunter:

    Anmerkung

    Sie stellen jede Vorlage separat bereit und befolgen für beide die gleichen Schritte.

  2. Melden Sie sich in der AWS Konsole bei Ihrem AWS Marketplace Verkäuferkonto an und stellen Sie sicher, dass es in Nord-Virginia läuft. EventBridge ist nur in dieser Region tätig.

  3. Suchen Sie immer noch in der Konsole nach cloudformation und öffnen Sie dann die AWS CloudFormation Konsole.

  4. Wählen Sie auf der Seite Stacks die Option Create Stack aus.

  5. Wählen Sie die Optionsfelder Eine vorhandene Vorlage auswählen und Eine Vorlagendatei hochladen aus.

  6. Wählen Sie „Datei auswählen“, um die heruntergeladene Vorlage zu öffnen, und klicken Sie dann auf Weiter.

  7. Geben Sie auf der Seite „Stack-Details angeben“ Folgendes ein:

    • Stackname — Geben Sie einen Namen für den Stack ein.

    • Client-ID — Geben Sie den Verbraucherschlüssel ein, den Sie sich bei der Erstellung der verbundenen App notiert haben.

    • Kundengeheimnis — Geben Sie das Verbrauchergeheimnis ein, das Sie sich bei der Erstellung der verbundenen App notiert haben.

    • Domain-URL — Verwenden Sie das folgende Format: https://domain_URL.

    Wenn Sie fertig sind, wählen Sie Weiter.

  8. Scrollen Sie auf der Seite „Stack-Optionen konfigurieren“ bis zum Ende, aktivieren Sie das Kontrollkästchen Ich bestätige, dass AWS CloudFormation möglicherweise IAM-Ressourcen erstellt werden, und wählen Sie dann Weiter aus.

  9. Wählen Sie Absenden aus.

Bei erfolgreicher Bereitstellung erstellen die Vorlagen das API-Ziel, die Verbindung, die Ereignisregeln und die Warteschlange für unzulässige Briefe.

Manuelles Erstellen von Benachrichtigungskomponenten

In den folgenden Schritten wird erklärt, wie Sie die Komponenten für EventBridge Benachrichtigungen manuell erstellen.

Erstellen Sie ein EventBridge Amazon-API-Ziel und eine Verbindung

Um ein API-Ziel und eine Verbindung zu erstellen EventBridge, erstellen Sie ein API-Ziel, das eine neue Verbindung verwendet. In diesem Fall ist das API-Ziel ein REST-API-Aufruf an Salesforce, um ein Ereignis zu veröffentlichen. Die Verbindung enthält die Authentifizierungsinformationen für den API-Aufruf. Die Verbindung akzeptiert mehrere Autorisierungsmethoden.

Voraussetzungen

Um die OAuth Autorisierung für die API-Zielverbindung zu verwenden, erstellen Sie eine verbundene Anwendung in Salesforce. Folgen Sie dazu den Schritten unter Konfigurieren einer verbundenen Anwendung für den OAuth 2.0-Client-Anmeldeinformationsfluss in der Salesforce-Dokumentation. Sie verwenden den Consumer-Key und das Secret der verbundenen Anwendung für die API-Zielverbindung.

So erstellen Sie ein API-Ziel in der EventBridge Konsole:

  • Folgen Sie den Schritten unter API-Ziel erstellen im EventBridge Amazon-Benutzerhandbuch.

  • Richten Sie die Konfigurationen ein, die für Salesforce spezifisch sind.

Notieren Sie sich in Salesforce auf der Seite Meine Domäne unter Setup den Domainnamen Ihrer Organisation. Sie verwenden ihn, um das API-Ziel und die Verbindung in der EventBridge Konsole einzurichten. In den folgenden Schritten wird erklärt, wie.

Um das Ziel und die Verbindung zu erstellen
  1. Öffnen Sie die EventBridge Konsole https://console.aws.amazon.com/events/unter und wählen Sie im linken Navigationsbereich API-Ziele aus.

  2. Scrollen Sie nach unten zur Tabelle mit den API-Zielen und wählen Sie API-Ziel erstellen aus.

    Die Seite „API-Ziel erstellen“ wird angezeigt.

  3. Geben Sie die folgenden Informationen ein:

    1. Ein Name für das API-Ziel. Sie können bis zu 64 Groß- oder Kleinbuchstaben, Zahlen, Punkte (.), Bindestriche (-) oder Unterstriche (_) verwenden.

      Der Name muss für das Konto in der aktuellen Region eindeutig sein.

    2. (Optional) Geben Sie eine Beschreibung des API-Ziels ein.

    3. Verwenden Sie für den API-Zielendpunkt diese URL:https://my-salesforce-domain-name.my.salesforce.com/services/data/v58.0/sobjects/event-api-name.

    4. Wählen Sie für HTTP-Methode POST aus.

  4. Wählen Sie unter Verbindungskonfiguration die Option Neue Verbindung erstellen aus und gehen Sie dann wie folgt vor:

    1. Geben Sie einen Namen und optional eine Beschreibung ein.

    2. Wählen Sie als Zieltyp die Option Andere aus.

    3. Wählen Sie OAuth Client-Anmeldeinformationen aus.

    4. Akzeptieren Sie als Autorisierungsendpunkt den vorab ausgefüllten Endpunkt.

      -ODER-

      Wenn Sie eine Produktionsorganisation verwenden, ersetzen Sie den ausgefüllten Endpunkt durch diese URL:

      https://my-salesforce-domain-name.my.salesforce.com/services/oauth2/token

    5. Wählen Sie für HTTP-Methode POST aus.

    6. Geben Sie als Client-ID den Verbraucherschlüssel aus der verbundenen Anwendung in Salesforce ein.

    7. Geben Sie für Client Secret den Consumer Secret aus der verbundenen Anwendung in Salesforce ein.

    8. Fügen Sie die folgenden OAuth Werte hinzu:

      • Parameter: Feld „Körper“

      • Schlüssel: grant_type

      • Wert: client_credentials

  5. Wählen Sie Erstellen aus.

Anmerkung

Wenn Ihre Salesforce-Organisation die Multi-Faktor-Authentifizierung für den API-Zugriff verwendet, müssen Benutzer eine zweite Authentifizierungsherausforderung abschließen, um auf Salesforce zuzugreifen. APIs Weitere Informationen finden Sie in der Salesforce-Dokumentation unter Festlegen der Anmeldeanforderungen für die Multi-Faktor-Authentifizierung für den API-Zugriff.

Nachdem Sie das API-Ziel erstellt haben, können Sie eine Regel erstellen, die das Ziel als Ziel verwendet.

Eine EventBridge Regel erstellen und sie mit dem API-Ziel verbinden

EventBridge Regeln leiten Ereignisse vom Event-Bus an das API-Ziel weiter, was dazu führt, dass ein REST-Aufruf ausgeführt wird, um ein Ereignis zurück in Salesforce zu veröffentlichen.

Weitere Informationen zu EventBridge Regeln finden Sie im EventBridge Amazon-Benutzerhandbuch unter Erstellen von EventBridge Amazon-Regeln, die auf Ereignisse reagieren.

Änderungsset-Ereignisse erstellen

In den folgenden Schritten wird erklärt, wie Sie Änderungsset-Ereignisse erstellen.

  1. Wählen Sie in Amazon EventBridge Regeln aus.

  2. Wählen Sie aus der Liste den gewünschten Event-Bus aus.

  3. Wählen Sie im Abschnitt Rules (Regeln) die Option Create rule (Regel erstellen) aus.

  4. Geben Sie einen Namen für die Regel ein und wählen Sie dann Weiter.

  5. Wählen Sie unter Ereignismuster die Option Benutzerdefinierte Muster (JSON-Editor) aus und geben Sie den folgenden Filter ein. Sie können eine beliebige Kombination von Detailtypen verwenden.

    {   "source": [     "aws.marketplacecatalog"   ],   "detail-type": [     "Change Set Succeeded",     "Change Set Failed",     "Change Set Cancelled"   ] }

    Weitere Informationen zum Abgleich von Ereignismustern finden Sie in der AWS Dokumentation unter Inhaltsfilterung in EventBridge Amazon-Ereignismustern.

  6. Wählen Sie Weiter aus.

  7. Wählen Sie unter Ziele auswählen unter Ziel 1 die Option EventBridge API-Ziel aus.

  8. Wählen Sie aus der Liste das API-Ziel aus, das Sie gerade erstellt haben.

  9. Erweitern Sie Additional settings (Zusätzliche Einstellungen).

  10. Wählen Sie unter Zieleingabe konfigurieren die Optionen Eingangstransformator und Eingangstransformator konfigurieren aus. Dadurch wird sichergestellt, dass nur die Salesforce-Ereignisfelder aus dem Detailbereich des ursprünglichen Ereignisses gesendet werden.

    Der Eingabepfad muss wie folgt lauten: 

    {   "Name": "$.detail-type",   "awsapn__Account_Number__c": "$.account",   "awsapn__EntityId__c": "$.detail.ChangeSetId" }

    Die Vorlage muss wie folgt aussehen: 

    {   "Name": Name,   "awsapn__Account_Number__c": awsapn__Account_Number__c,   "awsapn__EntityId__c": awsapn__EntityId__c }
  11. Wählen Sie Weiter und dann Weiter.

  12. Überprüfen Sie die Regel und wählen Sie dann Regel erstellen aus.

Anmerkung

Um Probleme mit einem API-Ziel zu beheben, können Sie die Amazon SQS SQS-Konsole verwenden, um dem Ziel eine Warteschlange für unzustellbare Briefe hinzuzufügen. Die Warteschlange empfängt Nachrichten, die nicht zugestellt werden konnten, sowie die Fehler. Von der Amazon SQS SQS-Konsole aus können Sie Nachrichten in der Warteschlange nach Fehlern abfragen. Weitere Informationen finden Sie unter Verwenden von Warteschlangen mit unzustellbaren Nachrichten zur Verarbeitung nicht zugestellter Ereignisse in EventBridge Amazon SQS und Empfangen und Löschen einer Nachricht in Amazon SQS im Amazon SQS-Benutzerhandbuch.

Angebot erstellen | Veröffentlichte Ereignisse

In den folgenden Schritten wird erklärt, wie Sie Offer Released-Events erstellen.

  1. Wählen Sie in der EventBridgeAmazon-Konsole Regeln aus.

  2. Wählen Sie den gewünschten Event-Bus aus der Liste aus.

  3. Wählen Sie im Abschnitt Rules (Regeln) die Option Create rule (Regel erstellen) aus.

  4. Geben Sie einen Namen für Ihre Regel ein und wählen Sie dann Weiter.

  5. Wählen Sie unter Ereignismuster die Option Benutzerdefinierte Muster (JSON-Editor) aus und geben Sie dann den folgenden Filter ein: 

    {   "source": [     "aws.marketplacecatalog"   ],   "detail-type": [     "Offer Released"   ] }

    Weitere Informationen zum Abgleich von Ereignismustern finden Sie unter Inhaltsfilterung in EventBridge Amazon-Ereignismustern im EventBridge Amazon-Benutzerhandbuch.

  6. Wählen Sie Weiter aus.

  7. Wählen Sie unter Ziele auswählen unter Ziel 1 die Option EventBridge API-Ziel aus, öffnen Sie dann die Liste und wählen Sie das API-Ziel aus, das Sie gerade erstellt haben.

  8. Erweitern Sie Additional settings (Zusätzliche Einstellungen).

  9. Wählen Sie unter Zieleingang konfigurieren die Option Eingangstransformator aus und wählen Sie Eingangstransformator konfigurieren aus. Dieser Schritt verhindert, dass die Amazon-Ereignisfelder der obersten Ebene an Salesforce gesendet werden. Nur der Teil, der die Salesforce-Ereignisfelder aus dem Detailbereich des ursprünglichen Ereignisses enthält, wird gesendet.

    Verwenden Sie den folgenden Eingabepfad: 

    {    "Name":"$.detail-type",    "awsapn__Account_Number__c":"$.account",    "awsapn__EntityId__c":"$.detail.offer.id",    "awsapn__Manufacturer_Account_Id__c":"$.detail.manufacturer.accountId",    "awsapn__Product_Id__c":"$.detail.product.id",    "awsapn__Seller_Account_Id__c":"$.detail.sellerOfRecord.accountId" }

    Verwenden Sie die folgende Vorlage: 

    {   "Name": Name,   "awsapn__Account_Number__c": awsapn__Account_Number__c,   "awsapn__EntityId__c": awsapn__EntityId__c,   "awsapn__Seller_Account_Id__c": awsapn__Seller_Account_Id__c,   "awsapn__Manufacturer_Account_Id__c": awsapn__Manufacturer_Account_Id__c,   "awsapn__Product_Id__c": awsapn__Product_Id__c }
  10. Wählen Sie Weiter und dann Weiter.

  11. Überprüfen Sie die Regel und wählen Sie dann Regel erstellen aus.

Anmerkung

Um Fehler bei der Ausführung des API-Ziels zu beheben, fügen Sie dem Ziel eine Amazon SQS SQS-Warteschlange für unzustellbare Briefe hinzu. Die Warteschlange empfängt die Nachrichten, die nicht zugestellt werden konnten, zusammen mit den Fehlern. Anschließend können Sie die Nachrichten abfragen, um sich die Fehler anzusehen. Weitere Informationen finden Sie in der Dokumentation unter Richtlinie zur Wiederholung von Ereignissen und Verwenden von Warteschlangen mit unerlaubten Nachrichten und Empfangen und Löschen von Nachrichten (Konsole). AWS

Opportunity-Ereignisse erstellen

Opportunity-Ereignisse bieten Benachrichtigungen in Echtzeit über Änderungen des Status oder der Einzelheiten von Opportunities

Mit dem können Sie EventBridge Regeln auch programmgesteuert erstellen und verwalten. AWS SDKs

Arten von Ereignissen

In der folgenden Liste werden die Ereignistypen beschrieben, die generiert werden, wenn Partner mit Opportunities arbeiten. Über die Links gelangen Sie zur API-Dokumentation für jede Veranstaltung.

Beispielereignis

{     "version": "1",     "id": ""d1example-0c9c-4655-15bf-c5exampleb08",     "source": "aws.partnercentral-selling",     "detail-type": "Opportunity Created",     "time": ""2023-10-28T13:31:05Z",     "region": ""us-east-1",     "account": ""123456789123",     "detail": {          "schemaVersion": "1",         "catalog": "AWS",         "opportunity": {             "identifier": ""O1234567",             "url": "Partner Central Opportunity Page URL"         }     } }

Beispielregeln

In der folgenden Tabelle sind Beispiele für EventBridge Regeln aufgeführt, die Sie für die im vorherigen Abschnitt aufgeführten Ereignisse verwenden können. Regeln leiten Ereignisse vom Event-Bus an das API-Ziel weiter, was dazu führt, dass ein REST-Aufruf ausgeführt wird, um ein Ereignis zurück in Salesforce zu veröffentlichen.

Ereignistyp

Beispiel

Gelegenheit geschaffen

{   "source": ["aws.partnercentral-selling"],   "detail-type": ["Opportunity Created"],   "detail": {     "catalog": ["AWS"]   } }

Opportunity aktualisiert

{   "source": ["aws.partnercentral-selling"],   "detail-type": ["Opportunity Updated"],   "detail": {     "catalog": ["AWS"]   } }

Einladung zur Verlobung erstellt

{   "source": ["aws.partnercentral-selling"],   "detail-type": ["Engagement Invitation Created"],   "detail": {     "catalog": ["AWS"]   } }

Einladung zur Verlobung akzeptiert

{   "source": ["aws.partnercentral-selling"],   "detail-type": ["Engagement Invitation Accepted"],   "detail": {     "catalog": ["AWS"]   } }

Einladung zur Verlobung abgelehnt

{   "source": ["aws.partnercentral-selling"],   "detail-type": ["Engagement Invitation Rejected"],   "detail": {     "catalog": ["AWS"]   } }

Alle Ereignisse

{   "source": ["aws.partnercentral-selling"],   "detail": {     "catalog": ["AWS"]   } }