Primera fase de una auditoría de seguridad: fija alcance y autorización, inventaría activos, mapea la superficie de ataque y recoge la evidencia base. Incluye revisión de cabeceras y configuración expuesta, inventario de dependencias y SBOM, y barrido de secretos en el árbol de trabajo. Úsala cuando pidan empezar una auditoría, definir el alcance de un pentest, revisar la superficie de un repo antes del análisis profundo o comprobar configuraciones y dependencias vulnerables. English: scope a...
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 Recon?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/alberto2005-coder-appsec-recon)
---
name: appsec-recon
description: >
Primera fase de una auditoría de seguridad: fija alcance y autorización,
inventaría activos, mapea la superficie de ataque y recoge la evidencia base.
Incluye revisión de cabeceras y configuración expuesta, inventario de
dependencias y SBOM, y barrido de secretos en el árbol de trabajo.
Úsala cuando pidan empezar una auditoría, definir el alcance de un pentest,
revisar la superficie de un repo antes del análisis profundo o comprobar
configuraciones y dependencias vulnerables.
English: scope and authorize a security audit, inventory assets and attack
surface, and collect the evidence baseline before deep analysis.
license: MIT
metadata:
package: appsec-audit
version: "1.4.0"
---
# AppSec · Reconocimiento
Sin alcance no hay auditoría: solo una lista de miedos. Esta fase produce el inventario y la evidencia sobre la que trabajan las demás.
## Precondiciones
- Propietario del sistema identificado y **autorización** para revisarlo (texto, ticket o correo).
- Ruta del repositorio, URL o artefacto a auditar.
- Declaración de lo que queda fuera: entornos productivos, datos de clientes, servicios de terceros.
Si falta la autorización, se detiene aquí y se pide por escrito. Sin ella no se toca nada.
## Método
1. **Alcance.** Activos, límites, ventana temporal y qué se puede tocar. Se escribe antes de mirar código.
2. **Inventario.** Lenguajes, frameworks, puntos de entrada (rutas, colas, cron, webhooks), almacenes de datos, integraciones y secretos necesarios.
3. **Superficie.** Todo lo que un atacante puede alcanzar: endpoints públicos, paneles, uploads, redirects, APIs internas expuestas, puertos y buckets.
4. **Dependencias.** Manifiestos y lockfiles, versiones fijadas, dependencias sin mantenimiento, scripts de instalación y procedencia de paquetes.
5. **Secretos.** Claves, tokens, contraseñas y certificados en el árbol, en el historial y en la configuración de CI.
6. **Perímetro.** Cabeceras de seguridad, CORS, cookies, TLS, exposición de metadatos y ficheros de descubrimiento.
## Evidencia
Cada dato lleva origen y fecha: `ruta:línea`, comando ejecutado y salida literal, o URL y cabecera observada. Sin esa tríada, el hallazgo no pasa de hipótesis y así se etiqueta.
## Cobertura mínima
- Mapa de puntos de entrada con método, autenticación requerida y datos que acepta.
- Lista de dependencias con versión y motivo de sospecha, si lo hay.
- Secretos encontrados, redactados, con ubicación y si están activos o caducados.
- Cabeceras y configuración de perímetro observadas, no supuestas.
- Inventario de infraestructura declarada (Docker, IaC, cloud) para `appsec-infra`.
## Herramientas del paquete
```bash
py appsec-audit/scripts/scan_secrets.py <ruta> --json
```
Barrido determinista de secretos con redacción. No sustituye a un escáner de historial: si el repo tiene historial largo, se declara lo revisado y lo que no.
## Modo diff/PR
En una revisión de pull request el alcance son las líneas que cambian, no el repositorio entero:
```bash
py appsec-audit/scripts/diff_scope.py --repo <dir> --base origin/main --findings <dir>/.appsec-audit/findings.json --json
```
La salida da, por fichero, los rangos de líneas añadidas; con `--findings` separa los hallazgos que caen dentro del cambio. Se revisan esas líneas y las que consumen el dato modificado; el resto se declara fuera de alcance con su razón.
## Gate de salida
- Alcance y autorización escritos, con exclusiones explícitas.
- Inventario de activos y superficie completo para el tamaño del proyecto.
- Dependencias y secretos revisados con evidencia por ítem.
- Hipótesis separadas de hechos observados.
- En modo diff/PR, los rangos revisados y lo excluido están escritos.
## Handoff
Entrega a `appsec-code` los puntos de entrada y las rutas con datos de usuario, a `appsec-infra` la infraestructura declarada y a `appsec-llm` cualquier componente de IA. Si el proyecto no tiene código propio (solo configuración), salta directo a `appsec-infra`.