Les clés API sont la passerelle vers votre compte Cathopic. Les garder en sécurité permet d’éviter tout accès non autorisé et de se protéger contre la fraude liée à la facturation.
La règle d’or : gardez les clés secrètes
Traitez vos clés API comme des mots de passe. Erreurs courantes à éviter :
Intégrer les clés directement dans le code source
Les commiter dans Git ou tout autre système de contrôle de version
Utiliser les clés dans du JavaScript côté client ou dans des applications mobiles
Partager les clés par e-mail, Slack ou des applications de messagerie
Stocker les clés dans des emplacements publics (dépôts publics, wikis, etc.)
Utilisez des variables d’environnement
Stockez les clés dans des variables d’environnement plutôt que dans le code :
// Fichier .env (à ajouter à .gitignore !)
CATHOPIC_API_KEY=sk_live_abc123xyz789...
// Votre code
require('dotenv').config();
const apiKey = process.env.CATHOPIC_API_KEY;Cela sépare les données sensibles de votre base de code et facilite la rotation des clés.
Côté serveur uniquement
Les appels API doivent être effectués depuis vos serveurs backend, et non depuis des navigateurs ou des applications mobiles. Si les utilisateurs ont besoin d’accéder à des ressources Cathopic :
Créez un point de terminaison (endpoint) backend qui utilise votre clé API
Votre front-end appelle VOTRE endpoint, et non Cathopic directement
Votre serveur valide la demande de l’utilisateur avant d’appeler Cathopic
Restreindre par IP (si possible)
Certains environnements permettent la mise en liste blanche des IP. Si vos appels API proviennent d’IP connues :
Configurez des règles de pare-feu pour limiter l’accès sortant
Utilisez des comptes de service dédiés avec des permissions minimales
Surveillez les journaux d’accès pour détecter toute activité inhabituelle
Si une clé est compromise
Si vous pensez qu’une clé a été exposée :
Générez immédiatement une nouvelle clé API
Mettez à jour votre application avec la nouvelle clé
Supprimez la clé compromise
Vérifiez les journaux d’utilisation pour toute activité suspecte
Contactez le support si vous constatez des frais non autorisés
Gérez vos clés en toute sécurité dans Paramètres → API.
