• Accueil / Pardot / API Pardot et…
, API Pardot et préparation avec les utilisateurs SSO de Salesforce<span class="wtr-time-wrap after-title"><span class="wtr-time-number">8</span> minutes de lecture</span>

API Pardot et préparation avec les utilisateurs SSO de Salesforce8 minutes de lecture


PAR ADAM ERSTELLE

En juin, Salesforce a annoncé que la façon dont nous travaillons avec l’API Pardot allait changer et qu’à partir de début 2021, tous les utilisateurs de Pardot devront utiliser l’authentification unique Salesforce. En préparation de ce changement, certains services ont commencé à déployer leurs mises à jour, mais comment vous préparez-vous en tant qu’administrateur Pardot?

Cet article de blog fournira des instructions étape par étape sur la façon de se préparer, où rassembler toutes les informations critiques dont vous avez besoin, et un guide rapide sur les tests que vous êtes prêt pour ces changements.

Avant de plonger, vous devrez peut-être prendre en compte quelque chose: vous avez la possibilité d’avoir un seul utilisateur Salesforce avec plusieurs applications connectées (une pour chaque intégration) .Vous avez également la possibilité d’une seule application connectée avec plusieurs utilisateurs Salesforce ( un pour chaque intégration) ainsi que toute combinaison des deux options.

Notre recommandation est d’avoir une seule application connectée et plusieurs utilisateurs Salesforce (avec des licences d’identité CRM du bundle fourni par Pardot). Cette option crée une connexion directe entre l’utilisateur Pardot et l’application et permet aux administrateurs Pardot d’identifier facilement quelle connexion API a apporté des modifications à Pardot si un problème survient.

Si vous ne disposez pas du nombre de licences disponibles pour que cela fonctionne, essayez de segmenter vos intégrations en quelque chose qui a du sens. Assurez-vous simplement que la combinaison de l’application connectée et de l’utilisateur est différente pour chaque intégration (surtout si elle est tierce).

OK, allons-y. Voici les étapes à suivre pour configurer les utilisateurs Pardot avec l’authentification unique Salesforce.

Étape 1: configurer un utilisateur Salesforce

  1. Dans la configuration de Salesforce, recherchez les utilisateurs et cliquez sur Nouvel utilisateur
    , API Pardot et préparation avec les utilisateurs SSO de Salesforce<span class="wtr-time-wrap after-title"><span class="wtr-time-number">8</span> minutes de lecture</span>
  2. Pour cet utilisateur, essayez de garder l’intégration spécifique. Si vous avez 5 intégrations, prévoyez de créer 5 utilisateurs. Utilisez un nom d’utilisateur unique indiquant le but de cette intégration et assurez-vous de sélectionner la licence d’utilisateur d’identité. (Si vous choisissez une autre licence par erreur, vous ne pouvez pas rétrograder la licence vers Identity, alors soyez prudent!)
    , API Pardot et préparation avec les utilisateurs SSO de Salesforce<span class="wtr-time-wrap after-title"><span class="wtr-time-number">8</span> minutes de lecture</span>
  3. Enregistrez le nouvel utilisateur, puis activez le compte à partir de l’e-mail que Salesforce a envoyé (je le fais généralement dans un nouveau navigateur privé / mode de navigation privée).
  4. Dans le cadre de l’activation du compte, choisissez un nouveau mot de passe très fort.
  5. Maintenant que vous y êtes, vous devrez générer un jeton de sécurité. Cliquez sur votre utilisateur en haut à droite, puis accédez à Mes paramètres.
    , API Pardot et préparation avec les utilisateurs SSO de Salesforce<span class="wtr-time-wrap after-title"><span class="wtr-time-number">8</span> minutes de lecture</span>
  6. Accédez à Réinitialiser mon jeton de sécurité, puis cliquez sur le bouton.
    , API Pardot et préparation avec les utilisateurs SSO de Salesforce<span class="wtr-time-wrap after-title"><span class="wtr-time-number">8</span> minutes de lecture</span>
  7. Vous devriez recevoir un jeton dans votre e-mail. Gardez ceci, vous en aurez besoin plus tard. Vous pouvez maintenant fermer votre navigateur privé / incognito, car le reste des étapes se fera avec vos comptes principaux.

Étape 2: Configurer l’utilisateur Pardot

Maintenant que notre utilisateur Salesforce a été configuré, nous devons créer un utilisateur Pardot avec lequel il sera synchronisé.

  1. Dans Salesforce, lancez l’application Pardot, accédez à Paramètres Pardot, Utilisateurs et Ajouter un utilisateur
    , API Pardot et préparation avec les utilisateurs SSO de Salesforce<span class="wtr-time-wrap after-title"><span class="wtr-time-number">8</span> minutes de lecture</span>
  2. Indiquez le nom et l’adresse e-mail que vous avez utilisés pour l’utilisateur Salesforce
    , API Pardot et préparation avec les utilisateurs SSO de Salesforce<span class="wtr-time-wrap after-title"><span class="wtr-time-number">8</span> minutes de lecture</span>
  3. Facultatif, mais recommandé: notez le fuseau horaire, ou ajustez-le pour qu’il corresponde au fuseau horaire dans lequel l’intégration est en cours d’exécution. Si ceux-ci ne correspondent pas, vous pourriez obtenir des résultats vraiment étranges plus tard lorsque vous utiliserez l’API en raison des différences. dans les limites du jour si vous utilisez des requêtes basées sur la date / heure.
  4. Sélectionnez le nom d’utilisateur CRM que vous venez de créer dans Salesforce (vous devrez probablement actualiser la liste des utilisateurs). Choisissez également le rôle. Le directeur des ventes vous donnera accès aux données du prospect, et pas grand-chose pour les actifs Pardot, le marketing vous donnera probablement ce dont la plupart des intégrations d’API Pardot ont besoin pour accéder, mais si vous devez créer des champs personnalisés, vous devrez accorder le rôle d’administrateur. Les rôles personnalisés pour le contrôle d’accès aux API sont également pris en charge et recommandés si vous y avez accès.
    , API Pardot et préparation avec les utilisateurs SSO de Salesforce<span class="wtr-time-wrap after-title"><span class="wtr-time-number">8</span> minutes de lecture</span>
  5. Facultatif, mais recommandé: désactivez tous les e-mails qui seront envoyés à la boîte aux lettres de l’utilisateur d’intégration.
  6. Cliquez sur Créer un utilisateur
  7. Cliquez sur le lien Activer l’authentification unique Salesforce pour terminer ce processus.
    , API Pardot et préparation avec les utilisateurs SSO de Salesforce<span class="wtr-time-wrap after-title"><span class="wtr-time-number">8</span> minutes de lecture</span>

Étape 3: créer une application connectée Salesforce

Si vous avez suivi, vous remarquerez que presque toutes les étapes précédentes étaient assez standard pour tout utilisateur SSO, et vous avez raison! Outre le jeton de sécurité, ce truc est assez simple.

La prochaine étape est celle où les documents d’authentification Pardot ne donnent pas vraiment beaucoup de conseils, mais nous vous avons compris.

  1. Passer à Salesforce Classic Experience
    , API Pardot et préparation avec les utilisateurs SSO de Salesforce<span class="wtr-time-wrap after-title"><span class="wtr-time-number">8</span> minutes de lecture</span>
  2. Dans la configuration, accédez à Build, Create, Apps
    , API Pardot et préparation avec les utilisateurs SSO de Salesforce<span class="wtr-time-wrap after-title"><span class="wtr-time-number">8</span> minutes de lecture</span>
  3. La page Applications comporte quelques sections. Faites défiler vers le bas jusqu’à Applications connectées, puis cliquez sur Nouveau
    , API Pardot et préparation avec les utilisateurs SSO de Salesforce<span class="wtr-time-wrap after-title"><span class="wtr-time-number">8</span> minutes de lecture</span>
  4. Remplissez les informations de base, Activez les paramètres OAuth, spécifiez l’URL de rappel et sélectionnez l’étendue OAuth d’accès aux services Pardot. Certaines intégrations peuvent vous demander d’inclure les demandes d’exécution en votre nom à tout moment, vous devrez donc peut-être l’inclure également.
    , API Pardot et préparation avec les utilisateurs SSO de Salesforce<span class="wtr-time-wrap after-title"><span class="wtr-time-number">8</span> minutes de lecture</span>
  5. Vous n’avez pas besoin de mettre quoi que ce soit dans les autres sections (Paramètres de l’application Web, Gestionnaire d’applications connectées personnalisées, Paramètres de l’application mobile, Paramètres de l’application Canvas). Cliquez sur Enregistrer
  6. Vous pouvez être invité à attendre un moment avant d’utiliser cette application. Cliquez sur Continuer
  7. Presque fini! Il vous suffit de copier la clé du consommateur et le secret du consommateur.

Étape 4: Obtenez la Business Unit Pardot

Une dernière information nécessaire, l’ID de l’unité commerciale Pardot avec laquelle vous utiliserez l’API. Vous devez effectuer cette étape même si vous n’utilisez pas la fonction «Plusieurs unités commerciales». Les étapes sont les mêmes pour un seul compte Pardot, il suffit de suivre.

  1. Revenez à Lightning Experience, lancez le programme d’installation
  2. Recherchez Pardot Setup Home, cliquez sur Assign Admin pour accéder à la liste des Business Units
    , API Pardot et préparation avec les utilisateurs SSO de Salesforce<span class="wtr-time-wrap after-title"><span class="wtr-time-number">8</span> minutes de lecture</span>
  3. Saisissez votre identifiant d’unité commerciale.
    , API Pardot et préparation avec les utilisateurs SSO de Salesforce<span class="wtr-time-wrap after-title"><span class="wtr-time-number">8</span> minutes de lecture</span>

Étape 5: Tout tester

Très bien, maintenant que nous avons toutes les informations, testons-les. Notre outil préféré pour tester les API est Postman, et nous avons créé un Collection Postman pour Pardot cela devrait vous aider à démarrer.

  1. Installer Postman et importez notre collection.
  2. Cliquez sur le bouton Configuration de l’environnement afin de pouvoir fournir les informations que nous avons intégrées à toutes les étapes précédentes.
    , API Pardot et préparation avec les utilisateurs SSO de Salesforce<span class="wtr-time-wrap after-title"><span class="wtr-time-number">8</span> minutes de lecture</span>
  3. Cliquez sur Pardot API – Salesforce SSO pour configurer cet environnement
    , API Pardot et préparation avec les utilisateurs SSO de Salesforce<span class="wtr-time-wrap after-title"><span class="wtr-time-number">8</span> minutes de lecture</span>
  4. Fournissez toutes les informations pertinentes, cliquez sur le lien Réinitialiser tout, puis faites défiler vers le bas pour cliquer sur Mettre à jour
    , API Pardot et préparation avec les utilisateurs SSO de Salesforce<span class="wtr-time-wrap after-title"><span class="wtr-time-number">8</span> minutes de lecture</span>
    , API Pardot et préparation avec les utilisateurs SSO de Salesforce<span class="wtr-time-wrap after-title"><span class="wtr-time-number">8</span> minutes de lecture</span>
    1. Si vous utilisez la fonction Pardot «Autoriser plusieurs prospects avec la même adresse e-mail», vous devez spécifier api_version 4.
    2. Si vous utilisez une instance de démonstration de Pardot, vous devez changer le pardot_domain en pi.demo.pardot.com
    3. Si vous préférez / avez besoin de XML comme sortie au lieu de JSON, remplacez la valeur de output_format par «xml»
  5. Fermez Gérer les environnements, puis assurez-vous que Postman l’utilise
    , API Pardot et préparation avec les utilisateurs SSO de Salesforce<span class="wtr-time-wrap after-title"><span class="wtr-time-number">8</span> minutes de lecture</span>
  6. Dans la collection API Pardot – Salesforce SSO, développez Mise en route et cliquez sur la demande de connexion. Cliquez sur Envoyer.
    , API Pardot et préparation avec les utilisateurs SSO de Salesforce<span class="wtr-time-wrap after-title"><span class="wtr-time-number">8</span> minutes de lecture</span>
  7. Facultatif: consultez le corps de la demande pour voir comment les informations sont transmises à Salesforce pour terminer la demande de connexion. Notez que le mot de passe est en fait une concaténation du mot de passe Salesforce avec le jeton de sécurité Salesforce
    , API Pardot et préparation avec les utilisateurs SSO de Salesforce<span class="wtr-time-wrap after-title"><span class="wtr-time-number">8</span> minutes de lecture</span>
  8. Avec une connexion réussie, vous devriez obtenir une réponse contenant un jeton d’accès. C’est l’une des 2 pièces dont Pardot a besoin.
    , API Pardot et préparation avec les utilisateurs SSO de Salesforce<span class="wtr-time-wrap after-title"><span class="wtr-time-number">8</span> minutes de lecture</span>
  9. Maintenant que vous disposez d’un jeton d’accès, vous pouvez commencer à expérimenter d’autres requêtes d’API Pardot. Si vous consultez les autres demandes dans la section Mise en route, vous pouvez commencer à voir comment les choses sont liées. Notez les en-têtes pour toutes les demandes, ils ont tous les en-têtes Authorization et Pardot-Business-Unit-Id.
    , API Pardot et préparation avec les utilisateurs SSO de Salesforce<span class="wtr-time-wrap after-title"><span class="wtr-time-number">8</span> minutes de lecture</span>

Se préparer pour la version Salesforce Winter ’21

J’espère qu’en suivant les étapes ci-dessus, vous vous sentirez mieux préparé pour l’API et les mises à jour de l’authentification unique à venir au début de l’année prochaine. Que faites-vous pour vous préparer aux prochaines versions de Pardot et Salesforce? Faites le nous savoir dans les commentaires. Vous voulez de l’aide pour prendre de l’avance? Donnez-nous un cri et nous allons vous connecter.





Source de l’article traduit automatiquement en Français