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 :