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

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-Seite „Neue 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.

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.

1. Laden Sie die folgenden Vorlagen herunter:

   Anmerkung

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

   • API-Integration in Partner Central: https://servicecatalogconnector.s3.amazonaws.com/APIDestinationcft_pcapi.json

   • (Optionale) Integration:/CFT_ .json AWS Marketplace https://servicecatalogconnector.s3.amazonaws.com APIDestination AWSMP

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.

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.

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.