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ónde | Ejemplo |
|---|---|
| El valor de un header | Authorization: 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é
| Lector | Miembro | Administrador | Propietario | |
|---|---|---|---|---|
| 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
syncdevuelve"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.
Funciones
Deja que tu propio código actúe sobre un resultado — la respuesta nombra la función y sus params, y los SDKs de TypeScript y Python llaman al handler que registraste, en orden y una vez por llamada.
Entrega y reintentos
Cómo Dcision entrega webhooks, solicitudes a APIs, workflows y traspasos a agentes — al menos una vez, seis intentos en unas siete horas, Retry-After, timeouts, estados, reenvíos y retención.