Secretos del workspace

Mantén los tokens y las URLs secretas fuera de las decisiones — secretos del workspace referenciados como {{secrets.NAME}}, quién puede gestionarlos, cómo se guardan y ocultan, y cuándo se aplican los cambios.

Los tokens de API, las contraseñas y las URLs secretas —una URL de webhook de Slack o de n8n— no deben estar en una decisión: el schema tiene versiones, se muestra en el editor y se guarda con cada deploy. Guárdalos en los secretos del workspace y haz referencia a ellos por su nombre.

Agregar un secreto

En Configuración → Destinos → Secretos, escribe un nombre y un valor y haz clic en Agregar secreto (o en Reemplazar para un nombre que ya existe).

  • Los nombres van en UPPER_SNAKE_CASE: una letra mayúscula, luego letras mayúsculas, dígitos y _, hasta 64 caracteres: CRM_TOKEN, SLACK_WEBHOOK.
  • Los valores tienen de 1 a 4,096 caracteres y son de solo escritura: una vez guardado, la app muestra el nombre, los últimos 4 caracteres (a los administradores) y cuándo cambió, nunca el valor.
  • Un workspace guarda hasta 50 secretos.

Úsalo

Escribe {{secrets.NAME}} donde un destino lo necesite:

DóndeEjemplo
El valor de un headerAuthorization: Bearer {{secrets.CRM_TOKEN}}
Una URL completa{{secrets.SLACK_WEBHOOK}} como la URL de una solicitud de API o de un webhook
Un body http{"api_key": {{secrets.MAILER_KEY}}}

Un secreto puede ser el comienzo de una URL —la URL completa— o parte de un header o de un body. Los secretos no pueden usarse en respuestas fijas, en prompts y entradas de LLM, ni en instrucciones de agentes: ese texto se devuelve a quien llama o se envía a un modelo.

Quién puede hacer qué

LectorMiembroAdministradorPropietario
Ver los nombres de los secretos (para escribir plantillas)—✓✓✓
Ver los últimos 4 caracteres——✓✓
Agregar, reemplazar y eliminar secretos——✓✓
Revelar y rotar el secreto de firma——✓✓

Cómo se protegen

  • Se cifran en reposo con AES-256-GCM. Los valores nunca salen de la API, salvo dentro de la solicitud en la que se renderizan.
  • Nunca en el schema de la decisión, en la respuesta de la API, en el registro de ejecuciones ni en el Playground: las vistas previas muestran •••• en su lugar, y el registro de entregas guarda solo una vista previa oculta de cada solicitud: método, URL, headers y el tamaño del body.
  • La solicitud completa, con los secretos, se guarda cifrada mientras una entrega todavía pueda necesitarla; consulta Entrega y reintentos.

Cuándo se aplican los cambios

Los secretos se leen cuando se ejecuta la decisión: Dcision renderiza la solicitud con los valores actuales y la guarda, cifrada, para sus intentos.

  • Un valor nuevo o modificado se aplica a las siguientes ejecuciones. Las entregas que ya están en cola —y sus reintentos— conservan la solicitud con la que se renderizaron.
  • Un destino que hace referencia a un secreto que no existe falla su entrega de inmediato, con "Set the secret CRM_TOKEN in Settings → Destinations, then resend.": no se envía nada. Como la solicitud se renderizó sin el secreto, agrégalo y vuelve a ejecutar la decisión: reenviar esa entrega falla de la misma manera. Un agente en modo sync devuelve "status": "failed" con el mismo consejo.
  • Eliminar un secreto hace que los destinos que lo usan fallen hasta que se vuelva a definir.

El secreto de firma

Aparte de estos secretos, cada workspace tiene un secreto de firma (whsec_…) que firma todas sus entregas. Los administradores y el propietario lo revelan y lo rotan en Configuración → Destinos → Secreto de firma; consulta Verificar la firma y Rotar el secreto de firma.

En esta página