Gestion des secrets
Stockage sécurisé des identifiants
Lorsque votre application doit se connecter à des services externes — envoyer des e-mails via SendGrid, traiter des paiements avec Stripe ou utiliser OpenAI pour des fonctionnalités IA — vous devez stocker de manière sécurisée les clés d'API et identifiants. Le système de gestion des secrets de Kliv s'en charge automatiquement.
Ce qui rend les secrets sûrs :
- Stockage chiffré dans la base de données
- Jamais affichés en entier après leur enregistrement
- Injectés automatiquement dans les edge functions quand nécessaire
- À l'échelle du compte : vous ne stockez chaque clé qu'une seule fois
- Pistes d'audit retraçant la création et la mise à jour des secrets
Comment fonctionnent les secrets
Lorsque vous dites à l'IA que vous voulez vous intégrer à un service externe, elle vous demandera les identifiants nécessaires. Une fois la clé d'API fournie, l'IA la stocke en sécurité sous un nom descriptif (comme OPENAI_API_KEY ou STRIPE_SECRET_KEY). Dès lors, toute edge function qui a besoin de cet identifiant peut y accéder automatiquement.
Affichage masqué : après l'enregistrement d'un secret, vous n'en verrez qu'une version partiellement masquée dans l'interface d'administration. Par exemple, sk-proj-abc123xyz789 apparaît comme sk-p****9789. Vous pouvez ainsi vérifier quelle clé est laquelle sans exposer la valeur complète.
Injection automatique : quand une edge function s'exécute, les secrets qu'elle référence sont injectés de manière sécurisée pour cette exécution. L'IA écrit la fonction de façon à les lire via l'interface de secrets de la plateforme, et la plateforme fournit la valeur réelle à l'exécution — une clé renouvelée prend donc effet à la prochaine exécution de la fonction.
Gérer les secrets
Via l'interface d'administration, vous pouvez :
- Voir tous vos secrets (avec valeurs masquées)
- Ajouter de nouveaux secrets ou mettre à jour les existants
- Supprimer les secrets dont vous n'avez plus besoin
- Voir quand chaque secret a été créé ou mis à jour pour la dernière fois
L'IA peut aussi créer et mettre à jour des secrets pour vous quand vous décrivez les intégrations que vous voulez construire.
Usages courants des secrets
- Services d'e-mail : identifiants SendGrid, Mailgun ou SMTP
- Traitement des paiements : clés d'API Stripe, PayPal ou autres
- Services d'IA : clés d'API OpenAI, Anthropic ou Google
- SMS / téléphonie : jetons d'authentification Twilio
- API externes : tout service tiers auquel votre application s'intègre
- Webhooks : secrets de signature pour vérifier les webhooks entrants
- Connexions de base de données : chaînes de connexion vers des bases externes
Bonnes pratiques
✅ Utilisez des noms descriptifs — nommez vos secrets clairement, comme SENDGRID_API_KEY, plutôt que key1 ou secret.
✅ Renouvelez régulièrement — mettez à jour les secrets périodiquement, surtout pour les services critiques.
✅ Supprimez quand c'est fini — retirez les secrets des services que vous n'utilisez plus.
❌ Ne partagez pas les secrets — chaque environnement (test, production) doit utiliser des clés d'API différentes.
❌ Ne les mettez pas dans le code — les secrets sont stockés séparément de votre code pour une bonne raison. Ne placez jamais de clés d'API directement dans vos fichiers sources.
Documentation associée :