Guarda las credenciales privadas de tu app en Nube de Atoms → Claves para mantener sus valores fuera de Chat y del código fuente, y para gestionar valores separados de Prueba y Producción.

Antes de usar Claves, conecta el proyecto a Nube de Atoms. Si no está conectado, pídele al Agente que conecte Nube de Atoms o sigue Nube de Atoms.

Usa una clave en Nube de Atoms

Antes de empezar

Antes de agregar una clave, asegúrate de que:

• Estás usando Atoms en la web de escritorio.
• El proyecto está conectado a Nube de Atoms.
• Eres propietario del espacio de trabajo. Solo los propietarios del espacio de trabajo pueden agregar nuevas claves.

Si Claves o Nueva clave no está disponible, confirma que abriste el proyecto previsto y que está conectado a Nube de Atoms. Si Nueva clave sigue sin estar disponible, confirma que eres propietario del espacio de trabajo. Si Atoms muestra un mensaje de disponibilidad del plan o de uso, sigue la ruta de disponibilidad o actualización en pantalla y luego inténtalo de nuevo.

Agregar una clave de Prueba

1. Abre el proyecto en un dispositivo de escritorio.
2. En la misma barra de herramientas del espacio de trabajo donde está el Visor de Apps , selecciona Nube de Atoms.
3. Selecciona Claves en la barra lateral de Nube de Atoms.
4. Abre Claves de Prueba y luego selecciona En este proyecto.
5. Selecciona Nueva clave.
6. Completa los campos obligatorios:
   • Nombre: Introduce un nombre de referencia claro, como RESEND_API_KEY. Usa letras, números y guiones bajos, y comienza con una letra o un guion bajo.
   • Valor: Introduce la credencial exactamente como la proporcionó el proveedor.
   • Descripción: Explica para qué sirve la clave, como Se usa para enviar correos electrónicos de la cuenta. No incluyas el valor de la credencial.
7. Si quieres reutilizar la clave en otros proyectos, selecciona Guardar en la biblioteca.
8. Selecciona Agregar. Cuando la clave se haya guardado, Atoms muestra Clave agregada correctamente.

Agregar una clave de Prueba

Solo los propietarios del espacio de trabajo pueden agregar nuevas claves. Si necesitas que se agregue una clave, pídeselo a un propietario del espacio de trabajo.

Usar una clave guardada en Chat

Haz referencia a la clave guardada en lugar de introducir su valor en un mensaje.

1. Abre el Chat del proyecto en la versión de escritorio de Atoms y escribe #.
2. Selecciona Claves.
3. Busca la clave guardada y luego selecciona su nombre.
4. Dile al Agente para qué sirve la clave y qué quieres que haga la integración.

El menú # agrega una referencia a la clave guardada sin insertar su valor en tu mensaje.

Hacer referencia a una clave guardada en Chat

Probar una clave guardada

1. En el Visor de Apps, realiza una acción sencilla que use la clave.
2. Confirma que produce el resultado esperado, como enviar un correo electrónico de prueba o devolver datos de prueba.
3. Revisa cualquier error o registro visible y asegúrate de que no expongan el valor de la clave.

Si el servicio te proporciona claves separadas de prueba y activas, usa la clave de prueba mientras desarrollas tu app. Usa la clave activa solo después de que tu app se publique. Si la prueba falla, revisa el panel del proveedor para confirmar que la clave está activa y tiene permiso para realizar la acción solicitada. Nunca pegues el valor de la clave en Chat al solucionar problemas.

Comprende cómo funcionan las Claves

Antes de agregar claves, es útil entender qué almacena Atoms y cómo proteger tus credenciales.

Qué almacena Atoms

Nube de Atoms → Claves almacena credenciales que tu app usa para conectarse a servicios externos, como claves de API y tokens de acceso.

Cada clave guardada tiene un nombre, una descripción y un valor privado. El nombre y la descripción ayudan al Agente a entender cuándo usar la clave, mientras que el valor privado permanece oculto de Chat.

Dónde obtener una clave

Atoms no crea ni proporciona credenciales para servicios externos. Debes obtenerlas del proveedor de servicios correspondiente. Sigue las instrucciones del proveedor al elegir permisos, probar la clave y comprobar si caduca.

Mantén en secreto las credenciales privadas

Nunca pegues una credencial privada en Chat, código fuente, código que se ejecuta en el navegador, capturas de pantalla, registros o mensajes de soporte. Guárdala en Claves y luego haz referencia a la entrada guardada por nombre.

Si un valor privado ya ha quedado expuesto, considéralo comprometido y revócalo o rótalo a través del proveedor.

Credenciales privadas y seguras para el navegador

Claves no etiqueta los valores guardados como Público o Privado. Guardar un valor en Claves no hace automáticamente que sea seguro usarlo en código expuesto al navegador. Si tu app usa el valor en el navegador, los visitantes podrían poder inspeccionarlo.

Consulta la documentación del proveedor antes de decidir dónde usar una credencial:

• Usa un valor en código expuesto al navegador solo cuando el proveedor indique explícitamente que es seguro exponerlo.
• Mantén las credenciales privadas en lógica del lado del servidor o backend, donde no queden expuestas a los visitantes de la app.

Elige el entorno y el almacenamiento de la clave

Al agregar una clave, debes tomar dos decisiones separadas:

• Qué entorno usará la clave.
• Si la clave permanecerá en este proyecto o estará disponible para otros proyectos.

Elige un entorno

Opción	Cuándo se usa
Claves de Prueba	Se usan mientras desarrollas y pruebas tu app en el Visor de Apps. Si no agregas un valor de Producción separado, la app publicada también usará el valor de Prueba.
Claves de Producción	Las usa la app publicada cuando requiere una credencial activa separada. Los valores de Producción se agregan durante el proceso de publicación y se gestionan por separado de los valores de Prueba.

Elige dónde guardar la clave

Opción	Cuándo usarla
En este proyecto	Elige esto para una clave que solo deba usar el proyecto actual.
Biblioteca de claves	Elige esto cuando intencionalmente quieras reutilizar una clave en varios proyectos. Al agregar o actualizar una clave de Prueba, selecciona Guardar en la biblioteca para ponerla a disposición en la biblioteca.

El entorno y la ubicación de almacenamiento son independientes. Guardar una clave de Prueba en la Biblioteca de claves la hace reutilizable, pero no la convierte en un valor de Producción.

Usa En este proyecto de forma predeterminada. Guarda una clave en la biblioteca solo cuando estés seguro de que debe compartirse entre proyectos.

Usa un valor de Producción separado

Cuando publicas un proyecto que usa una clave guardada, el flujo de publicación puede pedirte que configures Claves de Producción. De forma predeterminada, la app publicada usa el valor de Prueba. Para usar una credencial diferente, selecciona Producción y guarda un valor separado para la clave.

Usa un valor de Producción separado cuando:

• El proveedor proporciona credenciales diferentes para prueba y activas.
• No quieres que la credencial usada durante el desarrollo sea usada por la app publicada.

Los valores de Producción se crean a través del flujo de publicación. No puedes crear uno seleccionando Nueva clave desde la pestaña Claves de Producción. Después de que se haya configurado un valor de Producción para una app publicada, puedes verlo en Nube de Atoms → Claves → Claves de Producción.

Después de publicar o actualizar la app, repite el recorrido de usuario correspondiente en el sitio web publicado para confirmar que la clave de Producción funciona correctamente. Para el proceso completo de despliegue, consulta Publicar y desplegar.

Actualizar o rotar una credencial

Actualizar un valor de Prueba guardado

1. Abre Nube de Atoms → Claves → Claves de Prueba.
2. Abre En este proyecto o Biblioteca de claves, según dónde se haya guardado la entrada.
3. Selecciona el Valor o la Descripción de la clave, introduce la información actualizada y luego selecciona Actualizar.
4. Espera a Guardado correcto y luego vuelve a probar el flujo afectado.

Rotación planificada de claves

Sigue estos pasos cuando la credencial existente aún sea segura y quieras reemplazarla sin interrumpir tu app:

1. Crea una credencial de reemplazo a través del proveedor del servicio.
2. Reemplaza el valor de Prueba en Atoms y luego prueba la función afectada en el Visor de Apps.
3. Si la app publicada usa un valor de Producción separado, reemplázalo y publica la actualización.
4. Prueba la misma función en el sitio web publicado.
5. Después de confirmar que el reemplazo funciona correctamente, revoca la credencial antigua a través del proveedor.

Si una credencial podría haber quedado expuesta

Trata la credencial como comprometida y actúa de inmediato:

1. Revócala o desactívala a través del proveedor del servicio.
2. Crea una credencial de reemplazo.
3. Actualiza los valores de Prueba y Producción correspondientes en Atoms.
4. Vuelve a probar las funciones afectadas tanto en el Visor de Apps como en la app publicada.
5. Elimina cualquier copia expuesta del código fuente, Chat, capturas de pantalla y registros cuando sea posible.

Eliminar una clave o quitar su valor de Atoms no revoca la credencial original. Debes revocarla a través del proveedor del servicio.

Eliminar una credencial

Antes de eliminar una clave guardada, asegúrate de que tu app ya no dependa de ella:

1. Elimina la función que usa la clave o reemplaza sus referencias por otra clave guardada.
2. Revoca la credencial original a través del proveedor del servicio para que ya no pueda usarse.
3. Abre Nube de Atoms → Claves, busca la entrada inactiva, selecciona Eliminar y confirma.

Eliminar una clave no se puede deshacer. También puede romper vistas previas o checkpoints antiguos que aún hagan referencia a ella. Si Eliminar no está disponible, la clave sigue marcada como activa. Elimina o reemplaza cada referencia a ella antes de volver a intentarlo.

Preguntas frecuentes

Mi clave de Prueba funciona en Visor de Apps pero no después de publicar. ¿Por qué?

Si tu clave de Prueba funciona en Visor de Apps pero la app publicada falla porque falta una clave o está vacía:

1. Comprueba si el valor de Prueba o Producción correspondiente se guardó antes o después de la última publicación. Si se guardó después, publica de nuevo para que el cambio surta efecto.
2. Verifica que la clave guardada tenga el valor correcto de Prueba o Producción. La app publicada usa el valor de Prueba a menos que se configure un valor de Producción separado.
3. Revisa los errores del servicio descendente para obtener pistas. “No autorizado” suele indicar una clave vacía o incorrecta para ese entorno.

Si el problema persiste, contacta con Soporte e incluye:

• Enlace del proyecto o URL activa
• El nombre de la clave afectada y si el problema está en el valor de Prueba o Producción
• El error completo del servicio descendente
• Una captura de pantalla saneada de la página de configuración
• Si la configuración de la clave se guardó antes o después de publicar

Importante: Proporciona solo nombres de claves. NO envíes valores secretos, contraseñas ni tokens.