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. **Topics** + [Configuration d'une application connectée à Salesforce](#configuring-salesforce-connected-app) + [Utiliser une AWS CloudFormation pile pour configurer les notifications](#configuring-aws-components) ## 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](#manual-creation-of-aws-components) section suivante de ce guide. 1. Connectez-vous à votre organisation Salesforce en tant qu'administrateur système. 1. Dans **Configuration**, dans le champ **Recherche rapide**, entrez**apps**, puis sélectionnez **App Manager**. 1. 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. 1. Procédez comme suit : 1. Dans le champ **Nom de l'application connectée**, entrez le nom de l'application. 1. Dans le champ **E-mail de contact**, entrez votre adresse e-mail. 1. (Facultatif) Complétez les champs restants comme décrit dans [Configurer les paramètres de base des applications connectées](https://help.salesforce.com/s/articleView?id=sf.connected_app_create_basics.htm), dans la documentation Salesforce. 1. 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. 1. 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. 1. 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** 1. 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**. 1. Faites défiler la page vers le bas et choisissez **Enregistrer**. 1. 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. 1. 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. 1. Sous **Informations sur le consommateur**, cliquez sur les boutons **Copier** pour la clé client et le secret client. 1. 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. 1. 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**. 1. Dans la liste **IP Relaxation**, choisissez **Appliquer les restrictions IP**. 1. 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. 1. 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 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 CloudFormation, téléchargez les modèles depuis : **Topics** + [Trouver l'URL de votre domaine](#find-domain-url) + [Utilisation de la CloudFormation pile](#downloading-templates) + [Création manuelle de composants de notification](#manual-creation-of-aws-components) + [Exemple de règles](#example-rules) ### Trouver l'URL de votre domaine Le 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. 1. Dans la section **Configuration**, dans le champ **Recherche rapide**, entrez**my domain**. 1. Dans le volet gauche, sous **Paramètres de l'entreprise**, cliquez sur le lien **Mon domaine**. 1. 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 CloudFormation modèle. ### Utilisation de la CloudFormation pile Les étapes décrites dans les rubriques suivantes expliquent comment créer et déployer une 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. + Intégration de l'API Partner Central : [https://servicecatalogconnector.s3.amazonaws.com/APIDestinationCFT\$1Pcapi.json](https://servicecatalogconnector.s3.amazonaws.com/APIDestinationCFT_PCAPI.json) + AWS Marketplace Intégration (facultative) : [https://servicecatalogconnector.s3.amazonaws.com/APIDestinationCFT\$1 .json AWSMP](https://servicecatalogconnector.s3.amazonaws.com/APIDestinationCFT_AWSMP.json) 1. 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. 1. Toujours dans la console, effectuez une recherche**cloudformation**, puis ouvrez la CloudFormation console. 1. Sur la page **Stacks**, choisissez **Create stack**. 1. Sélectionnez les boutons radio **Choisir un modèle existant** et **Télécharger un fichier modèle**. 1. Sélectionnez **Choisir un fichier** pour ouvrir le modèle téléchargé, puis cliquez sur **Suivant**. 1. 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\$1URL*.** Lorsque vous avez terminé, choisissez **Suivant**. 1. **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.** 1. Sélectionnez **Soumettre**. 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. **Topics** + [Création d'une destination et d'une connexion à l' EventBridge API Amazon](#manual-destination-connection) + [Création d'une EventBridge règle et connexion de celle-ci à la destination de l'API](#create-connect-ev-rule) + [Création d'événements liés aux ensembles de modifications](#change-set-events) + [Création d'une offre : événements publiés](#offer-released-events) + [Création d'événements porteurs d'opportunités](#opportunity-events) + [Types d'événements](#types-of-events) + [Exemple d’évènement](#example-event) #### 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. **Conditions préalables** 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](https://help.salesforce.com/s/articleView?id=sf.connected_app_client_credentials_setup.htm), 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-api-destinations.html#eb-api-destination-create) 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/](https://console.aws.amazon.com/events/), et dans le volet de navigation de gauche, choisissez les **destinations de l'API**. 1. 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. 1. 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 (\$1). Le nom doit être unique pour votre compte dans la région actuelle. 1. (Facultatif) Entrez une **description** de la destination de l'API. 1. 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***. 1. Pour **Méthode HTTP**, sélectionnez **POST**. 1. 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. 1. Pour **Type de destination**, choisissez **Autre**. 1. Choisissez **OAuth Client Credentials**. 1. 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** 1. Pour **Méthode HTTP**, sélectionnez **POST**. 1. Pour l'**ID client**, entrez la clé du consommateur depuis l'application connectée dans Salesforce. 1. Dans le **champ Secret du client**, entrez le secret du consommateur depuis l'application connectée dans Salesforce. 1. Ajoutez les OAuth valeurs suivantes : + **Paramètre** : champ Body + **Clé** : grant\$1type + **Valeur** : client\$1credentials 1. 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](https://help.salesforce.com/s/articleView?id=sf.security_require_2fa_api.htm&language=en_US&type=5) 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 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) 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](https://docs.aws.amazon.com/marketplace/latest/userguide/seller-eventbridge.html#events-changesets), sélectionnez **Rules**. 1. Dans la liste, sélectionnez le bus d'événements souhaité. 1. Dans la section **Rules** (Règles) choisissez **Create rule** (Créer une règle). 1. Entrez le nom de la règle, puis choisissez **Next**. 1. 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns-content-based-filtering.html) dans la AWS documentation. 1. Choisissez **Suivant**. 1. Dans **Sélectionner les cibles**, sous **Cible 1**, sélectionnez la **destination de EventBridge l'API**. 1. Dans la liste, sélectionnez la destination d'API que vous venez de créer. 1. Développer **Additional settings (Paramètres supplémentaires)**. 1. 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 } ``` 1. Choisissez **Next**, puis **Next**. 1. 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-dlq.html) [Amazon SQS dans le guide de l'utilisateur Amazon](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-using-receive-delete-message.html) 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](https://docs.aws.amazon.com/marketplace/latest/userguide/seller-eventbridge.html#events-changesets), choisissez **Rules**. 1. Sélectionnez le bus d'événements souhaité dans la liste. 1. Dans la section **Rules** (Règles) choisissez **Create rule** (Créer une règle). 1. Entrez le nom de votre règle, puis choisissez **Next**. 1. 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 du contenu dans les modèles d' EventBridge événements Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns-content-based-filtering.html) dans le guide de EventBridge l'utilisateur Amazon. 1. Choisissez **Suivant**. 1. 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. 1. Développer **Additional settings (Paramètres supplémentaires)**. 1. 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 } ``` 1. Choisissez **Next** puis **Next**. 1. 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-dlq.html) et la [réception et la suppression de messages (console)](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-using-receive-delete-message.html) 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](https://docs.aws.amazon.com/partner-central/latest/selling-api/opportunity-events.html#aws-eventbridge) #### 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. + [Opportunité créée :](https://docs.aws.amazon.com/partner-central/latest/selling-api/selling-api-events.html#opportunity-created) — Déclenchée lorsqu'une nouvelle opportunité est créée. + [Opportunité mise à jour](https://docs.aws.amazon.com/partner-central/latest/selling-api/selling-api-events.html#opportunity-updated) — Déclenché lorsqu'une opportunité est mise à jour. + [Invitation d'engagement créée](https://docs.aws.amazon.com/partner-central/latest/selling-api/selling-api-events.html#invitation-created) : déclenchée lorsqu'une opportunité est créée. + [Invitation d'engagement acceptée](https://docs.aws.amazon.com/partner-central/latest/selling-api/selling-api-events.html#invitation-accepted) — Déclenchée lorsqu'un partenaire accepte une invitation d' AWS engagement, confirmant son intérêt à collaborer avec AWS cette opportunité. + [Invitation d'engagement rejetée](https://docs.aws.amazon.com/partner-central/latest/selling-api/selling-api-events.html#invitation-rejected) : déclenchée lorsqu'une opportunité est rejetée. #### 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"]
  }
}
|