Tribunal de validación y entrega del informe de seguridad: revisa si el framework, ORM o middleware ya mitiga cada hallazgo, asigna confianza de 1 a 10 y descarta los falsos positivos que no llegan a 7, calcula la nota A-F y redacta el informe final con resumen ejecutivo, vector y parches en diff. Úsala cuando haya que filtrar falsos positivos de una auditoría, puntuar hallazgos, calificar la seguridad de un proyecto o preparar el informe para dirección y para el equipo técnico. English: vali...
Installs into .claude/skills of the current project.
Sponsors
SSkills DirectorySkills Directory
Know which skills are safe — weekly.
SSkills DirectorySkills Directory
Is that skill safe to install?
Are you the author of Appsec Report?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/alberto2005-coder-appsec-report)
---
name: appsec-report
description: >
Tribunal de validación y entrega del informe de seguridad: revisa si el
framework, ORM o middleware ya mitiga cada hallazgo, asigna confianza de 1 a
10 y descarta los falsos positivos que no llegan a 7, calcula la nota A-F y
redacta el informe final con resumen ejecutivo, vector y parches en diff.
Úsala cuando haya que filtrar falsos positivos de una auditoría, puntuar
hallazgos, calificar la seguridad de un proyecto o preparar el informe para
dirección y para el equipo técnico.
English: validate findings against framework mitigations, score confidence,
discard noise, grade the project A-F and produce the executive and technical
report with diff patches.
license: MIT
metadata:
package: appsec-audit
version: "1.4.0"
---
# AppSec · Tribunal y informe
Un informe con veinte hallazgos de los que doce son ruido es peor que un informe con cinco correctos: consume el tiempo del equipo y quema la credibilidad del revisor.
## Precondiciones
- Candidatos de `appsec-code`, `appsec-infra` y `appsec-llm`, cada uno con evidencia.
- Acceso al código y la configuración para verificar mitigaciones.
## El tribunal
Para cada candidato, responder por escrito:
1. **¿Es alcanzable?** Existe una ruta real desde una entrada controlable hasta el sumidero.
2. **¿Hay mitigación?** Framework, ORM con parámetros, autoescape, middleware, validación en el borde, permiso comprobado en servidor.
3. **¿La configuración aplica en producción?** Un `debug` activo en local no es un hallazgo de producción; uno activo por defecto en el despliegue, sí.
4. **¿Es explotable por quién?** Anónimo, usuario autenticado, otro inquilino, insider.
5. **¿Qué evidencia lo sostiene?** `ruta:línea`, comando y salida, o la ausencia documentada de control.
Confianza **1–10**:
| Valor | Significado |
|---|---|
| 9–10 | Ruta completa verificada y mitigación ausente comprobada |
| 7–8 | Ruta verificada con una duda menor documentada |
| 4–6 | Indicio sólido sin ruta completa |
| 1–3 | Sospecha por patrón |
**Por debajo de 7 se descarta.** No se incluye «por si acaso»: se anota en el registro de descartes con el motivo, que el informe resume en una línea.
## Severidad y nota
Severidad por impacto y explotabilidad reales, no por tipo de CWE. La nota global sale de los hallazgos validados:
| Nota | Criterio |
|---|---|
| A | Sin críticos ni altos; como mucho medios aislados |
| B | Sin críticos; algún alto mitigable a corto plazo |
| C | Un crítico o varios altos |
| D | Varios críticos o un crítico con datos expuestos |
| F | Crítico explotable sin autenticación o compromiso en curso |
`scripts/grade.py` aplica la fórmula de forma determinista: descuenta 25 por crítico, 10 por alto, 3 por medio y 1 por bajo, con suelo en 0, y traduce la puntuación a letra. Los hallazgos descartados no puntúan.
## Informe
Rellenar `templates/report.md` y escribir los hallazgos en `findings.json` (esquema en `../schemas/findings.schema.json`):
- **Resumen ejecutivo** en lenguaje de negocio: qué se puede perder y qué hacer primero, en cinco líneas.
- **Tabla de hallazgos** ordenada por severidad, con `CWE`, `OWASP`, confianza y ubicación.
- **Detalle por hallazgo**: descripción, impacto, vector paso a paso, evidencia y parche en `diff` (antes y después).
- **Descartes**: cuántos y por qué, en una línea.
- **Límites**: qué no se pudo revisar y con qué consecuencia.
## Verificación independiente
Un tribunal que se autoconfirma no es un tribunal. Cada candidato pasa a un verificador nuevo con `../templates/verification.md`, que recibe solo ubicación, CWE, patrón observado y propósito declarado: sin evidencia, veredicto, confianza ni parche. Responde las cinco preguntas de refutación y devuelve el veredicto con la comprobación que lo sostiene; `exploit` y `patch` los completa quien reporta.
## Entrega en CI
```bash
py appsec-audit/scripts/export_sarif.py <dir>/.appsec-audit/findings.json --output appsec.sarif
py appsec-audit/scripts/diff_reports.py baseline.json <dir>/.appsec-audit/findings.json --fail-on new
```
SARIF lleva los hallazgos `confirmed` a GitHub Code Scanning; `--include-pending` añade los `needs_validation` como `note` y los `rejected` nunca salen. El baseline compara por fingerprint contra la pasada anterior y `--fail-on new` bloquea el PR cuando aparece un `confirmed` que antes no estaba.
## Gate de salida
- Ningún hallazgo por debajo de 7 en el informe.
- Cada uno con evidencia verificable y confianza declarada.
- Nota calculada con el script, no a ojo.
- Resumen ejecutivo comprensible sin leer el detalle técnico.
- Parches en diff aplicables, sin cambios de estilo.
- `findings.json` pasa `validate_findings.py`: sin severidad fuera de `confirmed` y sin unidades `planned` en el ledger.
- Cada hallazgo lo revisó un verificador que no vio el informe previo.
- En destino PR, SARIF y diff contra el baseline generados.
## Handoff
Entrega el informe al propietario del sistema y, si procede, al equipo que implementa. Los parches se aplican solo con petición explícita; el revisor no toca el código por iniciativa propia. Si aparece un crítico explotable, se avisa antes de terminar el informe.