Administración de secretos
Almacenamiento seguro de credenciales
Cuando tu aplicación necesita conectarse a servicios externos, como enviar correos con SendGrid, procesar pagos con Stripe o usar OpenAI para funciones de IA, necesitas almacenar claves de API y credenciales de forma segura. El sistema de administración de secretos de Kliv maneja esto automáticamente.
Qué hace seguros a los secretos:
- Almacenamiento cifrado en la base de datos
- Nunca se muestran completos después de guardarlos
- Se inyectan automáticamente en funciones edge cuando se necesitan
- A nivel de cuenta para que solo almacenes cada clave una vez
- Pistas de auditoría que rastrean cuándo se crearon o actualizaron los secretos
Cómo funcionan los secretos
Cuando le dices a la IA que quieres integrar un servicio externo, te pedirá las credenciales necesarias. Cuando proporcionas una clave de API, la IA la almacena de forma segura con un nombre descriptivo (como OPENAI_API_KEY o STRIPE_SECRET_KEY). A partir de ahí, cualquier función edge que necesite esa credencial puede acceder a ella automáticamente.
Visualización enmascarada: Después de guardar un secreto, solo verás una versión parcialmente enmascarada en la UI de administración. Por ejemplo, sk-proj-abc123xyz789 aparece como sk-p****9789. Esto te permite verificar qué clave es cuál sin exponer el valor completo.
Inyección automática: Cuando se ejecuta una función edge, los secretos a los que hace referencia se inyectan de forma segura para esa ejecución. La IA escribe la función para leerlos mediante la interfaz de secretos de la plataforma, y la plataforma proporciona el valor real en tiempo de ejecución; por eso una clave rotada entra en efecto en la siguiente ejecución de la función.
Administrar secretos
Desde la interfaz de administración, puedes:
- Ver todos tus secretos (con valores enmascarados)
- Agregar secretos nuevos o actualizar los existentes
- Eliminar secretos que ya no necesitas
- Ver cuándo se creó o actualizó por última vez cada secreto
La IA también puede crear y actualizar secretos por ti cuando describes integraciones que quieres crear.
Usos comunes de secretos
- Servicios de correo: credenciales de SendGrid, Mailgun o SMTP
- Procesamiento de pagos: claves de API de Stripe, PayPal u otros pagos
- Servicios de IA: claves de API de OpenAI, Anthropic o Google
- SMS/llamadas: tokens de autenticación de Twilio
- API externas: cualquier servicio de terceros con el que se integre tu app
- Webhooks: secretos de firma para verificar webhooks entrantes
- Conexiones de base de datos: cadenas de conexión para bases de datos externas
Buenas prácticas
✅ Usa nombres descriptivos - Nombra los secretos claramente, como SENDGRID_API_KEY, en lugar de key1 o secret.
✅ Rótalos con regularidad - Actualiza los secretos periódicamente, especialmente para servicios críticos.
✅ Elimina cuando termines - Quita secretos de servicios que ya no uses.
❌ No compartas secretos - Cada entorno (prueba, producción) debería usar claves de API distintas.
❌ No los confirmes en el código - Los secretos se almacenan separados de tu código por una razón. Nunca pongas claves de API directamente en tus archivos fuente.
Documentación relacionada: