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: