API d’administration : authentification à l’aide d’une application connectée à Salesforce
Nous vous recommandons d’utiliser des clés API Admin pour authentifier les appels API administrateur. Une méthode plus ancienne est documentée ici.
CPQ Les API d’administration sont utiles pour faciliter l’introduction de nouveaux produits, le transfert de données, les opérations de test à la production, etc. Pour les cas d’utilisation qui CPQ exploitent Salesforce pour l’authentification des utilisateurs, cet article vous guide à travers les étapes nécessaires à la création d’une application connectée à Salesforce et à la récupération d’un jeton Web JSON [JWT] qui peut être utilisé pour authentifier les appels aux CPQ API d’administration.
- La publication des clés API admin a rendu cette configuration inutile et constitue désormais la méthode recommandée d’authentification des appels d’API admin. Consultez Présentation des clés API d’administration.
- La méthode JWT qui était recommandée avant février 2025 a été dépréciée par Salesforce. Suivez plutôt les étapes mises à jour dans cet article.
Le JWT peut être utilisé comme jeton de porteur pour authentifier CPQ les API d’administration afin de manipuler les tables gérées, d’écrire des règles, de déployer des plans, etc.
Création ou mise à jour d’une application connectée pour l’authentification JWT
Si vous mettez à jour une application existante, ces instructions supposent que vous avez créé une application connectée en suivant les instructions du flux de jetons d’actifs hérité.
- Accédez à la configuration de Salesforce, aux applications → au gestionnaire d’applications.
- Créez une nouvelle application connectée ou mettez à jour votre application JWT existante pour qu’elle corresponde à l’image ci-dessous.
- Cliquez sur Gérer dans votre application connectée JWT.
- Modifier les politiques.
- Une nouvelle section s’intitule Client Credentials Flow (Flux d’informations d’identification du client). Sélectionnez votre utilisateur d’intégration dans l’option Exécuter en tant que .
- Il y aura une deuxième nouvelle section intitulée Paramètres de jetons d’accès basés sur JWT pour les utilisateurs nommés. Vérifiez les jetons d’accès basés sur le jeton Web JSON (JWT) et sélectionnez un délai d’expiration par défaut.
- Cliquez sur Enregistrer. Vos politiques doivent ressembler à ce qui suit :
Génération du JWT
La collection Postman suivante peut être utilisée pour générer un JWT pour votre instance :
Pour obtenir des instructions détaillées, consultez :
Flux d’informations d’identification du client OAuth 2.0 pour l’intégration de serveur à serveur
Vous pouvez trouver l’ID client et le secret en consultant le champ Clé et secret du consommateur → Gérer les détails du consommateur dans l’application connectée que vous avez créée ci-dessus.
Notez qu’un seul appel à Salesforce génère un jeton. Selon le paramètre Émettre un jeton Web Token (JWT) pour les utilisateurs nommés dans votre application connectée, le jeton d’accès renvoyé ici est un JWT que vous pouvez utiliser comme jeton porteur pour CPQ les API.