> ## Documentation Index
> Fetch the complete documentation index at: https://docs.corgea.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Justificaciones de triaje

> Exigir una razón al cerrar un hallazgo

## Descripción general

Cerrar un hallazgo es un registro de auditoría permanente. Un comentario como "falso positivo" o "riesgo aceptado" solo repite la decisión que ya quedó registrada en el estado, así que quien lea el hallazgo meses después —un compañero de equipo, una nueva persona responsable o alguien que audita— no aprende nada de él.

Corgea revisa el comentario cuando marcas un hallazgo como falso positivo o riesgo aceptado y vuelve a pedirlo si no explica la decisión. Basta con una frase concreta que alguien pueda comprobar.

> [!NOTE]
>
> El requisito de justificación afecta al comentario de un cambio de estado. No cambia quién puede cambiar un estado, que sigue estando controlado por el permiso `change_issue_status`. Consulta [Roles](https://docs.corgea.app/es/permission_groups.md).

## Dónde se aplica

Para las decisiones de falso positivo y riesgo aceptado, la revisión se ejecuta en estos lugares:

* El modal **Change Decision** de la página de detalles del hallazgo
* El panel de detalles del [Workbench de vulnerabilidades](https://docs.corgea.app/es/vulnerabilities.md)
* La barra de acciones de triaje masivo, incluidos los hallazgos de SAST, SCA e IaC
* Los cambios de estado de un solo hallazgo mediante la API (`PATCH /api/v1/detections/{issue_id}`)
* Los descartes solicitados desde una pull request mediante el [Corgea Agent](https://docs.corgea.app/es/agent.md)

![La página de detalles del hallazgo con la explicación, el código y la información de Overview](https://mintcdn.com/corgea/4wTUI7zssVC3U7_-/images/scans/issue_details_overview.png?fit=max\&auto=format\&n=4wTUI7zssVC3U7_-\&q=85\&s=75a92584f8f950d1f46b13dc932d1723)

Los demás cambios de estado, como marcar un hallazgo como corregido o duplicado y reabrirlo, están exentos de la revisión de justificación.

## Qué hace buena a una justificación

Una justificación se acepta cuando menciona al menos algo concreto que alguien pueda verificar. Basta con cualquiera de estos puntos:

> [!TIP]
>
> * **El control que hace seguro el código**: validación de entrada, escapado de salida, una consulta parametrizada, una comprobación de autorización o una garantía del framework
> * **Por qué la entrada es de confianza o la ruta es inalcanzable** en este despliegue
> * **Un control compensatorio o una razón de negocio** para asumir el riesgo, idealmente con responsable, plazo o alcance
> * **Dónde se aplicó la corrección**, o a qué hallazgo duplica este: un commit, una pull request, un ticket o un ID de hallazgo
> * **Qué interpretó mal el escáner** en el código

Ejemplos que se aceptan:

```plaintext theme={null}
La consulta de la línea 44 está parametrizada; el valor del usuario se vincula, no se concatena.
Esta entrada es el claim del JWT firmado, validado en el middleware de autenticación antes de llegar a este handler.
Endpoint solo interno detrás de la VPN. Aceptado hasta la actualización a 2.0 del próximo trimestre, a cargo del equipo de plataforma.
```

## Qué se rechaza

Un comentario se devuelve cuando no añade nada a la decisión en sí:

| Patrón | Ejemplos |
| - | - |
| Repite o etiqueta la decisión | `false positive`, `accept risk`, `won't fix`, `fixed`, `duplicate` |
| Afirma una conclusión sin dar una razón | `not exploitable`, `this is safe`, `not a real issue`, `low priority` |
| Relleno, marcador de posición o texto sin sentido | `n/a`, `test`, `asdf`, `...`, `per policy`, `as discussed` |
| Nombra a quien aprueba o un proceso, pero no una razón | `approved by security`, `reviewed`, `ticket created` |

Cuando se rechaza un comentario, Corgea explica qué falta y conserva lo que escribiste para que puedas completarlo. El estado no cambia hasta que se acepta el comentario.

Si aparece **Reviewing justification…** después del envío, la revisión sigue en curso y el hallazgo conserva su estado actual hasta que termine.

![El modal Change Decision rechaza un comentario que solo dice false positive](https://mintcdn.com/corgea/L-24If3t2LOPrEXE/images/triage/change_decision_rejected.png?fit=max\&auto=format\&n=L-24If3t2LOPrEXE\&q=85\&s=0ffa8fd249286665a7fff1257cf85e34)

> [!TIP]
>
> La misma frase seguida de una razón real sí vale. "Falso positivo: la plantilla escapa el valor antes de renderizarlo" se acepta; "falso positivo" por sí solo, no.

## Por qué Corgea nunca rechaza

La revisión comprueba si se da una razón, no lo bien redactada que está.

> [!NOTE]
>
> Una justificación nunca se rechaza por su longitud, ortografía, gramática, tono informal ni por el idioma en que está escrita. Las justificaciones escritas en cualquier idioma se revisan en igualdad de condiciones. Corgea tampoco juzga si tu razonamiento es técnicamente correcto —ese criterio sigue siendo de tu equipo— y acepta el comentario cuando tiene dudas.

Si la revisión no está disponible, el comentario se acepta y el cambio de estado se aplica. El triaje nunca se bloquea porque la revisión esté caída.

## Cerrar un hallazgo desde una pull request

El [Corgea Agent](https://docs.corgea.app/es/agent.md) escribe el mismo registro de auditoría cuando actúa sobre un comentario de una pull request, así que pide la misma razón.

Un comentario que pide descartar un hallazgo sin decir por qué —`@Corgea false positive`, `accept risk`, `not an issue`, `wontfix`— recibe una respuesta pidiendo la razón en lugar de un cambio de estado. Incluye la razón en el comentario y el agente la registra:

```plaintext theme={null}
@Corgea false positive, the query is parameterized on line 44
@Corgea accept risk until the 2.0 upgrade next quarter, this endpoint is internal-only
```

Una razón que ya diste antes en el mismo hilo cuenta, aunque tu respuesta posterior solo indique la decisión. Solo cuenta tu propia explicación; los comentarios de otras personas y las respuestas de Corgea no aportan tu justificación. Esto se aplica a los descartes —falso positivo y riesgo aceptado— porque cierran un hallazgo real. Marcar un hallazgo como corregido o duplicado desde una pull request no cambia.

Si más adelante indicas otro estado en el hilo, el Agent utiliza tu última elección. Si tu explicación deja dudas sobre el estado deseado, te pide que lo aclares.

## Exigir una segunda revisión

Una justificación explica una decisión, pero por sí sola nadie la comprueba. Los administradores de la empresa también pueden exigir que una segunda persona apruebe un descarte antes de que surta efecto.

Actívalo en **Settings → Company → Triage rules** ([abrir](https://www.corgea.app/settings/company/triage-approvals/)). La página tiene dos interruptores independientes, ambos desactivados por defecto:

* **False positive**: descartar un hallazgo como falso positivo queda pendiente de aprobación.
* **Accepted risk**: suprimir un hallazgo como riesgo aceptado queda pendiente de aprobación, con o sin fecha de expiración.

![La página Triage rules con False positive y Accepted risk activados y dos reglas de triaje automático](https://mintcdn.com/corgea/gXE6s3uSV4XQ0K2H/images/settings/triage_rules.png?fit=max\&auto=format\&n=gXE6s3uSV4XQ0K2H\&q=85\&s=aecf2cd18443c22cf898ed8a77c33603)

Con una decisión activada, tomarla desde la página de detalles del hallazgo, el panel del workbench o la barra de triaje masivo crea una solicitud en lugar de cambiar el estado. Los hallazgos de **Containers** e **IaC** cambian de inmediato; la aprobación no se les aplica. Cualquier otro hallazgo mantiene el estado que tiene y aparece como **Pending approval** hasta que alguien lo revisa. Tu justificación viaja con la solicitud: es lo que lee quien revisa.

![Un hallazgo que sigue en Open mientras una solicitud de falso positivo espera aprobación](https://mintcdn.com/corgea/L-24If3t2LOPrEXE/images/triage/pending_approval_finding.png?fit=max\&auto=format\&n=L-24If3t2LOPrEXE\&q=85\&s=cf0f3b8c7652075f1eb565fc02e521dd)

### Revisar solicitudes

La revisión se hace desde la cola de aprobaciones en [/approvals/](https://www.corgea.app/approvals/), con las pestañas **Pending**, **Approved**, **Rejected**, **Withdrawn** y **Reverted**. Puedes filtrar por decisión, proyecto, solicitante, gravedad y recomendación, acotar a **Everyone**, **Waiting on me** o **Mine**, y buscar por CWE, CVE, ruta, proyecto, justificación, nota de revisión y solicitante. Los filtros van en la cadena de consulta, así que una vista filtrada se puede compartir como enlace.

El filtro de recomendaciones incluye **Has recommendation**, **Approve**, **Reject** y **No recommendation**. En **Pending**, una solicitud de falso positivo se oculta cuando todos sus hallazgos son de código y el último escaneo completo terminado del proyecto ya marca cada uno como falso positivo. Una solicitud que incluye un hallazgo de dependencias sigue visible. Activa **Closed by rescan** para ver las solicitudes ocultas. Siguen pendientes y requieren una decisión de revisión.

![La cola de aprobaciones en Pending, filtrada por Waiting on me, con Severity, Recommendation y Closed by rescan](https://mintcdn.com/corgea/K88fBiyu9iuG0Rzy/images/triage/approvals_queue.png?fit=max\&auto=format\&n=K88fBiyu9iuG0Rzy\&q=85\&s=e84d58968fb355ff681d3dad01a6acf2)

Quien revisa debe ser una persona distinta de quien solicita, de la misma empresa, con permiso para aprobar solicitudes de triaje y para cambiar todos los tipos de hallazgo incluidos en la solicitud. Aprobar o rechazar admite una nota opcional, y quien solicita puede retirar sus propias solicitudes.

> [!NOTE]
>
> Quienes pueden aprobar solicitudes están exentos de su propio control, por lo que sus decisiones se aplican de inmediato. Todos ven sus propias solicitudes. Los revisores también ven las de otras personas; con el control de acceso a proyectos, los revisores que no son administradores deben tener acceso a todos los proyectos de una solicitud.

Cada paso —la solicitud, la aprobación o el rechazo, cualquier nota de revisión y una retirada— queda registrado en el historial del hallazgo.

La aprobación aplica la decisión solicitada aunque el estado, el comentario o el vencimiento del riesgo aceptado hayan cambiado durante la espera. Se omiten los hallazgos corregidos o eliminados desde el envío de la solicitud. La cola y el diálogo de confirmación muestran cuántos hallazgos se omitirán; la revisión completada muestra cuántos se omitieron.

### Deshacer una aprobación

En **Approved**, una persona revisora autorizada puede hacer clic en **Undo** y confirmar **Undo approval** para restaurar el estado, el comentario y la fecha de vencimiento del riesgo aceptado que la aprobación sustituyó. Debe ser alguien distinto de quien hizo la solicitud y tener permiso de aprobación, permiso para cambiar los tipos de hallazgos afectados y acceso a los proyectos de la solicitud.

Solo se restauran los hallazgos a los que se aplicó la aprobación. Si alguno se ha eliminado o ha cambiado su estado, comentario o vencimiento, se rechaza toda la operación. Los hallazgos omitidos durante la aprobación no cambian. La solicitud pasa a **Reverted**, su tarjeta muestra **Undone** y la operación queda registrada en el historial del hallazgo. Quien hizo la solicitud recibe un correo según sus preferencias de notificación. Si falla una operación encolada para procesarse en segundo plano, la persona revisora recibe un correo y la aprobación se mantiene.

### Revisar solicitudes en bloque

En **Pending**, selecciona solicitudes individuales, todas las solicitudes que puedes revisar en la página actual o todas las que coincidan con los filtros. Tus propias solicitudes quedan excluidas de la selección para revisión. Elige **Approve** o **Reject**, revisa el diálogo de confirmación y confirma la decisión. Puedes enviar la misma nota para todas las solicitudes o personalizarla por solicitud; las notas individuales requieren una selección explícita en lugar de todas las solicitudes coincidentes.

Las solicitudes pendientes enviadas por un agente también pueden ser aprobadas por una persona autorizada. El diálogo de confirmación identifica estas solicitudes antes de aplicar la decisión.

### Sugerencias de triaje opcionales

Las sugerencias de triaje solo están disponibles cuando se habilitan para tu empresa. Corgea puede redactar una justificación para una selección de falsos positivos o riesgos aceptados en el workbench; revísala y edítala antes de enviarla.

Para los revisores, una solicitud pendiente puede mostrar **Corgea recommends** con **Approve** o **Reject**, un indicador de confianza y el razonamiento que se envía al solicitante. **Submit recommendation** aplica esa sugerencia. **Override** cambia la decisión o la nota. Selecciona varias solicitudes para usar **Apply suggestions**, que aplica la recomendación de cada solicitud seleccionada tras la confirmación. Las solicitudes sin recomendación siguen necesitando una decisión manual. Las sugerencias nunca aprueban ni rechazan una solicitud por sí solas.

![Cola de aprobaciones en Pending, con recomendaciones de Corgea para aprobar un riesgo aceptado y rechazar un falso positivo](https://mintcdn.com/corgea/K88fBiyu9iuG0Rzy/images/triage/approvals_suggestions.png?fit=max\&auto=format\&n=K88fBiyu9iuG0Rzy\&q=85\&s=6fad34ff9a6234719d02f9df38493722)

Las solicitudes nuevas enviadas por una persona inician la generación de una sugerencia de revisión después del envío. Las solicitudes enviadas por un agente no lo hacen. Una solicitud pendiente más antigua que aún no tiene sugerencia inicia la generación cuando abres la página de la pestaña **Pending** que la contiene, o cuando abres el hallazgo. Abrir una página no genera sugerencias para las solicitudes de otra página.

Los solicitantes reciben correos de aprobación y rechazo según sus [preferencias de notificación](https://docs.corgea.app/es/notifications.md#triage-review-decision). Las revisiones en bloque agrupan los resultados en un resumen por solicitante y resultado.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.