Docs

Lista de seguridad

Qué cerrar en un motor con alojamiento propio antes de que le llegue tráfico real, cada punto con el ajuste o el comando que lo hace y la comprobación que lo demuestra.

Aplica a Motor Al lanzar

Ver como Markdown
En esta página
  1. 1. El token raíz
  2. 2. La dirección
  3. 3. El bucket
  4. 4. La base de datos
  5. 5. Tokens de API
  6. 6. Llaves de ingesta
  7. 7. La Consola y el servidor MCP
  8. 8. A qué llama el motor
  9. 9. Qué se graba
  10. 10. Secretos, logs y actualizaciones
  11. Si algo salió mal
  12. Relacionado

Motor Esta página es para quien está por apuntar una app real a un motor con alojamiento propio. Recórrela una vez antes de producción y otra después de cualquier cambio en el despliegue. En Sypnia Cloud esto es trabajo nuestro, y lo que hacemos está en Prácticas de seguridad.

Empieza por la comprobación del propio motor. La mayoría de los puntos de abajo aparecen ahí:

Terminal
sypnia doctor
Deberías ver
all checks passed, con 0 unknown en la configuración y ninguna línea de advertencia. Un webhook sin secreto, o una variable mal escrita, es una advertencia aquí.

1. El token raíz

El token raíz puede hacer todo en todos los proyectos, incluso eliminarlos.

Haz estoCómoComprobación
Que sea largo y aleatorioopenssl rand -hex 32. El motor rechaza menos de 32 caracteres.El motor arranca.
Mantenlo fuera de las apps, del CI y de los agentes de códigoÚsalo para crear los proyectos y sus primeros tokens, y luego guárdalo. Todo lo demás funciona con un token de API.Búscalo en los secretos de tu CI y en la configuración de tus agentes: no debería estar en ninguno.
Nunca lo pegues en un navegadorLa Consola lo rechaza.
Aprende a reemplazarloCambia SYPNIA_ROOT_TOKEN y reinicia. El viejo deja de funcionar de inmediato.curl -i <tu URL base>/v1/whoami -H "Authorization: Bearer <el token viejo>" responde 401.

2. La dirección

Haz estoCómoComprobación
Sirve todo por HTTPSUn proxy o un balanceador de carga con TLS delante del motor. SYPNIA_BASE_URL empieza por https://.La línea address de sypnia doctor.
Deja privado el puerto del motorSolo el proxy llega al puerto 8080. En el archivo de Compose el servicio sypnia no tiene ports.Desde fuera: curl <dirección del servidor>:8080/healthz no recibe respuesta.
Dile al motor cuántos proxies tiene delanteSYPNIA_TRUSTED_PROXY_HOPS: 1 detrás de un proxy, 0 sin ninguno. Si es muy bajo, todos los visitantes comparten un solo límite de peticiones. Si es muy alto, quien llama puede falsear su dirección para esquivar el límite.Envía peticiones desde dos redes: cada una tiene su propio RateLimit-Remaining.
Deja la API de lectura cerrada a otros sitiosSYPNIA_API_CORS_ORIGINS vacío, salvo que una app web tuya llame a la API de lectura desde un navegador.

3. El bucket

Haz estoCómoComprobación
Mantenlo privadoBloquea todo acceso público. Nada se lee jamás sin un enlace que firma el motor. La plantilla de AWS lo hace.Abre la dirección simple de cualquier objeto en un navegador: 403.
Dale al motor una llave solo para este bucketUna llave o un rol que pueda leer, escribir, listar y borrar en este único bucket. En AWS, deja las llaves vacías y que el motor use su rol.Con esa llave, listar otro bucket se rechaza.
Deja que solo tu dirección lea grabaciones desde un navegadorLa regla CORS del bucket nombra tu URL base, no *. Ver la regla.
Que los enlaces firmados duren pocoSYPNIA_STORAGE_PRESIGN_TTL_SECONDS en su valor por defecto de 900, o menos.
Cífralo en reposoEl ajuste propio de tu almacenamiento. La plantilla de AWS lo enciende.
Deja el versionado apagado, o vence las versiones viejasSi no, los datos eliminados sobreviven en las versiones viejas. Ver Estructura del almacenamiento.

4. La base de datos

Haz estoCómoComprobación
Dale a Sypnia una base de datos y un usuario propiosNo la base de datos de tu app. El usuario necesita crear tablas en su propio esquema, nada más.
Cifra la conexión?sslmode=require al final de SYPNIA_DATABASE_URL siempre que la base de datos no esté en la misma máquina.La línea database de sypnia doctor.
Limita quién puede llegar a ellaUna red privada o una lista de permitidos donde puedas. La base de datos que crea la plantilla de AWS se alcanza desde internet, con TLS y una contraseña generada; lee por qué y decide.
Respáldala, y prueba una restauraciónRespaldos.Existe un volcado de anoche en un lugar que no es el servidor.

5. Tokens de API

Un token de API lee tu proyecto. Con replay lee lo que tus usuarios vieron en sus pantallas. Con admin cambia la configuración y elimina datos.

Haz estoCómoComprobación
Un token por persona y por herramientasypnia token create --name dice quién o qué.sypnia token list --project shop se lee como una lista de personas y herramientas.
Los menos alcances posiblesread para un agente de código. read,replay para una persona que ve grabaciones. admin solo para el CI y para ti.
Una fecha de vencimiento--expires 90d para personas, --expires 365d para el CI.La columna EXPIRES no tiene ningún never que no puedas explicar.
Revoca lo que no se usasypnia token revoke. Se rechaza en menos de un minuto.La columna LAST USED.
Mantén los tokens fuera del código y de los chatsEn los secretos de tu CI y en la configuración propia de tu agente. Nunca en un repositorio, un ticket o un mensaje de soporte.

6. Llaves de ingesta

Una llave de ingesta es pública por diseño: cualquiera que lea tu página puede enviar eventos con ella. Lo que te protege es lo que la llave no puede hacer, y tres límites que pones tú.

Haz estoCómoComprobación
Lista los orígenes que pueden enviar desde un navegadorPATCH /v1/projects/{project_ref} con {"settings": {"allowed_origins": ["https://shop.example.com"]}}. Vacío acepta cualquier origen.Una petición con otro Origin responde 403 origin_not_allowed.
Una llave por appsypnia key create --project shop --name "Checkout API", para poder revocar una sin detener las demás.
Un límite de peticiones a la medida--rate-limit en la llave, o SYPNIA_RATE_LIMIT_INGEST_PER_MINUTE para las llaves nuevas.
Un techo a lo que puede guardar un proyectoSYPNIA_QUOTA_EVENTS_PER_MONTH y SYPNIA_QUOTA_REPLAYS_PER_MONTH. Protegen tu almacenamiento y tu factura de un bucle o de un abuso.GET /v1/usage muestra los límites.

Los orígenes permitidos impiden que otros sitios web envíen con tu llave. No detienen a un script que falsea el encabezado; para eso están el límite de peticiones y la cuota.

7. La Consola y el servidor MCP

Haz estoCómoComprobación
Decide quién puede cargar la ConsolaUna regla del proxy sobre /console, o SYPNIA_CONSOLE_ENABLED=false. Ver Protegerla.
Decide si los agentes de código pueden marcar problemas como resueltosSYPNIA_MCP_READ_ONLY=true quita la única herramienta de MCP que escribe. Ver Seguridad de MCP.
Apaga lo que no usesSYPNIA_MCP_ENABLED=false quita el servidor MCP en /mcp.<tu URL base>/mcp responde 404.

8. A qué llama el motor

El worker hace peticiones a direcciones que eligen las personas con un token admin. Deja los valores por defecto salvo que tengas un motivo.

Haz estoCómo
Mantén las comprobaciones de disponibilidad lejos de tu red privadaSYPNIA_UPTIME_ALLOW_PRIVATE_ADDRESSES se queda en false. Si no, cualquiera con un token admin puede hacer que el motor sondee direcciones dentro de tu red.
Mantén los webhooks en HTTPS y en direcciones públicasSYPNIA_WEBHOOKS_ALLOW_HTTP se queda en false.
Firma el webhook de alertasConfigura SYPNIA_ALERT_WEBHOOK_SECRET, y comprueba la firma en tu receptor. Ver la referencia de webhooks.
Decide qué puede ver el proveedor de IACon un proveedor configurado, el agente le envía stacks, trazas y las líneas de código alrededor de la falla. SYPNIA_AI_SEND_SOURCE=false deja tu código fuera. Un endpoint compatible con OpenAI dentro de tu red deja todo adentro. La lista completa: Modelos y qué se envía.
Ponle tope a la factura del modeloDeja SYPNIA_AI_MAX_ANALYSES_PER_DAY en 100 o menos, y pon un límite de gasto a la llave en tu proveedor.

9. Qué se graba

Asegurar el motor es la mitad. La otra mitad es lo que envía tu app.

Haz estoCómo
Mira una grabación de cada pantalla sensible antes de producciónLo que se escribe siempre se enmascara. El texto que muestra la página se graba como se ve, salvo que lo enmascares. Ver Enmascarado.
Apaga la grabación donde no correspondesettings.replay.blocked_routes en el proyecto, o SYPNIA_REPLAY_ENABLED=false para todo el motor.
No publiques tus source mapssypnia sourcemaps upload … --delete-after los quita de lo que despliegas.
Elige cuánto viven los datos personalesRetención.
Aprende a eliminar a una personaEliminar datos.

10. Secretos, logs y actualizaciones

Haz estoCómo
Mantén privado el archivo de configuraciónchmod 600 .env, y fuera de cualquier repositorio. En AWS la configuración son variables de entorno de las funciones: cualquiera en la cuenta que pueda leer la configuración de una función puede leerlas, incluido el token raíz. Limita quién tiene ese permiso.
Deja el nivel de logs en infoEl motor nunca registra cuerpos, llaves ni tokens, en ningún nivel. debug registra una línea por petición, que es mucho para guardar.
Cuida los logs del proxyGuardan direcciones IP, y la llave de ingesta cuando un navegador la envía como ?key=. La llave de ingesta es pública; las direcciones son datos personales. Guarda esos logs el menor tiempo que puedas.
Sigue las publicacionesVigila el repositorio del motor para enterarte de las versiones nuevas. Los arreglos de seguridad van marcados en el registro de cambios.
Actualiza en un tiempo razonableLas actualizaciones están hechas para ser aburridas: migrar, reemplazar, comprobar.

Si algo salió mal

Qué pasóPrimero, en minutosDespués
Se filtró un token de APIsypnia token revoke <token_id>Crea uno nuevo. Revisa LAST USED en los demás.
Se filtró el token raízCambia SYPNIA_ROOT_TOKEN y reiniciasypnia project list y sypnia token list para cada proyecto: busca cualquier cosa que no hayas creado tú.
Están abusando de una llave de ingestasypnia key create, despliega tu app con la llave nueva, y luego sypnia key revoke a la viejaConfigura orígenes permitidos y una cuota. Los eventos que ya se guardaron se quedan; un proyecto en el que ya no confías se puede eliminar y volver a crear.
Una grabación muestra algo que no deberíaEnmascara el elemento y despliegaElimina las sesiones que lo grabaron: Eliminar datos.
Encontraste una falla en Sypnia mismoNo la publiquesEscribe a la dirección que está en Prácticas de seguridad.

Relacionado

Secciones

Empieza aquíQué es Sypnia, cómo funciona, qué es código abierto y qué es la nube de pago, y las dos maneras de recibir tu primer problema en palabras claras.ConceptosLas diez ideas de las que está hecho Sypnia, cada una definida con precisión, desde un proyecto y sus llaves hasta los problemas, las trazas y las alertas.SDKCómo envía tu app los datos a Sypnia. Un SDK para el navegador, uno para Node, uno para Next.js, y la entrada de OpenTelemetry para cualquier otro backend.El agenteCómo analiza Sypnia un problema, qué escribe, qué le envía a un modelo y qué nunca hace.MCP y skillsConecta tu agente de código a Sypnia para que pregunte qué está fallando en producción, lea lo que necesita para arreglarlo y configure Sypnia por ti.Referencia de la APILa API HTTP de Sypnia: una sola API para el motor de código abierto y para Sypnia Cloud, con cada endpoint, parámetro, respuesta y error.Referencia de la CLIEl comando sypnia: cómo instalarlo, qué variables lee, qué significan sus códigos de salida y dónde está documentado cada comando.Alojamiento propioQué corres cuando alojas tú mismo el motor de Sypnia, qué necesitas, cuánto cuesta y qué no tienes frente a Sypnia Cloud.Cómo está construido el motorTodo el motor de Sypnia en una página, desde un clic en tu app hasta la frase que lee tu agente de código, con las reglas de diseño y el código que las sostiene.Sypnia CloudCómo funciona el servicio pago, desde las organizaciones y los roles hasta los planes, los límites, la facturación, dónde viven tus datos, la GitHub App y el soporte.Privacidad y seguridadQué recoge Sypnia de tu app y de sus usuarios, qué no recoge nunca, cómo funciona el enmascarado, cómo eliminar datos y cómo se protege el servicio.LicenciasQué licencia cubre cada parte de Sypnia, qué puedes hacer con ella, cómo se puede usar el nombre, y los términos de una contribución.GuíasRecetas paso a paso para las formas comunes de usar Sypnia, desde apps hechas con constructores de IA y Next.js en Vercel hasta Supabase, source maps en CI, correos de alerta desde tu propio motor, y venir desde Sentry.ReferenciaLas páginas donde se consulta, desde el esquema de eventos y el glosario hasta lo planeado, el registro de cambios y las preguntas frecuentes.
↑↓ para moverte↵ para abrirEsc para cerrar