
RESTful API, оборачивающая Nmap для автоматического сканирования сети, обнаружения портов, перечисления служб и анализа уязвимостей с возможностью генерации отчетов на основе ИИ.
Использует python3.10, Debian, python-Nmap и фреймворк flask для создания Nmap API, которое может выполнять сканирование с хорошей скоростью онлайн и легко развертывается.
Это реализация для нашего университетского проекта PCL, который все еще находится в разработке и постоянно обновляется.
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}
| Параметр | Тип | Описание |
|---|---|---|
auth_key | string | Обязательно. Ключ аутентификации API |
target | string | Обязательно. Целевое имя хоста и IP |
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>
| Параметр | Тип | Описание |
|---|---|---|
ID | Int | идентификатор пользователя |
Passwd | String | пароль пользователя |
Добавлена функциональность GPT с модулем разбиения на чанки.
Методология основана на том, как работают Langchain GPT embeddings. В целом операция выглядит так:
Data -> Chunks_generator ─┐ ┌─> AI_Loop -> Data_Extraction -> Return_Data
├─> Chunk1 ─┤
├─> Chunk2 ─┤
├─> Chunk3 ─┤
└─> Chunk N ─┘
Код 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
более новые обновления все еще в процессе разработки
| Параметр | Возвращаемые данные | Описание | Команда Nmap |
|---|
p1 | json | Эффективное сканирование | -Pn -sV -T4 -O -F |
p2 | json | Простое сканирование | -Pn -T4 -A -v |
p3 | json | Сканирование с низким энергопотреблением | -Pn -sS -sU -T4 -A -v |
p4 | json | Частичное интенсивное сканирование | -Pn -p- -T4 -A -v |
p5 | json | Полное интенсивное сканирование | -Pn -sS -sU -T4 -A -PE -PP -PY -g 53 --script=vuln |
p6 | json | Комплексное обнаружение версий служб | -Pn -sV -p- -A |
p7 | json | Агрессивное сканирование с определением ОС | -Pn -sS -sV -O -T4 -A |
p8 | json | Сканирование скриптами для распространенных уязвимостей | -Pn -sC |
p9 | json | Интенсивное сканирование всех TCP-портов | -Pn -p 1-65535 -T4 -A -v |
p10 | json | UDP-сканирование | -Pn -sU -T4 |
p11 | json | Обнаружение служб и версий для топ-портов | -Pn -sV --top-ports 100 |
p12 | json | Агрессивное сканирование с NSE-скриптами для уязвимостей | -Pn -sS -sV -T4 --script=default,discovery,vuln |
p13 | json | Быстрое сканирование распространенных портов | -Pn -F |