Gérer les clés API
Gérez vos credentials d'application Genuka Pay de manière sécurisée depuis le dashboard et les workflows opérationnels.
Introduction
Genuka Pay est conçu pour être géré depuis le dashboard en priorité, pas en copiant-collant des credentials bruts dans des scripts ad hoc.
Révéler les credentials
Inspectez vos clés d'application actuelles depuis le flux protégé du dashboard.
Renouveler les clés
Générez une nouvelle clé secrète ; l'ancienne cesse aussitôt de fonctionner.
Gérer la visibilité
Masquez ou révélez votre secret_key pour éviter l'exposition accidentelle.
Où les gérer
Ouvrez la page API Keys depuis le dashboard.
Cette page est le point d'entrée opérationnel pour votre équipe.
Ce que vous pouvez faire
- Voir le
public_key- identifiez votre application - Révéler ou masquer le
secret_key- contrôlez la visibilité - Copier les clés - utilisez-les dans vos intégrations
- Renouveler - générez une nouvelle
secret_key, qui remplace l'ancienne immédiatement
Bonnes pratiques pour les credentials
Stockage
- ✅ Stockez le
secret_keyen tant que variable d'environnement côté serveur uniquement - ❌ Ne l'engagez jamais dans votre dépôt source
- ❌ Ne l'envoyez jamais au navigateur ou à un client JavaScript
- ❌ Ne le partagez jamais en texte brut par email ou chat
Rotation
Renouvelez votre clé régulièrement (tous les 3-6 mois), et immédiatement en cas de doute :
- Préparez le déploiement : la nouvelle clé devra être en place dans vos services sans délai
- Ouvrez la page API Keys et cliquez sur "Rotate"
- Une nouvelle
secret_keyest générée et remplace l'ancienne immédiatement : il n'y a pas de période de grâce, les requêtes signées avec l'ancienne échouent en401dès cet instant - Mettez à jour vos services avec la nouvelle
secret_key— lapublic_key, elle, ne change pas
Chaque environnement (SANDBOX, LIVE) a sa propre paire de clés et se renouvelle séparément. Les clés secrètes commencent par sk_test_ en sandbox et sk_live_ en live ; les clés publiques par pk_test_ et pk_live_.
Les endpoints /api/v1/application qu'utilise le dashboard n'acceptent que la session du dashboard : ils ne peuvent pas être appelés avec une clé API.
Utilisation
Toutes les requêtes authentifiées requirent :
X-Public-Key: YOUR_PUBLIC_KEY
X-Timestamp: UNIX_TIMESTAMP
X-Signature: HMAC_SHA256_SIGNATUREUtilisez les SDKs officiels pour gérer automatiquement cette logique.
Scope des permissions
Actuellement, chaque application a accès complet à tous les endpoints. Les permissions granulaires par scope seront disponibles dans les futures versions.
How is this guide?
Last updated on