
API RESTful que encapsula o Nmap para varredura automatizada de rede, detecção de portas, enumeração de serviços e análise de vulnerabilidades com geração opcional de relatórios baseada em IA.
Usa python3.10, Debian, python-Nmap e o framework Flask para criar uma API Nmap que pode realizar varreduras com boa velocidade online e é fácil de implantar.
Esta é uma implementação para o nosso projeto PCL da faculdade, que ainda está em desenvolvimento e constantemente sendo atualizada.
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 | Descrição |
|---|---|---|
auth_key | string | Obrigatório. A chave de autenticação da API fornecida |
target | string | Obrigatório. O Hostname e IP alvo |
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 | Descrição |
|---|---|---|
ID | Int | ID do usuário |
Passwd | String | Senha do usuário |
Adicionada funcionalidade GPT com módulo de chunking.
A metodologia é baseada em como os Langchain GPT embeddings operam. Basicamente, a operação funciona assim:
Data -> Chunks_generator ─┐ ┌─> AI_Loop -> Data_Extraction -> Return_Data
├─> Chunk1 ─┤
├─> Chunk2 ─┤
├─> Chunk3 ─┤
└─> Chunk N ─┘
Código AI:
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
Default_Key: e43d4
novas atualizações ainda estão em andamento
| Parâmetro | Dados de retorno | Descrição | Comando Nmap |
|---|
p1 | json | Varredura Efetiva | -Pn -sV -T4 -O -F |
p2 | json | Varredura Simples | -Pn -T4 -A -v |
p3 | json | Varredura de Baixa Potência | -Pn -sS -sU -T4 -A -v |
p4 | json | Varredura Intensa Parcial | -Pn -p- -T4 -A -v |
p5 | json | Varredura Intensa Completa | -Pn -sS -sU -T4 -A -PE -PP -PY -g 53 --script=vuln |
p6 | json | Detecção Abrangente de Versão de Serviço | -Pn -sV -p- -A |
p7 | json | Varredura Agressiva com Detecção de SO | -Pn -sS -sV -O -T4 -A |
p8 | json | Varredura de Script para Vulnerabilidades Comuns | -Pn -sC |
p9 | json | Varredura Intensa, Todas as Portas TCP | -Pn -p 1-65535 -T4 -A -v |
p10 | json | Varredura UDP | -Pn -sU -T4 |
p11 | json | Detecção de Serviço e Versão para as Principais Portas | -Pn -sV --top-ports 100 |
p12 | json | Varredura Agressiva com Scripts NSE para Vulnerabilidades | -Pn -sS -sV -T4 --script=default,discovery,vuln |
p13 | json | Varredura Rápida para Portas Comuns | -Pn -F |