Documentación

Decisiones

Cómo Seguridad clasifica lo que te espera en decisiones, ya respondidas por CoRoid, en tres grupos, y cómo puedes revisar las respuestas y aplicarlas grupo por grupo.

Seguridad puede encontrar muchos elementos: un paquete vulnerable reportado por seis avisos, un escáner de secretos que detecta la misma contraseña de ejemplo en cincuenta archivos de documentación. No decides sobre los hallazgos uno por uno. Seguridad los clasifica en decisiones: cada hallazgo abierto que una respuesta resuelve. CoRoid ya ha respondido a cada uno. Revisas sus respuestas, modificas las que estén incorrectas y las aplicas grupo por grupo.

Decisiones es una pestaña de Seguridad, entre Resumen y Proyectos. Su recuento indica cuántas decisiones son urgentes.

¿Qué constituye una decisión?

  • Un paquete, en todos tus proyectos: "hono → 4.13.16 en 2 proyectos" es una decisión, independientemente de cuántos avisos corrija la actualización.
  • Una carpeta de código de pruebas o herramientas: todo lo que esté bajo e2e/ o el directorio de una herramienta de programación .opencode/, sea cual sea el tipo de hallazgo y la gravedad que le haya asignado el escáner.
  • Ejemplos de un mismo tipo: credenciales escritas a propósito en la documentación, palabras en catálogos de traducción, datos de ejemplo, .example archivos.
  • Una regla en un servicio: "Control de acceso defectuoso en apps/api-admin". Las afirmaciones que no hayan sido confirmadas mediante verificación independiente constituyen una decisión aparte de los hallazgos confirmados.
  • Una regla de secreto en el código de un proyecto.

Un hallazgo cuya corrección ya esté en curso no forma parte de ninguna decisión. Se lista una vez bajo los grupos ("CoRoid ya está trabajando en 2 más") y solo reaparece si la corrección falla. Un hallazgo oculto mediante una excepción tampoco forma parte de ninguna decisión.

Tres grupos

  • Urgentes: aquellos explotados en cualquier lugar, o críticos o cuyo plazo de corrección ya haya pasado en lo que despliegas. Abórdalos primero.
  • Deberían corregirse: en lo que despliegas, pero sin haber superado su plazo de corrección. Pueden esperar unos días.
  • Limpieza: código de pruebas, herramientas, ejemplos y afirmaciones de baja gravedad, sea cual sea su severidad. En su mayoría son ruido y se resuelven en bloque.

Cada grupo muestra cuántas decisiones quedan pendientes, cuánto tiempo tardarán en resolverse y una barra que indica lo que ya has respondido hoy.

La respuesta de CoRoid

Cada decisión incluye la respuesta de CoRoid, con Seguro o Probable y una línea que explica el motivo. Abre una decisión para leer toda la justificación, dónde se encuentran sus hallazgos y cada respuesta con la acción correspondiente.

Cuando solo una persona puede determinarlo, por ejemplo si una credencial en tu código es real, la decisión no tiene respuesta y indica Requiere tu atención. La función Aplicar la pasa por alto hasta que tú elijas.

Evaluación a partir del código

Una decisión sobre una credencial o un hallazgo de código se abre con Dónde se encuentra: cada ubicación, con las líneas circundantes tal como aparecían en la confirmación en la que el escáner lo detectó, la línea marcada y, para un repositorio de GitHub, Abrir en GitHub, que abre esa línea en dicha confirmación. No necesitas un editor ni hacer checkout para decidir.

La propia credencial nunca sale de la copia del repositorio de CoRoid. Cualquier valor que parezca una credencial en las líneas mostradas se oculta, y Seguridad solo te indica su longitud y aspecto:

  • una palabra predeterminada común, del tipo que usa una configuración local (changeme, postgres);
  • de aspecto aleatorio, como suele ser una clave o contraseña real;
  • texto legible, como una frase de acceso.

En la mayoría de los casos, lo que determina la decisión permanece visible: la variable a la que se asigna, el host en una cadena de conexión, si la línea es un comentario y referencias como ${DB_PASSWORD} que no contienen valor.

Si un archivo se eliminó después de que el escáner detectara la credencial, la ubicación lo indicará. Eliminar un archivo no borra la credencial del historial del repositorio: cualquiera que pueda leer el repositorio aún podrá encontrarla en las confirmaciones anteriores. Si es real, cámbiala.

RespuestaQué hace
Iniciar correcciónCrea una tarea para los hallazgos de la decisión en cada proyecto. La corrección se devuelve como un pull request.
Verificar y luego corregir lo realLa misma tarea para las afirmaciones: primero verifica cada una, corrige las reales y deja una nota sobre las demás.
Abrir actualizaciónAbre la actualización como trabajo de corrección, un pull request por proyecto.
Ignorar carpetaLos hallazgos bajo esa carpeta dejan de contarse, tanto ahora como en escaneos posteriores. Puedes deshacerlo.
No es un secretoCierra los hallazgos y el escáner de seguridad aprende de tu respuesta.
No es un problema...Los marca como falsos positivos, con tu motivo incluido en su historial.
Aceptar durante 90 díasLos oculta durante 90 días o hasta que su gravedad aumente.
Sí, rotarloArchiva la lista de verificación de rotación. El hallazgo se cierra cuando confirmes que el valor antiguo ya no funciona.
Sí, ya se ha rotadoLos cierra con tu confirmación.
Delegar a un administrador...Lo mueve a la lista de otro propietario o administrador, con tu nota.
Omitir para hoyReaparecerá mañana, en el mismo lugar.

Cuando cambias una respuesta, Seguridad propone la misma respuesta para las decisiones similares: "1 decisión más tiene este aspecto... Misma respuesta".

Aplicar un grupo

Aplicar Aplica todas las respuestas del grupo que estén listas. Un mensaje indica qué actividades se han iniciado (se muestran en la Fábrica) y ofrece Deshacer. Respondidas hoy Muestra tus respuestas. Puedes recuperar aquellas cuyos registros lo permitan: excepciones, veredictos, omisiones y delegaciones. Las actividades iniciadas se detienen en la Fábrica, no aquí.

Cuando se completa lo urgente, Seguridad indica cuántas decisiones quedan y cuántas de ellas superaron su fecha de corrección, y luego ofrece Detener para hoy o Continuar.

El teclado también funciona: ↑ y ↓ permiten desplazarse entre decisiones, Enter abre una, 1 a 9 seleccionan una respuesta y ⌘ Enter la aplica.

En la Fábrica

La Fábrica Requiere tu atención mantiene una fila de Seguridad mientras una decisión es urgente: "5 decisiones urgentes · unos 2 minutos · 32 en total". Iniciar abre Decisiones. Una decisión que no puede esperar tiene su propia fila: un paquete explotado, un hallazgo crítico confirmado o una credencial que una persona ha confirmado que es real en lo que desplegas.

Una vez que nada sea urgente, la fila desaparece de Requiere tu atención y aparece una línea que indica cuántas decisiones pueden esperar a tu próxima sesión.

Quién responde

Los propietarios y administradores responden a las decisiones. Los miembros las leen junto con sus pruebas. Las herramientas MCP y Chat de CoRoid muestran las mismas decisiones (list_security_needs). Consulta Seguridad desde MCP y Chat.