Générer la clé de chiffrement
Avant de pouvoir faire quoi que ce soit, REDA Pay a besoin d’une clé de chiffrement. REDA Pay s’en sert pour chiffrer chaque secret qu’il stocke dans votre organisation : la clé API Payload, les identifiants que Payload attribue à votre profil, à vos comptes de traitement, à vos clients et à leurs moyens de paiement, et les identifiants cachés dans les liens de paiement. Générer la clé est une étape unique, en un clic, dans l’onglet REDA Pay Admin. Tant qu’elle n’est pas faite, chaque écran REDA Pay s’arrête sur le message « REDA Pay setting(s) are invalid or not defined. Please contact your system administrator. »
- REDA Pay est installé (Configuration → Packages installés affiche REDA Pay).
- Vous avez l’ensemble d’autorisations REDA Pay - Admin User ; consultez Qui peut faire quoi. Les boutons de l’onglet Admin ne font rien pour les autres utilisateurs.
Pourquoi cette clé existe
Payload identifie votre organisation, chaque compte commerçant, chaque client et chaque carte ou compte bancaire enregistré au moyen d’un identifiant. Si ces identifiants étaient lisibles par toute personne capable d’ouvrir un enregistrement, quelqu’un disposant d’un accès en lecture à votre organisation pourrait en savoir assez pour appeler Payload en votre nom. REDA Pay les stocke donc chiffrés, et la seule chose capable de les déchiffrer est la clé conservée dans votre organisation. La même clé protège votre clé API Payload : c’est pourquoi la clé API doit être saisie via le bouton Update API Token et non tapée dans le champ, car le bouton la chiffre avec cette clé.
La clé est créée une fois et n’est jamais montrée à personne. REDA Pay la conserve dans un paramètre protégé que seul le package lui-même peut lire.
Générer la clé
- Ouvrez le Lanceur d’application (la grille de neuf points en haut à gauche), recherchez REDA Pay et ouvrez l’application.
- Cliquez sur l’onglet REDA Pay Admin.
- Sur la carte Encryption Key Setup, lisez la note : « REDA Pay "Encryption Key" is must for REDA Pay App to function. If the "Encryption Key" is not generated, generate the key using following button. »
- Cliquez sur Generate Key.
- Le bouton devient Generated et est grisé. C’est toute l’étape : il n’y a rien à copier, à enregistrer ni à saisir ailleurs.
Une fois la clé générée, le bouton affiche « Generated ». Rien d’autre ne change ensuite sur cette carte.
Si le bouton affiche déjà Generated quand vous arrivez, quelqu’un a déjà effectué cette étape et vous pouvez passer à Créer un Pay Profile.
Ce que vous ne pouvez pas faire ensuite
- Vous ne pouvez pas générer la clé une seconde fois. Le bouton est désactivé dès qu’une clé existe. Tout ce que REDA Pay a chiffré dépend de cette clé : la remplacer rendrait tous les secrets stockés illisibles.
- Vous ne pouvez pas afficher ni exporter la clé. Elle n’apparaît sur aucun écran et n’est stockée dans aucun champ que vous pouvez lire.
- Vérifiez chaque organisation séparément. Après avoir créé ou actualisé une sandbox, ouvrez l’onglet REDA Pay Admin de la sandbox avant de compter sur REDA Pay. Si le bouton affiche Generate Key, générez la clé dans cette sandbox, puis configurez-y un Pay Profile avec une clé API Payload de votre environnement de test.
Ce que protège la clé
| Chiffré avec cette clé | Où il se trouve |
|---|---|
| Le jeton API Payload | Pay Profile → API Token |
| L’identifiant Payload de votre organisation | Pay Profile → Profile Id |
| Les identifiants Payload de chaque compte commerçant | Processing Account → Processing Account Id, Parent Id |
| L’identifiant Payload de chaque client | Pay Customer → Customer Id |
| Le jeton que Payload utilise à la place de chaque carte ou compte bancaire enregistré | Pay Method → Pay Method Id |
| L’identifiant de l’ordre dans chaque lien de paiement | Pay Order → Encrypted Id, utilisé dans Link URL |
| L’identifiant du compte de traitement sur chaque transaction | Pay Transaction → Processing Id |
Quiconque lit ces enregistrements voit un texte chiffré. La clé elle-même est conservée dans un paramètre protégé que seul le code de REDA Pay peut lire ; elle n’apparaît pas dans la Configuration, ne peut pas être interrogée et ne peut pas être exportée.
Ce qu’il faut dire à un auditeur
- Les secrets et les identifiants sont chiffrés au repos avec une clé générée dans l’organisation et jamais affichée.
- Les numéros de carte, les codes de sécurité et les numéros de compte bancaire ne sont jamais stockés ; consultez Sécurité et données de carte.
- La clé est créée une fois par organisation par un administrateur disposant de l’ensemble d’autorisations REDA Pay - Admin User, et ne peut être ni régénérée, ni remplacée, ni exportée.
Vérifier que cela a fonctionné
Ouvrez l’onglet Pay Profiles et créez un Pay Profile comme décrit dans Créer un Pay Profile. Lorsque vous appuyez sur Update API Token et enregistrez une clé, le jeton est accepté et le champ API Token affiche une valeur chiffrée. Si vous voyez à la place « REDA Pay setting(s) are invalid or not defined. Please contact your system administrator. », la clé de chiffrement manque : revenez à l’onglet Admin et générez-la.
Erreurs à éviter
| Erreur | Ce que vous voyez | Correction |
|---|---|---|
| Utiliser REDA Pay avant de générer la clé | « REDA Pay setting(s) are invalid or not defined. Please contact your system administrator. » sur chaque écran | Générez la clé dans l’onglet REDA Pay Admin |
| S’attendre à une clé à copier ou à télécharger | Rien n’apparaît après avoir appuyé sur le bouton | C’est normal. La clé reste dans l’organisation |
| Considérer qu’une sandbox actualisée est prête | « REDA Pay setting(s) are invalid or not defined… » dans la sandbox | Ouvrez l’onglet Admin de la sandbox ; générez-y la clé si le bouton affiche encore Generate Key |
| Un non-administrateur appuie sur Generate Key | Le bouton ne fait rien ou signale une erreur | Attribuez REDA Pay - Admin User et réessayez |
Questions fréquentes
Non. La clé API Payload est émise par Payload et identifie votre compte auprès de Payload. La clé de chiffrement est créée par REDA Pay dans votre organisation et sert uniquement à protéger la clé API Payload et les autres identifiants pendant qu’ils sont stockés dans Salesforce. Vous saisissez la clé API Payload à l’étape suivante ; vous ne voyez jamais la clé de chiffrement.
Non. Cela crée une valeur dans votre organisation Salesforce, et rien ne quitte l’organisation.
Vérifiez que vous êtes bien dans l’organisation que vous croyez : une sandbox et son organisation de production ont chacune leur propre clé. Si vous êtes dans la bonne organisation, contactez support@reda.one en indiquant le nom de l’organisation.
Pour aller plus loin
- Créer un Pay Profile et enregistrer votre clé API Payload : l’étape suivante.
- Feuille de route de configuration : la place de cette étape dans la configuration complète.