Configuration de notifications en temps réel pour AWS Partner Central et les AWS Marketplace événements - Centre des partenaires AWS

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configuration de notifications en temps réel pour AWS Partner Central et les AWS Marketplace événements

Les rubriques suivantes expliquent comment configurer des EventBridge notifications en temps réel pour AWS Partner Central et les AWS Marketplace événements. Vous pouvez configurer les notifications dans Salesforce en configurant une application connectée, ou vous pouvez utiliser AWS CloudFormation des modèles.

Configuration d'une application connectée à Salesforce

Les étapes suivantes expliquent comment configurer une application connectée dans Salesforce. Vous devez créer une application connectée afin d'utiliser l' OAuth authentification pour les connexions de destination. Pour plus d'informations, reportez-vous à la Création manuelle de composants de notification section suivante de ce guide.

  1. Connectez-vous à votre organisation Salesforce en tant qu'administrateur système.

  2. Dans Configuration, dans le champ Recherche rapide, entrezapps, puis sélectionnez App Manager.

  3. Sur la page Lightning Experience App Manager, choisissez Nouvelle application connectée, choisissez Créer une application connectée, puis choisissez Continuer.

    La page Nouvelle application connectée s'affiche.

  4. Procédez comme suit :

    1. Dans le champ Nom de l'application connectée, entrez le nom de l'application.

    2. Dans le champ E-mail de contact, entrez votre adresse e-mail.

    3. (Facultatif) Complétez les champs restants comme décrit dans Configurer les paramètres de base des applications connectées, dans la documentation Salesforce.

  5. Cochez la case Activer OAuth les paramètres, puis procédez comme suit :

    1. Cochez la case Activer pour Device Flow. Vous pouvez ignorer l'URL de rappel qui en résulte.

    2. Sous Étendue disponible OAuth , sélectionnez Gérer les données utilisateur via APIs et utilisez le bouton Ajouter pour déplacer l'étendue vers la liste des étendues sélectionnées.

    3. Cochez les cases suivantes :

      • Exiger une clé de preuve pour l'extension PKCE (Proof Key for Code Exchange) pour les flux d'autorisation pris en charge

      • Exiger un secret pour le flux du serveur Web

      • Exiger un secret pour actualiser le flux de jetons

      • Activer le flux d'informations d'identification du client

    4. Dans le message qui apparaît une fois que vous avez sélectionné Activer le flux d'informations d'identification du client, cliquez sur OK.

    5. Faites défiler la page vers le bas et choisissez Enregistrer.

  6. Choisissez Continuer, puis sélectionnez Gérer les informations du consommateur.

    La page de vérification de votre identité apparaît et le système envoie un code de vérification à votre adresse e-mail de contact.

  7. Entrez le code de vérification dans le champ Code de vérification et choisissez Vérifier.

    La page de votre application connectée s'affiche.

  8. Sous Informations sur le consommateur, cliquez sur les boutons Copier pour la clé client et le secret client.

  9. Dans Configuration, dans le champ Recherche rapide, saisissez Applications, sélectionnez Gérer les applications connectées, puis choisissez l'application connectée que vous venez de créer.

  10. Choisissez Modifier les politiques, puis procédez comme suit :

    1. Dans la liste des utilisateurs autorisés, choisissez Tous les utilisateurs peuvent s'auto-autoriser.

    2. Dans la liste IP Relaxation, choisissez Appliquer les restrictions IP.

    3. Dans la liste Exécuter en tant que, sélectionnez l'utilisateur d'exécution, l'utilisateur à qui vous attribuez le flux d'informations d'identification du client. Salesforce demande à l'utilisateur d'exécution de renvoyer les jetons d'accès au nom de l'utilisateur.

    4. Choisissez Enregistrer.

Utiliser une AWS CloudFormation pile pour configurer les notifications

Les rubriques suivantes expliquent comment utiliser des AWS CloudFormation modèles pour configurer des EventBridge notifications en temps réel. Les étapes s'appliquent uniquement aux versions 3.0 et ultérieures du connecteur AWS Partner CRM.

Pour les versions 3.0 et ultérieures du connecteur AWS Partner CRM, vous pouvez utiliser un AWS CloudFormation modèle pour configurer les AWS composants pour l' EventBridge intégration Amazon, ou vous pouvez créer les composants manuellement. Pour les utiliser AWS CloudFormation, téléchargez les modèles depuis :

Trouver l'URL de votre domaine

Le AWS CloudFormation modèle utilise l'URL de votre domaine comme l'un de ses paramètres obligatoires.

Pour trouver l'URL
  1. Connectez-vous à Salesforce.

  2. Dans la section Configuration, dans le champ Recherche rapide, entrezmy domain.

  3. Dans le volet gauche, sous Paramètres de l'entreprise, cliquez sur le lien Mon domaine.

  4. Copiez l'adresse dans la zone URL actuelle de mon domaine.

Note

Vous devez utiliser le préfixe https ://lorsque vous entrez l'URL dans le AWS CloudFormation modèle.

Utilisation de la AWS CloudFormation pile

Les étapes décrites dans les rubriques suivantes expliquent comment créer et déployer une AWS CloudFormation pile qui configure des notifications en temps réel.

  1. Téléchargez les modèles suivants :

    Note

    Vous déployez chaque modèle séparément et vous suivez les mêmes étapes pour les deux.

  2. Dans la AWS console, connectez-vous à votre compte AWS Marketplace vendeur et assurez-vous qu'il fonctionne en Virginie du Nord. EventBridge n'opère que dans cette région.

  3. Toujours dans la console, effectuez une recherchecloudformation, puis ouvrez la AWS CloudFormation console.

  4. Sur la page Stacks, choisissez Create stack.

  5. Sélectionnez les boutons radio Choisir un modèle existant et Télécharger un fichier modèle.

  6. Sélectionnez Choisir un fichier pour ouvrir le modèle téléchargé, puis cliquez sur Suivant.

  7. Sur la page Spécifier les détails de la pile, entrez ce qui suit :

    • Nom de la pile : entrez le nom de la pile.

    • ID client — Entrez la clé client que vous avez indiquée lors de la création de l'application connectée.

    • Secret client — Entrez le secret du consommateur que vous avez noté lors de la création de l'application connectée.

    • URL du domaine : utilisez le format suivant : https://domain_URL.

    Lorsque vous avez terminé, choisissez Next (Suivant).

  8. Sur la page Configurer les options de pile, faites défiler la page jusqu'à la fin, cochez la case Je reconnais que cela AWS CloudFormation pourrait créer des ressources IAM, puis choisissez Suivant.

  9. Sélectionnez Envoyer.

Une fois déployés avec succès, les modèles créent la destination de l'API, la connexion, les règles d'événement et la file d'attente des lettres mortes.

Création manuelle de composants de notification

Les étapes suivantes expliquent comment créer manuellement les composants des EventBridge notifications.

Création d'une destination et d'une connexion à l' EventBridge API Amazon

Pour créer une destination d'API et une entrée de connexion EventBridge, créez une destination d'API qui utilise une nouvelle connexion. Dans ce cas, la destination de l'API est un appel d'API REST à Salesforce pour republier un événement. La connexion contient les informations d'authentification pour l'appel d'API. La connexion accepte plusieurs méthodes d'autorisation.

Prérequis

Pour utiliser l' OAuth autorisation pour la connexion de destination de l'API, créez une application connectée dans Salesforce. Pour ce faire, suivez les étapes décrites dans Configurer une application connectée pour le flux d'informations d'identification client OAuth 2.0, dans la documentation Salesforce. Vous utilisez la clé du consommateur et le secret de l'application connectée pour la connexion de destination de l'API.

Pour créer une destination d'API dans la EventBridge console :

  • Suivez les étapes décrites dans la section Créer une destination d'API dans le guide de EventBridge l'utilisateur Amazon.

  • Configurez les configurations spécifiques à Salesforce.

Dans Salesforce, sur la page Mon domaine, sous Configuration, notez le nom de domaine de votre organisation. Vous l'utilisez pour configurer la destination et la connexion de l'API dans la EventBridge console. Les étapes suivantes expliquent comment procéder.

Pour créer la destination et la connexion
  1. Ouvrez la EventBridge console sur https://console.aws.amazon.com/events/, et dans le volet de navigation de gauche, choisissez les destinations de l'API.

  2. Faites défiler la page jusqu'au tableau des destinations d'API et choisissez Create API destination.

    La page de destination Create API apparaît.

  3. Entrez les informations suivantes :

    1. Nom de la destination de l'API. Vous pouvez utiliser jusqu'à 64 lettres majuscules ou minuscules, des chiffres, des points (.), des tirets (-) ou des traits de soulignement (_).

      Le nom doit être unique pour votre compte dans la région actuelle.

    2. (Facultatif) Entrez une description de la destination de l'API.

    3. Pour le point de terminaison de destination de l'API, utilisez cette URL :https://my-salesforce-domain-name.my.salesforce.com/services/data/v58.0/sobjects/event-api-name.

    4. Pour Méthode HTTP, sélectionnez POST.

  4. Sous Configuration de la connexion, sélectionnez Créer une nouvelle connexion, puis procédez comme suit :

    1. Entrez un nom et une description facultative.

    2. Pour Type de destination, choisissez Autre.

    3. Choisissez OAuth Client Credentials.

    4. Pour le point de terminaison d'autorisation, acceptez le point de terminaison prérempli.

      —OU—

      si vous utilisez une organisation de production, remplacez le point de terminaison renseigné par cette URL :

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

    5. Pour Méthode HTTP, sélectionnez POST.

    6. Pour l'ID client, entrez la clé du consommateur depuis l'application connectée dans Salesforce.

    7. Dans le champ Secret du client, entrez le secret du consommateur depuis l'application connectée dans Salesforce.

    8. Ajoutez les OAuth valeurs suivantes :

      • Paramètre : champ Body

      • Clé : grant_type

      • Valeur : client_credentials

  5. Choisissez Créer.

Note

Si votre organisation Salesforce utilise l'authentification multifactorielle pour accéder à l'API, les utilisateurs doivent effectuer un deuxième défi d'authentification pour accéder à Salesforce APIs. Pour plus d'informations, consultez la section Définir les exigences de connexion à l'authentification multifactorielle pour l'accès aux API dans la documentation Salesforce.

Après avoir créé la destination de l'API, vous pouvez créer une règle qui utilise la cible comme destination.

Création d'une EventBridge règle et connexion de celle-ci à la destination de l'API

EventBridge les règles acheminent les événements du bus d'événements vers la destination de l'API, ce qui entraîne l'envoi d'un appel REST pour republier un événement dans Salesforce.

Pour plus d'informations sur EventBridge les règles, consultez la section Création de EventBridge règles Amazon qui réagissent aux événements dans le guide de EventBridge l'utilisateur Amazon.

Création d'événements liés aux ensembles de modifications

Les étapes suivantes expliquent comment créer des événements d'ensemble de modifications.

  1. Dans Amazon EventBridge, sélectionnez Rules.

  2. Dans la liste, sélectionnez le bus d'événements souhaité.

  3. Dans la section Rules (Règles) choisissez Create rule (Créer une règle).

  4. Entrez le nom de la règle, puis choisissez Next.

  5. Sous Modèle d'événement, sélectionnez Modèles personnalisés (éditeur JSON) et entrez le filtre suivant. Vous pouvez utiliser n'importe quelle combinaison de types de détails.

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

    Pour plus d'informations sur la correspondance des modèles d'événements, consultez la section Filtrage de contenu dans les modèles d' EventBridge événements Amazon dans la AWS documentation.

  6. Choisissez Suivant.

  7. Dans Sélectionner les cibles, sous Cible 1, sélectionnez la destination de EventBridge l'API.

  8. Dans la liste, sélectionnez la destination d'API que vous venez de créer.

  9. Développer Additional settings (Paramètres supplémentaires).

  10. Sous Configurer l'entrée cible, sélectionnez Transformateur d'entrée et Configurer le transformateur d'entrée. Cela garantit que seuls les champs d'événement Salesforce de la section détaillée de l'événement d'origine sont envoyés.

    Le chemin d'entrée doit être : 

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

    Le modèle doit être : 

    {   "Name": Name,   "awsapn__Account_Number__c": awsapn__Account_Number__c,   "awsapn__EntityId__c": awsapn__EntityId__c }
  11. Choisissez Next, puis Next.

  12. Passez en revue la règle, puis choisissez Créer une règle.

Note

Pour résoudre les problèmes liés à une destination d'API, vous pouvez utiliser la console Amazon SQS pour ajouter une file d'attente de lettres mortes à la cible. La file d'attente reçoit les messages qui n'ont pas pu être remis, ainsi que les erreurs. Depuis la console Amazon SQS, vous pouvez interroger les messages de la file d'attente pour détecter les erreurs. Pour plus d'informations, reportez-vous aux sections Utilisation de files d'attente contenant des lettres mortes pour traiter les événements non livrés et Réception et suppression d'un message dans EventBridge Amazon SQS dans le guide de l'utilisateur Amazon SQS.

Création d'une offre : événements publiés

Les étapes suivantes expliquent comment créer des événements de publication d'offres.

  1. Dans la EventBridge console Amazon, choisissez Rules.

  2. Sélectionnez le bus d'événements souhaité dans la liste.

  3. Dans la section Rules (Règles) choisissez Create rule (Créer une règle).

  4. Entrez le nom de votre règle, puis choisissez Next.

  5. Sous Modèle d'événement, sélectionnez Modèles personnalisés (éditeur JSON), puis entrez le filtre suivant : 

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

    Pour plus d'informations sur la correspondance des modèles d'événements, consultez la section Filtrage de contenu dans les modèles d' EventBridge événements Amazon dans le guide de EventBridge l'utilisateur Amazon.

  6. Choisissez Suivant.

  7. Dans Sélectionner les cibles, sous Cible 1, sélectionnez la destination de l'EventBridge API, puis ouvrez la liste et sélectionnez la destination de l'API que vous venez de créer.

  8. Développer Additional settings (Paramètres supplémentaires).

  9. Sous Configurer l'entrée cible, sélectionnez Transformateur d'entrée, puis sélectionnez Configurer le transformateur d'entrée. Cette étape empêche l'envoi des champs d'événements Amazon de niveau supérieur à Salesforce. Seule la partie contenant les champs d'événement Salesforce de la section détaillée de l'événement d'origine est envoyée.

    Utilisez le chemin de saisie suivant : 

    {    "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" }

    Utilisez le modèle suivant : 

    {   "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. Choisissez Next, puis Next.

  11. Passez en revue la règle, puis choisissez Créer une règle.

Note

Pour résoudre les problèmes liés à l'exécution de la destination de l'API, ajoutez une file d'attente de lettres mortes Amazon SQS à la cible. La file d'attente reçoit les messages qui n'ont pas pu être remis ainsi que les erreurs. Vous pouvez ensuite interroger les messages pour voir les erreurs. Pour plus d'informations, consultez la politique de relance des événements et l'utilisation de files d'attente contenant des lettres mortes et la réception et la suppression de messages (console) dans la documentation. AWS

Création d'événements porteurs d'opportunités

Les événements d'opportunité fournissent des notifications en temps réel sur les modifications du statut ou des détails des opportunités

Vous pouvez également créer et gérer des EventBridge règles par programmation à l'aide du. AWS SDKs

Types d'événements

La liste suivante décrit les types d'événements générés lorsque les partenaires travaillent sur des opportunités. Les liens vous redirigent vers la documentation de l'API pour chaque événement.

Exemple d’évènement

{     "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"         }     } }

Exemple de règles

Le tableau suivant répertorie des exemples de EventBridge règles que vous pouvez utiliser avec les événements répertoriés dans la section précédente. Les règles acheminent les événements du bus d'événements vers la destination de l'API, ce qui entraîne l'envoi d'un appel REST pour republier un événement dans Salesforce.

Type d’événement

exemple

Opportunité créée

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

Opportunité actualisée

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

Invitation d'engagement créée

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

Invitation d'engagement acceptée

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

Invitation d'engagement rejetée

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

Tous les événements

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