Ce guide étape par étape explique comment configurer Salesforce pour permettre à BuiltWith de synchroniser les résultats à l'aide de Salesforce Lightning Experience.
Vous devez être administrateur système Salesforce, et l'utilisateur Salesforce autorisant BuiltWith doit disposer d'un accès API et de l'autorisation de mettre à jour les enregistrements et les champs que vous souhaitez synchroniser.
Vous utilisez déjà BuiltWith Salesforce Sync ? Si votre synchronisation fonctionne, aucune action n'est requise. Vous n'avez pas besoin de modifier vos paramètres Salesforce ni de vous reconnecter. Les connexions existantes conservent leur configuration actuelle. Une synchronisation normale ne modifie pas vos paramètres de connexion.
Pour activer les paramètres de sécurité supplémentaires ci-dessous sur une connexion existante, veuillez d'abord vous authentifier à nouveau depuis la page de configuration Salesforce de BuiltWith en utilisant le flux de connexion mis à jour. Une fois l'autorisation réussie, activez les paramètres dans Salesforce. Vos mappages et paramètres de synchronisation BuiltWith seront conservés. Salesforce pourra vous demander une nouvelle authentification après une modification de la politique.
1. Configurez votre application Salesforce Dans la configuration Salesforce, ouvrez les paramètres OAuth de l'application que vous utiliserez avec BuiltWith. Selon votre organisation Salesforce, il peut s'agir d'une application connectée ou d'une application cliente externe, et les libellés disponibles peuvent varier. Si Salesforce ne propose pas la création d'une application connectée, utilisez une application cliente externe avec les paramètres OAuth équivalents.
Nom de l'application connectée / Nom de l'application cliente externe : Hook intégré
Nom de l'API : BuiltWith_Hook
Adresse électronique de contact : support@builtwith.com
URL de l'image du logo : https://builtwith.com/img/salesforce/200x125-bw.webp
URL de l'icône : https://builtwith.com/img/salesforce/32x32-bw.webp
URL d'information : https://kb.builtwith.com/category/salesforce
Description : Point d'intégration BuiltWith
Saisissez ces informations dans les champs correspondants.
2. Activer OAuth Cochez la case
Activer les paramètres OAuth ou l'option OAuth équivalente.
URL de rappel : https://builtwith.com/cb.asmx
Saisissez l'URL de rappel exactement comme indiqué.
Ajoutez les étendues OAuth suivantes :
Accéder au service d'URL d'identité (identifiant, profil, courriel, adresse, téléphone) Accès complet (complet) Effectuer des requêtes en votre nom à tout moment (refresh_token, offline_access) 3. Définir les options de sécurité pour une nouvelle connexion Activez les options suivantes lorsqu'elles sont disponibles :
Extension PKCE (Proof Key for Code Exchange) requise pour les flux d'autorisation pris en charge Exiger un secret pour le flux du serveur Web Exiger un secret pour le flux de jeton d'actualisation Activer la rotation du jeton d'actualisation BuiltWith prend en charge PKCE via S256 et enregistre les jetons d'actualisation de remplacement émis par Salesforce. Il n'est plus nécessaire de désactiver PKCE pour créer une nouvelle connexion BuiltWith. Les connexions fonctionnent également lorsque votre application Salesforce n'exige ni PKCE ni la rotation des jetons d'actualisation.
4. Connectez-vous à BuiltWith Sauvegardez les paramètres de votre application Salesforce et obtenez sa clé et son secret client. Conservez ce secret confidentiel.
Ouvrez la
page de configuration Salesforce dans BuiltWith . Saisissez la clé consommateur, le secret consommateur et le nom d'hôte de connexion Salesforce, puis sélectionnez
Authentifier et terminez l'autorisation dans Salesforce.
Retournez sur BuiltWith pour valider vos champs Salesforce et terminer la configuration de la synchronisation. Si vous vous reconnectez, vos mappages et paramètres de synchronisation existants seront conservés.
Politiques de sécurité facultatives Liste blanche des adresses IP du jeton d'actualisation Pour utiliser
la liste blanche d'adresses IP du jeton d'actualisation , ajoutez les quatre adresses IPv4 sortantes BuiltWith ci-dessous avant d'activer le paramètre :
15.235.50.228
51.161.84.56
15.235.53.29
15.235.50.223
Si Salesforce vous demande une adresse de début et une adresse de fin, saisissez la même adresse IP dans les deux champs pour chaque entrée. L'autorisation et l'actualisation du jeton doivent toutes deux provenir d'une adresse autorisée. Après avoir activé ce paramètre, validez votre connexion BuiltWith et vérifiez que la synchronisation planifiée a bien été effectuée. Contactez support@builtwith.com pour configurer les notifications de changement d'adresse IP avant d'utiliser la liste blanche.
Expiration du jeton d'actualisation Vous pouvez appliquer la politique d'expiration des jetons d'actualisation de votre organisation, y compris une politique de 90 jours lorsque Salesforce le permet. Salesforce peut également appliquer une limite d'inactivité plus courte. Lorsqu'un jeton d'actualisation expire ou que l'accès est révoqué, la synchronisation ne peut pas reprendre tant que vous ne vous êtes pas authentifié à nouveau depuis la page de configuration Salesforce de BuiltWith. La reconnexion préserve vos mappages et paramètres de synchronisation BuiltWith.
DPoP BuiltWith Salesforce Sync ne prend actuellement pas en charge la démonstration de preuve de possession (DPoP). Ne pas activer l'exigence de jetons liés à la preuve de possession pour cette intégration.
Documentation Salesforce Paramètres OAuth pour les applications connectées Paramètres OAuth pour les applications clientes externes Actualiser le flux et la rotation des jetons Listes d'adresses IP autorisées pour les jetons d'actualisation Limites d'inactivité du jeton d'actualisation