Tus claves API son la puerta de entrada a tu cuenta de Cathopic. Mantenerlas seguras previene el acceso no autorizado y protege contra fraude de facturación.
La regla de oro: Mantén las claves secretas
Trata tus claves API como contraseñas. Errores comunes a evitar:
Escribir claves directamente en el código fuente
Commitear claves a Git u otro control de versiones
Usar claves en JavaScript del lado del cliente o apps móviles
Compartir claves por email, Slack o apps de mensajería
Almacenar claves en ubicaciones públicas (repos públicos, wikis, etc.)
Usa variables de entorno
Almacena claves en variables de entorno en lugar de código:
// archivo .env (¡añadir a .gitignore!)
CATHOPIC_API_KEY=sk_live_abc123xyz789...
// Tu código
require('dotenv').config();
const apiKey = process.env.CATHOPIC_API_KEY;Esto separa datos sensibles de tu código base y hace que la rotación de claves sea más fácil.
Solo del lado del servidor
Las llamadas API deben ocurrir desde tus servidores backend, no navegadores o apps móviles. Si los usuarios necesitan acceso a recursos de Cathopic:
Crea un endpoint backend que use tu clave API
Tu frontend llama a TU endpoint, no a Cathopic directamente
Tu servidor valida la petición del usuario antes de llamar a Cathopic
Restringe por IP (si es posible)
Algunas infraestructuras permiten whitelist de IPs. Si tus llamadas API vienen de IPs conocidas:
Configura reglas de firewall para limitar acceso saliente
Usa cuentas de servicio dedicadas con permisos mínimos
Monitorea logs de acceso en busca de actividad inusual
Si una clave está comprometida
Si sospechas que una clave ha sido expuesta:
Genera una nueva clave API inmediatamente
Actualiza tu aplicación con la nueva clave
Elimina la clave comprometida
Revisa logs de uso en busca de actividad sospechosa
Contacta con soporte si ves cargos no autorizados
Gestiona tus claves de forma segura en Ajustes → API.
