Modos de aplicación: observe, shadow y enforce

Antes de que una regla bloquee el tráfico de producción, quieres saber que se dispara en las cosas correctas y en nada más. OrcaRouter te da tres posturas — observe, shadow y enforce — que te permiten desplegar incrementalmente, con visibilidad en cada paso y sin sorpresas. Esta página explica qué significa mecánicamente cada postura, cómo transitar entre ellas y cómo los niveles de autonomía establecen todo en un paso.

​

1. Las tres posturas de un vistazo

​

2. Postura observe — mide antes de gobernar

La postura observe no es un solo interruptor. Es una combinación de tres mecanismos independientes que juntos producen “permite todo, registra todo”:

​

Observe mode del firewall (configuración del espacio de trabajo)

Cuando una llamada a herramienta resuelve a ninguna política en absoluto — sin adjunto de clave y sin valor por defecto del espacio de trabajo — el observe mode a nivel de espacio de trabajo del firewall determina qué ocurre:

• Observe mode activado: la llamada está permitida y se registra como una brecha de cobertura. La vista de Discovered Tools se llena con estos eventos de brecha, mostrando exactamente qué herramientas están ejecutando tus agentes sin ninguna regla que las cubra.
• Observe mode desactivado: la llamada está permitida silenciosamente — byte-idéntico a un espacio de trabajo que nunca habilitó la función.

El observe mode es la superficie de detección de brechas. Solo se dispara cuando no se resuelve ninguna política. No es lo mismo que tener una política establecida en audit.

​

Veredicto audit del firewall (por defecto de la política)

Cuando una política sí se resuelve pero ninguna regla coincide con una llamada a herramienta, se aplica el default_verdict de la política. El valor por defecto para default_verdict es audit — permite la llamada y la registra para revisión. Una nueva política sin reglas y sin cambios de configuración no bloquea nada y no permite nada silenciosamente: audita todo lo que ve. audit también es un veredicto normal de regla. Una regla que coincide y produce audit deja pasar la llamada y la registra — el análogo del modo de auditoría del guardrail para el firewall.

​

Acción flag del guardrail (acción por regla)

En el lado de los guardrails, la acción flag es el equivalente observe: la regla se dispara, se registra una coincidencia en el feed de Matches y la solicitud continúa sin cambios. Sin bloqueo. Sin redacción. Usa flag cuando quieras medir una regla — ver con qué frecuencia se dispara y en qué — antes de comprometerte con block o mask.

---

Juntos, estos tres producen la postura observe: el observe mode captura las llamadas a herramienta sin cobertura; los veredictos audit cubren las llamadas a herramienta bajo una política pero no aún bajo una regla específica; las acciones flag cubren las verificaciones de guardrail que aún no estás listo para aplicar.

​

3. Postura shadow — valida antes de aplicar

El modo shadow es un flag por política (shadow_mode: true) en una política de firewall. Cuando está activado:

• La política evalúa cada llamada a herramienta exactamente como lo haría en producción — las reglas se comparan, los veredictos se calculan, los predicados de argumentos se prueban.
• Cada veredicto aplicante (deny, sanitize, pending_approval) se degrada a audit antes de llegar a la herramienta.
• La razón registrada tiene el prefijo [shadow] would … para que puedas ver en el feed de eventos exactamente qué se hubiera bloqueado, saneado o retenido.

El modo shadow es tu interruptor de despliegue seguro. Escribe una política, activa shadow, apunta tráfico real a ella, observa las vistas de eventos y ejecuciones durante unas horas o días, confirma que la política se dispara en las herramientas correctas y nada inesperado, luego desactiva shadow para empezar a aplicar.

​

4. Postura enforce — veredictos reales, consecuencias reales

En la postura enforce, nada se degrada:

• Firewall deny → el agente ve un error de herramienta (MCP) o HTTP 400 firewall_blocked (superficie inbound). El error nombra la herramienta y la razón. Marcado skip-retry.
• Firewall sanitize → las subcadenas coincidentes se redactan de los argumentos de la herramienta y la llamada limpia se reenvía.
• Firewall pending_approval → la llamada se retiene; el agente recibe HTTP 400 firewall_approval_pending y un id de aprobación sobre el que hacer polling.
• Guardrail block → HTTP 400 guardrail_blocked, nombrando el guardrail y la regla que se disparó. No cuesta cuota.
• Guardrail mask → la coincidencia se redacta (p. ej. jane@acme.com → [EMAIL]) y la solicitud continúa con el texto saneado.

Para llegar a la postura enforce: desactiva shadow_mode en la política del firewall y cambia las acciones de regla del guardrail de flag a block o mask según corresponda.

​

5. Despliegue recomendado

​

6. Niveles de autonomía — establecer todo a la vez

Ajustar políticas regla por regla es el camino preciso. Los niveles de autonomía son el rápido — un único control que establece atómicamente la postura de Firewall y Guardrails de tu espacio de trabajo en una transacción, con deshacer de un clic: Aplica vía POST /api/workspace/firewall/autonomy (Developer+). El endpoint Simulate (GET /api/workspace/firewall/simulate?level=) previsualiza lo que haría un cambio de nivel antes de aplicarlo.

​

7. Mapa de mecanismos — qué configuración hace qué

Esta tabla es la referencia autoritativa. Los cuatro términos son distintos — no los confundas:

---

Los modos de aplicación no son un binario on/off. Transita por observe → shadow → enforce y tus reglas están verificadas en tráfico real antes de que alguna vez lo bloqueen.