Prérequis
Configuration des prérequis
Configurer les composants Salesforce pour l'intégration DuoKey BYOK
L'intégration Salesforce Shield est en préversion et n'est pas encore activée sur les tenants DuoKey Cockpit standard. Ce guide décrit son fonctionnement et sa configuration. Contactez DuoKey pour en discuter dans le cadre de votre projet.
Vue d'ensemble
Les prérequis incluent :
- La création d'une Connected App dans Salesforce
- La génération d'un certificat auto-signé
- L'obtention des identifiants de l'API REST
Étape 1 : Créer une Connected App
Une Connected App établit une communication sécurisée entre DuoKey et Salesforce via l'API REST.
Accéder à l'App Manager
- Connectez-vous à votre compte Salesforce
- Cliquez sur l'icône d'engrenage Setup
- Dans Quick Find, recherchez « App Manager »
- Accédez à Apps → App Manager
Créer une nouvelle Connected App
- Cliquez sur le bouton New Connected App
- Renseignez les informations de base :
| Champ | Valeur |
|---|---|
| Connected App Name | DuoKey BYOK Integration |
| API Name | (renseigné automatiquement) |
| Contact Email | [email protected] |
Configurer les paramètres OAuth
- Cochez Enable OAuth Settings
- Définissez l'URL de rappel :
sfdc://oauth/restapi/success - Dans Selected OAuth Scopes, ajoutez : Full access (full)
- Cliquez sur Save
L'URL de rappel sfdc://oauth/restapi/success est standard pour les intégrations d'API REST Salesforce.
Obtenir le Consumer Key et le Secret
- Depuis l'App Manager, trouvez votre Connected App nouvellement créée
- Cliquez sur la flèche déroulante (▼) et sélectionnez View
- Dans la section API (Enable OAuth Settings), cliquez sur Manage Consumer Details
- Saisissez le code de vérification envoyé à votre adresse e-mail
- Copiez et enregistrez en lieu sûr :
- Consumer Key (Client ID)
- Consumer Secret (Client Secret)
Conservez ces identifiants en lieu sûr. Vous en aurez besoin lors de la configuration de l'application DuoKey.
Étape 2 : Générer un certificat auto-signé
Salesforce requiert un certificat auto-signé pour l'intégration BYOK avec le service de clés en cache uniquement.
Accéder à la gestion des certificats
- Dans Salesforce Setup, recherchez « Certificate » dans Quick Find
- Accédez à Security → Certificate and Key Management
Créer un certificat auto-signé
- Cliquez sur Create Self-Signed Certificate
- Renseignez les détails du certificat :
| Champ | Valeur | Remarque |
|---|---|---|
| Label | DuoKey BYOK Certificate | Nom descriptif |
| Unique Name | (renseigné automatiquement) | Ou saisi manuellement |
| Key Size | 4096 | Recommandé pour la sécurité |
| Exportable Private Key | Coché | Permet la sauvegarde/migration |
L'activation de « Exportable Private Key » vous permet d'exporter le certificat si nécessaire à des fins de sauvegarde ou de migration.
Cliquez sur Save
Étape 3 : Obtenir les identifiants de l'API REST
Nom d'utilisateur et mot de passe Salesforce
Il s'agit de vos identifiants de connexion Salesforce standard :
- Nom d'utilisateur : l'e-mail de votre compte Salesforce
- Mot de passe : le mot de passe de votre compte Salesforce
Générer le jeton de sécurité
Réinitialiser le jeton de sécurité
- Cliquez sur votre icône de profil en haut à droite
- Sélectionnez Settings
- Dans Quick Find, recherchez « Reset My Security Token »
- Accédez à My Personal Information → Reset My Security Token
- Cliquez sur Reset Security Token
- Consultez votre e-mail pour le nouveau jeton de sécurité
- Copiez et enregistrez le jeton de sécurité en lieu sûr
- Le jeton de sécurité est envoyé par e-mail et doit rester confidentiel
- Si vous changez votre mot de passe, votre jeton de sécurité est automatiquement réinitialisé
- Vous devrez utiliser le jeton de sécurité le plus récent pour l'authentification de l'API
Domaine/Instance Salesforce
- Accédez à Setup Home → Company Settings → My Domain
- Notez votre nom de domaine (par ex.
yourcompany.develop.lightning.force.com) - Extrayez l'alias d'instance (par ex.
yourcompany)
Récapitulatif des identifiants
| Identifiant | Description | Exemple |
|---|---|---|
| Consumer Key | Depuis les paramètres OAuth de la Connected App | 3MVG9... (chaîne longue) |
| Consumer Secret | Depuis les paramètres OAuth de la Connected App | 12345... (chaîne numérique) |
| Nom d'utilisateur Salesforce | Votre e-mail de connexion Salesforce | [email protected] |
| Mot de passe Salesforce | Le mot de passe de votre compte Salesforce | YourP@ssw0rd |
| Security Token | Depuis Reset My Security Token | ABC123... (alphanumérique) |
| Domaine/Instance | Votre alias de domaine Salesforce | yourcompany |
| Certificat | Nom du certificat auto-signé | DuoKey BYOK Certificate |
Envisagez d'utiliser un gestionnaire de mots de passe sécurisé pour conserver ces identifiants en toute sécurité.