Créer vos identifiants API Salesforce : External Client App et OAuth 2

Étape 1 : Choisir l’environnement

Avant de créer quoi que ce soit, il faut distinguer les deux environnements que vous utiliserez :

• Sandbox : copie isolée de votre organisation Salesforce, accessible via test.salesforce.com. C’est là que le connecteur est développé et validé, sans risque de toucher à vos données de production.
• Production : votre organisation Salesforce réelle, accessible via login.salesforce.com. Le connecteur y est déployé uniquement après validation complète sur le sandbox.

Vous aurez besoin de créer une External Client App dans chaque environnement. Les credentials ne sont pas partagés entre sandbox et production.

Si vous n’avez pas de sandbox

Un sandbox Salesforce se crée depuis votre console d’administration : Setup (roue dentée) puis Environments puis Sandboxes. Les sandboxes de type Developer sont disponibles sans surcoût sur les éditions Enterprise et Unlimited. Si vous n’avez pas accès à cette section, votre administrateur Salesforce peut en créer un.

---

Étape 2 : Créer une External Client App

L’External Client App est l’application enregistrée dans Salesforce qui autorise une intégration externe à se connecter via le flux OAuth 2.0 JWT Bearer.

Génération du certificat de signature du JWT

Avant de partir sur l’interface de Salesforce, vous devez lancer les commandes suivantes pour générer le certificat de signature du JWT Bearer :

# Génère clé privée RSA 2048 + certificat auto-signé
openssl req -newkey rsa:2048 -nodes -keyout server.key -x509 -days 365 -out server.crt

# Convertit en PKCS#8 (requis par le connecteur)
openssl pkcs8 -topk8 -nocrypt -in server.key -out server_pkcs8.pem

• Le fichier publique server.crt va vous servir pour finaliser le paramètrage JWT de l’External Client App (pas besoin de nous le transmettre).
• Le fichier server_pkcs8.pem quand à lui doit nous être transféré et sera stocké de manière sécurisé sur le serveur.

Accéder à l’External Client App Manager

Connectez-vous à votre organisation Salesforce (sandbox ou production). Cliquez sur la roue dentée en haut à droite pour accéder à Configuration.

Dans la barre de Recherche rapide, saisissez “Applications clientes externes”, cliquez sur Gestionnaire des applications clientes externes puis Nouvelle application cliente externe.

Créer une nouvelle External Client App

Dans la page de configuration de l’External Client App renseignez les informations suivantes par section :

Informations de base

• Nom de l’application : nom de votre connecteur.
• Nom d’API : automatiquement généré à partir du nom de l’application.
• Adresse e-mail du contact : votre adresse e-mail
• État de distribution : Laissé Local

API

• Cocher Activer OAuth
  • URL de rappel : Renseignez l’url racine de votre connecteur
• Dans les paramètres étendues OAuth sélectionnez :
  • Gérer les données des utilisateurs via des API (api)
  • Exécuter des requêtes à tout moment (refresh_token, offline_access)

Et plus bas dans Flux Enablement cochez Activer le flux du porteur JWT

Ceci ajoutera un input “Chargement de certificat” vous permettant de charger le fichier server.crt créé précédemment.

Enfin, cliquez sur Créer en bas.

Configurer les Stratégies d’application OAuth

Maintenant que votre application cliente externe est créé il ne vous reste plus qu’à finaliser les stratégies OAuth, vérifiez et verrouillez les contrôles de sécurité.

Dans l’onglet Stratégies cliquez sur le bouton Modifier et ajouter les options suivantes par section :

Stratégies d’application > Profils disponible > Administrateur Système

Stratégies OAuth > Utilisateurs autorisés > Les utilisateurs approuvés par l’administrateur sont pré-autorisés

Et cliquez sur Enregistrer en bas pour valider ces options.

Vous pouvez maintenant valider les contrôles depuis le bandeau en haut de la page en cliquant sur Vérifier les contrôles puis dans la pop-up de confirmation cocher la checkbox Verrouillés de l’extension et finir par cliquer sur Confirmer

---

Étape 3 : Récupérer le Consumer Key

Maintenant que votre application externe est correctement configuré, allez sur l’onglet Paramètres puis ouvrez la section Paramètres OAuth et cliquez sur Clé et secret consommateur.

Vous accédez alors à deux valeurs :

• Consumer Key (Clé consommateur) : identifiant public de votre application. Vous devez copier la valeur et nous le transmettre.
• Consumer Secret (Secret consommateur) : mot de passe de l’application — Il ne sert que quand un utilisateur se connecte manuellement via un navigateur. Dans le cas d’une intégration JWT Bearer (server-to-server sans interaction humaine), il n’est pas utilisé — la clé privée RSA du certificat généré précédemment joue ce rôle.

Transmission au prestataire

Partagez le Consumer Key via un gestionnaire de mots de passe partagé (Bitwarden, 1Password, Dashlane). Jamais par email, Slack ou ticket de support en clair.

Communiquez également :

• Le fichier server_pkcs8.pem généré pendant la création de l’External Client App
• L’URL de votre organisation sandbox : format https://[votre-domaine].sandbox.my.salesforce.com
• L’édition Salesforce utilisée (Professional, Enterprise, Unlimited)
• La liste des Custom Objects et Custom Fields concernés par le connecteur (votre développeur vous posera ces questions lors de la phase de cadrage)

Références

• Trailhead : Create and Configure an External Client App
• Documentation Salesforce : configurer les paramètres OAuth d’une External Client App
• Scopes OAuth disponibles
• Quotas REST par édition