
API RESTful que envuelve Nmap para escaneo automatizado de redes, detección de puertos, enumeración de servicios y análisis de vulnerabilidades con generación opcional de informes impulsada por IA.
Usa python3.10, Debian, python-Nmap y el framework flask para crear una API de Nmap que puede realizar escaneos con buena velocidad en línea y es fácil de desplegar.
Esta es una implementación para nuestro proyecto universitario PCL que aún está en desarrollo y se actualiza constantemente.
GET /api/p1/{auth_key}/{target}
GET /api/p2/{auth_key}/{target}
GET /api/p3/{auth_key}/{target}
GET /api/p4/{auth_key}/{target}
GET /api/p5/{auth_key}/{target}
| Parámetro | Tipo | Descripción |
|---|---|---|
auth_key | string | Requerido. La clave de autenticación de la API |
target | string | Requerido. El hostname o IP del objetivo |
GET /api/p1/
GET /api/p2/
GET /api/p3/
GET /api/p4/
GET /api/p5/
GET /api/p6/
GET /api/p7/
GET /api/p8/
GET /api/p9/
GET /api/p10/
GET /api/p11/
GET /api/p12/
GET /api/p13/
GET /register/<int:user_id>/<string:password>
| Parámetro | Tipo | Descripción |
|---|---|---|
ID | Int | ID de usuario |
Passwd | String | Contraseña de usuario |
Se agregó funcionalidad GPT con módulo de fragmentación.
La metodología se basa en cómo funcionan los Langchain GPT embeddings. Básicamente la operación es la siguiente:
Data -> Chunks_generator ─┐ ┌─> AI_Loop -> Data_Extraction -> Return_Data
├─> Chunk1 ─┤
├─> Chunk2 ─┤
├─> Chunk3 ─┤
└─> Chunk N ─┘
Código de IA:
def AI(analize: str) -> dict[str, any]:
prompt = f"""
Do a NMAP scan analysis on the provided NMAP scan information
The NMAP output must return in a JSON format accorging to the provided
output format. The data must be accurate in regards towards a pentest report.
The data must follow the following rules:
1) The NMAP scans must be done from a pentester point of view
2) The final output must be minimal according to the format given.
3) The final output must be kept to a minimal.
4) If a value not found in the scan just mention an empty string.
5) Analyze everything even the smallest of data.
6) Completely analyze the data provided and give a confirm answer using the output format.
The output format:
{{
"critical score": [""],
"os information": [""],
"open ports": [""],
"open services": [""],
"vulnerable service": [""],
"found cve": [""]
}}
NMAP Data to be analyzed: {analize}
"""
messages = [{"content": prompt, "role": "assistant"}]
response = openai.ChatCompletion.create(
model=model_engine,
messages=messages,
max_tokens=2500,
n=1,
stop=None,
)
response = response['choices'][0]['message']['content']
ai_output = {
"markdown": response
}
return ai_output
Clave por defecto: e43d4
las actualizaciones más recientes aún están en progreso
| Parámetro | Datos devueltos | Descripción | Comando de Nmap |
|---|
p1 | json | Escaneo efectivo | -Pn -sV -T4 -O -F |
p2 | json | Escaneo simple | -Pn -T4 -A -v |
p3 | json | Escaneo de bajo consumo | -Pn -sS -sU -T4 -A -v |
p4 | json | Escaneo intenso parcial | -Pn -p- -T4 -A -v |
p5 | json | Escaneo intenso completo | -Pn -sS -sU -T4 -A -PE -PP -PY -g 53 --script=vuln |
p6 | json | Detección completa de versiones de servicios | -Pn -sV -p- -A |
p7 | json | Escaneo agresivo con detección de SO | -Pn -sS -sV -O -T4 -A |
p8 | json | Escaneo de scripts para vulnerabilidades comunes | -Pn -sC |
p9 | json | Escaneo intenso, todos los puertos TCP | -Pn -p 1-65535 -T4 -A -v |
p10 | json | Escaneo UDP | -Pn -sU -T4 |
p11 | json | Detección de servicios y versiones para los puertos principales | -Pn -sV --top-ports 100 |
p12 | json | Escaneo agresivo con scripts NSE para vulnerabilidades | -Pn -sS -sV -T4 --script=default,discovery,vuln |
p13 | json | Escaneo rápido para puertos comunes | -Pn -F |