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.
Rubriques
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.
Connectez-vous à votre organisation Salesforce en tant qu'administrateur système.
Dans Configuration, dans le champ Recherche rapide, entrez
apps
, puis sélectionnez App Manager.-
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.
Procédez comme suit :
Dans le champ Nom de l'application connectée, entrez le nom de l'application.
Dans le champ E-mail de contact, entrez votre adresse e-mail.
(Facultatif) Complétez les champs restants comme décrit dans Configurer les paramètres de base des applications connectées
, dans la documentation Salesforce.
-
Cochez la case Activer OAuth les paramètres, puis procédez comme suit :
Cochez la case Activer pour Device Flow. Vous pouvez ignorer l'URL de rappel qui en résulte.
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.
-
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
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.
Faites défiler la page vers le bas et choisissez Enregistrer.
-
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.
-
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.
Sous Informations sur le consommateur, cliquez sur les boutons Copier pour la clé client et le secret client.
-
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.
-
Choisissez Modifier les politiques, puis procédez comme suit :
Dans la liste des utilisateurs autorisés, choisissez Tous les utilisateurs peuvent s'auto-autoriser.
Dans la liste IP Relaxation, choisissez Appliquer les restrictions IP.
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.
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 :
Rubriques
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
Connectez-vous à Salesforce.
Dans la section Configuration, dans le champ Recherche rapide, entrez
my domain
.Dans le volet gauche, sous Paramètres de l'entreprise, cliquez sur le lien Mon domaine.
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.
-
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_Pcapi.json
-
AWS Marketplace Intégration (facultative) : https://servicecatalogconnector.s3.amazonaws.com/APIDestinationCFT_ .json AWSMP
-
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.
Toujours dans la console, effectuez une recherche
cloudformation
, puis ouvrez la AWS CloudFormation console.Sur la page Stacks, choisissez Create stack.
Sélectionnez les boutons radio Choisir un modèle existant et Télécharger un fichier modèle.
Sélectionnez Choisir un fichier pour ouvrir le modèle téléchargé, puis cliquez sur Suivant.
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).
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.
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.
Rubriques
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
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
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. -
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.
Entrez les informations suivantes :
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.
(Facultatif) Entrez une description de la destination de l'API.
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
Pour Méthode HTTP, sélectionnez POST.
-
Sous Configuration de la connexion, sélectionnez Créer une nouvelle connexion, puis procédez comme suit :
Entrez un nom et une description facultative.
Pour Type de destination, choisissez Autre.
Choisissez OAuth Client Credentials.
-
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 Pour Méthode HTTP, sélectionnez POST.
Pour l'ID client, entrez la clé du consommateur depuis l'application connectée dans Salesforce.
Dans le champ Secret du client, entrez le secret du consommateur depuis l'application connectée dans Salesforce.
Ajoutez les OAuth valeurs suivantes :
Paramètre : champ Body
Clé : grant_type
Valeur : client_credentials
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
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.
-
Dans Amazon EventBridge, sélectionnez Rules.
-
Dans la liste, sélectionnez le bus d'événements souhaité.
-
Dans la section Rules (Règles) choisissez Create rule (Créer une règle).
-
Entrez le nom de la règle, puis choisissez Next.
-
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.
-
Choisissez Suivant.
-
Dans Sélectionner les cibles, sous Cible 1, sélectionnez la destination de EventBridge l'API.
-
Dans la liste, sélectionnez la destination d'API que vous venez de créer.
-
Développer Additional settings (Paramètres supplémentaires).
-
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
} -
Choisissez Next, puis Next.
-
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.
-
Dans la EventBridge console Amazon, choisissez Rules.
-
Sélectionnez le bus d'événements souhaité dans la liste.
-
Dans la section Rules (Règles) choisissez Create rule (Créer une règle).
-
Entrez le nom de votre règle, puis choisissez Next.
-
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.
-
Choisissez Suivant.
-
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.
-
Développer Additional settings (Paramètres supplémentaires).
-
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
} -
Choisissez Next, puis Next.
-
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.
-
Opportunité créée : — Déclenchée lorsqu'une nouvelle opportunité est créée.
-
Opportunité mise à jour — Déclenché lorsqu'une opportunité est mise à jour.
Invitation d'engagement créée : déclenchée lorsqu'une opportunité est créée.
Invitation d'engagement acceptée — 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 : 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 |
|
Opportunité actualisée |
|
Invitation d'engagement créée |
|
Invitation d'engagement acceptée |
|
Invitation d'engagement rejetée |
|
Tous les événements |
|