Auditor ético de segurança de rede — mais de 50 verificações em SMB, RDP, LDAP, SSH, Kerberos e muito mais, com análise de CVE com IA e mapeamento de conformidade OWASP/CIS/NIST.

Início Rápido · Documentação · Docker · Recursos de IA · Deixe uma Estrela no GitHub

Asterion — Ele percorre o labirinto, toda falha encontra o fim chifrado

Em Ação

_{Varredura local · 127.0.0.1 · 33 descobertas (0C/4H/2M/3L/24I) · 16 verificações · 57.74s · .NET 8.0.22}

Asterion — relatório HTML com selos de severidade e análise de IA

_{Relatório HTML com tema Minotauro — selos de severidade, evidências expansíveis, correção com IA}

Asterion — relatório JSON para automação

_{Relatório JSON — mapeamento OWASP/CIS/NIST/PCI, dados CVE, legível por máquina}

🎯 O que é o Asterion?

O Asterion é um auditor de segurança de rede e domínio pronto para produção que coloca a ética em primeiro lugar. Projetado para testadores de penetração, pesquisadores de segurança e equipes de segurança empresarial, ele combina verificação de vulnerabilidades tradicional com análise de IA de ponta para entregar insights acionáveis para Windows Active Directory, sistemas Linux e infraestrutura de rede.

Por que o Asterion?

🔒 Ético por Design: O sistema de token de consentimento impede varreduras não autorizadas
🤖 Impulsionado por IA: GPT-4, Claude ou Ollama local para guias de correção inteligentes
📊 Relatórios Profissionais: HTML bonito (tema Minotauro) + JSON legível por máquina
🚀 Rápido e Eficiente: Varredura multithread com limitação de taxa inteligente
💾 Rastreamento Persistente: Banco de dados SQLite compartilhado com Argos Suite para histórico de varreduras
🐳 Pronto para Docker: Varredura conteinerizada para integração CI/CD

O Que Ele Escaneia

✨ Recursos

🛡️ Varredura de Segurança de Rede Principal```bash

One command, comprehensive network analysis

ast scan --target 10.0.0.0/24 --output html

- **Detecção Multi-Método**: Análise de protocolos SMB, RDP, LDAP, Kerberos, SSH, FTP, DNS, SNMP
- **Multi-Threading**: Varredura concorrente com 1-20 threads de trabalho
- **Limitação Inteligente de Taxa**: Limitação de requisições configurável (1-20 req/s) para evitar detecção
- **Coleta de Evidências**: Compartilhamentos SMB, consultas LDAP, saída do PowerShell preservados

### 🤖 Análise com IA

Escolha seu provedor de IA com base nas suas necessidades:

| Provedor             | Melhor Para           | Velocidade           | Custo          | Privacidade         |
| -------------------- | ------------------ | --------------- | ------------- | --------------- |
| **OpenAI GPT-4**     | Qualidade de produção | ⚡ Rápido (40s)   | 💰 $0.30/varredura | 🔒 Padrão     |
| **Anthropic Claude** | Foco em privacidade    | ⚡ Rápido (50s)   | 💰 $0.35/varredura | 🔒 Reforçada     |
| **Ollama (Local)**   | Privacidade completa   | 🐢 Lento (30min) | 💰 Grátis       | 🔐 100% offline |

**Dois Modos de Análise:**

- **Técnico**: Remediação passo a passo com comandos PowerShell/GPO e trechos de configuração
- **Executivo**: Resumos em linguagem simples para partes interessadas e gestão

### 📊 Relatórios Profissionais

**Relatórios JSON** (Legível por máquina)```json
{
  "tool": "asterion",
  "version": "0.2.0",
  "target": "192.168.1.10",
  "riskScore": 10.0,
  "summary": {
    "critical": 3,
    "high": 8,
    "medium": 16,
    "low": 5,
    "info": 2
  },
  "findings": [
    {
      "id": "AST-SMB-003",
      "title": "SMBv1 protocol enabled (EternalBlue vector)",
      "severity": "high",
      "owasp": { "id": "A06", "name": "Vulnerable and Outdated Components" },
      "vulnerabilities": [
        {
          "cve_id": "CVE-2017-0143",
          "cvss_score": 9.8,
          "cwe_id": "CWE-119"
        }
      ],
      "cvss": 9.8
    }
  ],
  "attackChains": [...],
  "diff": { "refScanId": 41, "new": [...], "fixed": [...], "persisting": [...] }
}

Relatórios HTML (Amigáveis para Humanos)

🎨 Design temático Minotauro (esquema de cores vermelho/laranja/roxo)
🏷️ Distintivos de gravidade codificados por cores
📝 Seções de evidências expansíveis (compartilhamentos SMB, consultas LDAP, saída do PowerShell)
🤖 Análise de IA lindamente formatada
📱 Design responsivo compatível com dispositivos móveis

🔐 Sistema de Token de Consentimento

A Asterion impõe hacking ético por meio de tecnologia. A varredura agressiva e a análise de IA exigem prova de propriedade:```bash

1. Generate token

ast consent generate --domain corp.local

2. Place token (choose one method)

HTTP: Upload to https://corp.local/.well-known/verify-abc123.txt

DNS: Add TXT record: corp.local = "asterion-verify=verify-abc123"

SSH: Create file /tmp/consent_verify-abc123 with token content

3. Verify ownership

ast consent verify --method http --domain corp.local --token verify-abc123

4. Now you can use aggressive mode

ast scan --target corp.local --mode aggressive --use-ai

### 💾 Persistência de Banco de Dados

O banco de dados SQLite compartilhado com o Argos Suite rastreia tudo:

- **Histórico de Escaneamentos**: Data, duração, contagem de descobertas, detalhamento por severidade
- **Repositório de Descobertas**: Banco de dados de vulnerabilidades pesquisável em todas as ferramentas Argos
- **Domínios Verificados**: Rastreamento de token de consentimento com expiração
- **Análise de Tendências**: Compare escaneamentos ao longo do tempo```bash
# Query recent scans (works for all Argos Suite tools)
sqlite3 ~/.argos/argos.db "SELECT * FROM scans WHERE tool='asterion' ORDER BY started_at DESC LIMIT 10"

# Find critical issues
sqlite3 ~/.argos/argos.db "SELECT * FROM v_critical_findings WHERE tool='asterion'"

🚀 Início Rápido

Pré-requisitos

Todas as Plataformas:

.NET 8.0 SDK (Baixar)
Python 3.10+ (Baixar)
git (para clonar o repositório)

Opcional:

Docker (para escaneamento em contêiner)
Chaves de API (para análise com IA - OpenAI ou Anthropic)

Instalação — Configuração Automatizada (Recomendada)

Linux / macOS```bash

Clone repository

git clone https://github.com/rodhnin/asterion-network-minotaur.git cd asterion-network-minotaur

Run setup script

chmod +x scripts/setup.py python3 scripts/setup.py

**O script irá:**

1. ✅ Verificar pré-requisitos (.NET, Python)
2. ✅ Instalar dependências do Python
3. ✅ Configurar o banco de dados compartilhado do Argos Suite
4. ✅ Compilar o Asterion em modo Release
5. ✅ Criar diretórios (~/.asterion, ~/.argos)
6. ✅ Criar script de wrapper `/usr/local/bin/ast` (opcional)

#### Windows (PowerShell)```powershell
# Clone repository
git clone https://github.com/rodhnin/asterion-network-minotaur.git
cd asterion-network-minotaur

# Run setup (right-click PowerShell > Run as Administrator)
.\scripts\setup.ps1

O script irá:

✅ Verificar pré-requisitos (.NET, Python)
✅ Instalar dependências do Python
✅ Configurar o banco de dados compartilhado do Argos Suite
✅ Compilar o Asterion em modo Release
✅ Criar diretórios (%USERPROFILE%.asterion, %USERPROFILE%.argos)

Instalação — Configuração Manual

Se os scripts automatizados não funcionarem no seu sistema, siga estes passos:

Passo 1: Clonar o repositório```bash

git clone https://github.com/rodhnin/asterion-network-minotaur.git cd asterion-network-minotaur

#### Passo 2: Instalar dependências

**Linux/macOS:**```bash
pip3 install -r scripts/requirements.txt

Windows (Prompt de Comando):```cmd pip install -r scripts\requirements.txt

#### Passo 3: Configurar o banco de dados

**Linux/macOS:**```bash
python3 scripts/db_migrate.py

Windows:```cmd python scripts\db_migrate.py

#### Passo 4: Compilar o Asterion

**Todas as plataformas:**```bash
dotnet build -c Release

Passo 5: Crie os diretórios de configuração

Linux/macOS:```bash mkdir -p ~/.asterion/reports mkdir -p ~/.asterion/consent-proofs mkdir -p ~/.argos

**Windows (PowerShell):**```powershell
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.asterion\reports" | Out-Null
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.asterion\consent-proofs" | Out-Null
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.argos" | Out-Null

Passo 6: (somente Linux/macOS) Criar comando global```bash

Create wrapper script

sudo nano /usr/local/bin/ast

Paste this content:

#!/bin/bash exec dotnet "$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/src/Asterion/bin/Release/net8.0/Asterion.dll" "$@"

Make executable

sudo chmod +x /usr/local/bin/ast

#### Passo 7: Configurar a chave da API (opcional)

Uma única variável de ambiente funciona para todos os provedores de IA (OpenAI, Anthropic):

**Linux/macOS:**```bash
export AI_API_KEY="sk-proj-..."   # OpenAI key
# or
export AI_API_KEY="sk-ant-..."    # Anthropic key
# Add to ~/.bashrc or ~/.zshrc to make permanent

Windows (PowerShell):```powershell $env:AI_API_KEY = "sk-proj-..."

Or permanently:

[Environment]::SetEnvironmentVariable("AI_API_KEY", "sk-proj-...", [System.EnvironmentVariableTarget]::User)

#### Passo 8: Verificar a instalação

**Linux/macOS (se o symlink foi criado):**```bash
ast version

Windows ou invocação direta:```cmd .\src\Asterion\bin\Release\net8.0\ast.exe version

Or with dotnet

dotnet .\src\Asterion\bin\Release\net8.0\Asterion.dll version

### Your First Scan

#### Varredura Automática da Rede Local

**A Asterion pode descobrir e varrer automaticamente a sua rede local!**

**Windows (PowerShell) — Após a Configuração (Recomendado):**```powershell
# Test on localhost (simple)
ast scan --target localhost --output html

# Scan local subnet with AI analysis
ast scan --target 192.168.1.0/24 --output both --threads 10 --rate 5 --use-ai --ai-tone both

# Domain scan with authentication
ast scan --target corp.local --auth "CORP\admin:Password123" --use-ai

Windows (PowerShell) — Sem Configuração de PATH:```powershell

Scan localhost (full path)

.\src\Asterion\bin\Release\net8.0\ast.exe scan --target localhost --output html --use-ai --ai-tone both

Scan local subnet (full path)

.\src\Asterion\bin\Release\net8.0\ast.exe scan --target 192.168.1.0/24 --output both --threads 10 --rate 5

**Linux/macOS:**```bash
# Scan localhost
ast scan --target localhost \
  --output html \
  --use-ai \
  --ai-tone both

# Scan local subnet (e.g., 192.168.1.0/24)
ast scan --target 192.168.1.0/24 \
  --output both \
  --threads 10 \
  --rate 5

# Scan domain
ast scan --target corp.local \
  --auth "CORP\admin:Password123" \
  --output html \
  --use-ai

Formatos de Saída

Asterion suporta três formatos de saída usando --output:

Opções de Tom da IA

Controle como a análise de IA é formatada usando --ai-tone:

Tom	Caso de Uso	Saída
technical

Exemplos Básicos

Varredura de rede simples (sem autenticação):```bash ast scan --target 10.0.0.0/24

**Com relatório HTML:**```bash
ast scan --target 192.168.1.0/24 --output html

Varredura autenticada (domínio Windows):```bash ast scan --target dc01.corp.local
--auth "CORP\Administrator:P@ssw0rd"
--output html

**Com análise de IA (técnica + executiva):**```bash
ast scan --target 10.0.0.0/24 \
  --use-ai \
  --ai-tone both \
  --output html

Varredura rápida (10 threads, 10 req/s):```bash ast scan --target 10.0.0.0/24
--threads 10
--rate 10
--output json

#### Locais de Relatórios

**Instalação Nativa:**

- Relatórios: `~/.asterion/reports/`
- Banco de dados: `~/.argos/argos.db`

**Windows:**

- Relatórios: `%USERPROFILE%\.asterion\reports\`
- Banco de dados: `%USERPROFILE%\.argos\argos.db`

**Implantação com Docker:**

- Relatórios: `docker/reports/`
- Banco de dados: `docker/data/argos.db`

**🎉 Sucesso!** Verifique o diretório de relatórios para os arquivos de saída JSON e HTML.

---

### Executando com Docker

**Implantação Automática:**```bash
cd docker
./deploy.sh    # Linux/macOS
.\deploy.ps1   # Windows

Implantação Manual com Docker:```bash

Build and start

docker compose up -d

Run a scan

docker compose exec asterion dotnet /app/ast.dll scan
--target 192.168.1.0/24
--output html

View logs

docker compose logs -f asterion

Stop services

docker compose down

---

## 📘 Guia de Uso

### Estrutura de Comandos```bash
ast <command> [options]

Comandos Disponíveis:

scan — Executar uma varredura de segurança
consent — Gerenciar tokens de consentimento
version — Exibir informações de versão

Opções do Comando Scan

Flags Principais

Flags de Credenciais

Flags de IA

Exemplos de Referência Rápida

Varredura Básica```bash

Scan local subnet (default: JSON output, safe mode)

ast scan --target 192.168.1.0/24

Scan with HTML report

ast scan --target 192.168.1.0/24 --output html

Scan specific IP

ast scan --target 10.0.0.5 --output both

#### Direcionamento de Rede```bash
# CIDR notation
ast scan --target 10.0.0.0/24

# IP range
ast scan --target 192.168.1.10-50

# Domain name
ast scan --target corp.local

# Single host
ast scan --target 192.168.1.1

Otimização de Desempenho```bash

Slow, stealthy scan (3 threads, 2 req/s)

ast scan --target 10.0.0.0/24 --threads 3 --rate 2

Fast scan (15 threads, 15 req/s)

ast scan --target 10.0.0.0/24 --threads 15 --rate 15

Specific ports only

ast scan --target 10.0.0.0/24 --ports 445,3389,22,139

#### Varredura de Domínio do Windows```bash
# Network + LDAP/Kerberos/AD checks
ast scan --target dc01.corp.local \
  --auth "CORP\Administrator:P@ssw0rd"

# WinRM: remote firewall, registry, services, privesc
ast scan --target 192.168.1.10 \
  --winrm "CORP\admin:P@ssw0rd"

# Full Windows audit: auth + WinRM + AI + HTML
ast scan --target 192.168.1.10 \
  --auth "CORP\admin:P@ssw0rd" \
  --winrm "CORP\admin:P@ssw0rd" \
  --use-ai --ai-tone technical -o both -v

# With NTLM hash (Pass-the-Hash)
ast scan --target 10.0.0.5 \
  --auth-ntlm "admin:aad3b435b51404eeaad3b435b51404ee:8846f7eaee8fb117ad06bdd830b7586c"

# Diff against last scan (track security changes)
ast scan --target 192.168.1.10 --winrm "CORP\admin:P@ssw0rd" --diff last -o both

Auditoria do Sistema Linux```bash

Remote Linux SSH scan (password)

ast scan --target 10.0.0.25 --ssh "admin:password"

SSH with sudo elevation (for privileged checks)

ast scan --target 10.0.0.25 --ssh "admin:password" --sudo-password "sudopass"

SSH key authentication

ast scan --target 10.0.0.25 --ssh-key "admin:~/.ssh/id_rsa"

Via bastion host

ast scan --target internal.corp.local
--bastion "bastion.corp.local:jumpuser:~/.ssh/bastion_key"
--ssh "admin:password"

Full Linux audit: SSH + sudo + AI + HTML

ast scan --target 10.0.0.25
--ssh "root:toor"
--use-ai --ai-tone technical -o both -v

#### Análise com IA```bash
# Technical remediation (default, for security teams)
ast scan --target 10.0.0.5 \
  --ssh "root:pass" \
  --use-ai --ai-tone technical -o html

# Executive summary (for management)
ast scan --target 10.0.0.5 \
  --use-ai --ai-tone non_technical -o html

# Both formats + streaming output
ast scan --target 10.0.0.5 --use-ai --ai-tone both --ai-stream -o both

# Agent mode (NVD CVE lookup tool enabled)
ast scan --target 10.0.0.5 --ssh "root:pass" --use-ai --ai-agent -v

# Compare two models
ast scan --target 10.0.0.5 --use-ai \
  --ai-compare "openai/gpt-4o-mini-2024-07-18,anthropic/claude-3-5-haiku-20241022"

# Enforce cost budget
ast scan --target 10.0.0.5 --winrm "admin:pass" --use-ai --ai-budget 0.05

Depuração```bash

Verbose output

ast scan --target 10.0.0.5 -v

Verbose + custom timeout

ast scan --target 10.0.0.5 -v --timeout 20

Test connectivity only (timeout 5s)

ast scan --target 10.0.0.5 --timeout 5

### Gerenciamento de Token de Consentimento

#### Gerar Token de Consentimento```bash
ast consent generate --domain corp.local
# Output: Token: verify-a3f9b2c1d8e4f5a6

Verificar Consentimento (3 Métodos)

Método HTTP (coloque o arquivo no servidor web):```bash

1. Create file at: https://corp.local/.well-known/verify-a3f9b2c1d8e4f5a6.txt

2. Verify:

ast consent verify
--method http
--domain corp.local
--token verify-a3f9b2c1d8e4f5a6

**Método DNS** (adicione registro TXT):```bash
# 1. Add DNS TXT record: corp.local = "asterion-verify=verify-a3f9b2c1d8e4f5a6"
# 2. Verify:
ast consent verify \
  --method dns \
  --domain corp.local \
  --token verify-a3f9b2c1d8e4f5a6

Método SSH (criar arquivo no sistema):```bash

1. Create file: /tmp/consent_verify-a3f9b2c1d8e4f5a6

2. Verify:

ast consent verify
--method ssh
--domain corp.local
--token verify-a3f9b2c1d8e4f5a6
--ssh "user:password"

#### Executar Modo Agressivo```bash
# After verifying consent token:
ast scan --target corp.local --mode aggressive

Cenários do Mundo Real

Cenário 1: Avaliação Rápida de Rede```bash

Fast, no-auth scan with HTML report

ast scan --target 192.168.1.0/24 --output html --threads 10 --rate 10

#### Cenário 2: Auditoria Completa de Domínio```bash
# Complete Windows AD assessment with AI analysis
ast scan --target corp.local \
  --auth "CORP\admin:P@ssw0rd" \
  --use-ai \
  --ai-tone both \
  --output both \
  --threads 8 \
  --rate 8

Cenário 3: Varredura Stealth```bash

Slow, careful scan to avoid detection

ast scan --target 10.0.0.0/24
--threads 2
--rate 1
--timeout 20
--output json

#### Cenário 4: Teste de Penetração```bash
# Generate consent first
ast consent generate --domain internal.corp

# Place token and verify
ast consent verify --method http --domain internal.corp --token <token>

# Run aggressive assessment
ast scan --target internal.corp \
  --mode aggressive \
  --auth "CORP\pentest:P@ssw0rd" \
  --use-ai \
  --output both

🤖 Análise com IA

O Asterion usa LangChain 1.0.0 com suporte a vários provedores de IA por meio de ponte Python, dando a você flexibilidade com base em seus requisitos de segurança, privacidade e orçamento.

Provedores Suportados

OpenAI GPT-4 Turbo

Melhor para: Uso em produção

⭐ Qualidade: Excelente (5/5)
⚡ Velocidade: ~60–80 segundos (gpt-4o-mini, padrão)
💰 Custo: ~$0.004–0.009 por varredura (gpt-4o-mini com ~30 descobertas)
🔒 Privacidade: Padrão (dados criptografados em trânsito)```bash export AI_API_KEY="sk-proj-..." # Use AI_API_KEY for all providers

#### Anthropic Claude

**Melhor para: Privacidade aprimorada**

- ⭐ Qualidade: Excelente (5/5)
- ⚡ Velocidade: ~50–70 segundos
- 💰 Custo: ~$0.007–0.015 por varredura (claude-3-5-haiku)
- 🔒 Privacidade: Aprimorada (abordagem de privacidade em primeiro lugar da Anthropic)```bash
export AI_API_KEY="sk-ant-..."   # Same variable, Anthropic key format

Ollama (Modelos Locais)

Melhor para: Privacidade completa

⭐ Qualidade: Boa (3/5)
🐢 Velocidade: ~30 minutos (CPU) ou ~90 segundos (GPU)
💰 Custo: Gratuito
🔐 Privacidade: 100% offline (os dados nunca saem da sua máquina)```bash

Install Ollama: https://ollama.ai

ollama pull llama3.2

### Privacidade e Segurança

**Sanitização Automática**
Antes de enviar dados aos provedores de IA, o Asterion remove automaticamente:

- ✅ Tokens de consentimento
- ✅ Credenciais de domínio (senhas, hashes NTLM)
- ✅ Informações Pessoalmente Identificáveis (PII)
- ✅ Endereços IP internos (quando solicitado)
- ✅ Caminhos de compartilhamento SMB com dados sensíveis

**Somente Opt-In**

- A análise por IA exige a flag explícita `--use-ai`
- A varredura agressiva requer um token de consentimento verificado
- Você controla qual provedor vê seus dados

**Para Máxima Privacidade**
Use o Ollama localmente. Embora seja mais lento e menos preciso, os dados da sua varredura nunca saem da sua máquina.

### Mudando de Provedor

**Método Atual (v0.2.0):** Edite `config/defaults.yaml````yaml
ai:
    langchain:
        provider: "ollama" # Changed from "openai"
        model: "llama3.2" # Ollama model
        ollama_base_url: "http://localhost:11434"

Chegando na v0.3.0: Menu de configuração interativa (estilo Metasploit)```bash

Future feature

ast --show-options ast --set ai.provider=anthropic ast --save-profile privacy-mode

---

## 🧪 Laboratório de Testes Seguro

**⚠️ NUNCA verifique redes de produção sem permissão por escrito!**

Use nosso laboratório Docker para praticar com segurança:

### Configurar Ambiente de Teste```bash
# Navigate to docker directory
cd docker

# Deploy vulnerable network lab
docker-compose -f compose.testing.yml up -d

# Wait for services to start (~60 seconds)
docker-compose -f compose.testing.yml logs -f

# Create vulnerable conditions
docker-compose -f compose.testing.yml exec windows-target powershell -c "Disable-NetFirewallProfile -All"

Escanear o Laboratório```bash

Return to project root

cd ..

Run scan against lab network

ast scan --target 172.20.0.0/24 --output html

Try authenticated scan

ast scan --target 172.20.0.2 --auth "LAB\admin:P@ssw0rd123" --output both

Try AI analysis (requires API key)

ast scan --target 172.20.0.0/24 --use-ai --output html

### Limpeza```bash
cd docker
docker-compose -f compose.testing.yml down -v  # -v removes all data

Para cenários de teste detalhados, consulte docs/TESTING_GUIDE.md

🔒 Ética e Legal

A Regra de Ouro

Analise apenas redes e sistemas que você possui ou possui autorização explícita por escrito para testar.

Aplicação do Consentimento

Asterion implementa controlos técnicos para prevenir o uso indevido:

Enquadramento Legal

O acesso não autorizado a sistemas informáticos é ilegal na maioria das jurisdições:

🇺🇸 EUA: Computer Fraud and Abuse Act (CFAA)
🇬🇧 Reino Unido: Computer Misuse Act 1990
🇪🇺 UE: Diretiva 2013/40/EU
🌍 Internacional: Várias leis de cibercrime

Boas Práticas

✅ Obtenha autorização por escrito antes de analisar
✅ Defina claramente o âmbito (quais redes/domínios/IPs)
✅ Documente tudo (consentimento, descobertas, remediação)
✅ Use o modo Safe primeiro para estabelecer uma linha de base
✅ Relate as descobertas de forma responsável (divulgação coordenada)
❌ Nunca explore vulnerabilidades sem permissão explícita (por exemplo, não explorar EternalBlue)
❌ Nunca analise redes de terceiros (por exemplo, google.com, microsoft.com)

Para diretrizes éticas completas, consulte docs/ETHICS.md

🐳 Deploy com Docker

Scripts de Deploy Interativos (Recomendado)

Asterion fornece scripts de deploy multiplataforma:

Linux/macOS:```bash cd docker ./deploy.sh

**Windows (PowerShell):**```powershell
cd docker
.\deploy.ps1

Opções de Implantação:

Produção - Implantar o Asterion Scanner
Parar todos os serviços
Remover todos os contêineres e dados (reset)

Implantação Manual do Docker

Linux/macOS:```bash cd docker docker compose up -d

Execute scans (note the dotnet wrapper)

docker compose exec asterion dotnet /app/ast.dll scan --target 10.0.0.0/24

View logs

docker compose logs -f asterion

Stop service

docker compose down

**Windows (PowerShell):**```powershell
cd docker
docker compose up -d

# Execute scans (note the dotnet wrapper)
docker compose exec asterion dotnet /app/ast.dll scan --target 10.0.0.0/24

# View logs
docker compose logs -f asterion

# Stop service
docker compose down

Persistent data:

Reports: ./reports/ → host directory docker/reports/
Database: ./data/argos.db → host directory docker/data/argos.db (shared Argos Suite DB)
Logs: ./logs/asterion.log → host directory docker/logs/asterion.log

Nota: O Asterion detecta automaticamente o ambiente Docker por meio da variável de ambiente ASTERION_IN_DOCKER.

Para documentação completa do Docker (Linux/Windows), consulte: docker/README.md

📊 Compreendendo os Relatórios

Estrutura do Relatório

Instalação Nativa:``` ~/.asterion/ ├── reports/ │ ├── asterion_report_10_0_0_0_24_20260419_143000.json # Machine-readable │ └── asterion_report_10_0_0_0_24_20260419_143000.html # Human-friendly (Minotaur-themed) └── consent-proofs/ └── corp_local_verify-abc123_20260419.txt

~/.argos/ ├── argos.db # Shared Argos Suite database └── logs/ └── argos.log # Shared log file

**Implantação Docker:**```
asterion-network-minotaur/
├── docker/
│   ├── reports/
│   │   ├── asterion_report_10_0_0_0_24_20260419_143000.json
│   │   └── asterion_report_10_0_0_0_24_20260419_143000.html
│   ├── data/
│   │   └── argos.db          # Shared Argos Suite database (Docker)
│   ├── logs/
│   │   └── asterion.log
│   └── workspace/
│       └── consent-proofs/

Nota: O ambiente Docker é detectado automaticamente por meio da variável de ambiente ASTERION_IN_DOCKER.

Esquema do Relatório JSON```json

{ "tool": "asterion", "version": "0.2.0", "target": "10.0.0.0/24", "date": "2026-04-13T14:30:00Z", "mode": "safe", "summary": { "critical": 12, "high": 8, "medium": 15, "low": 5, "info": 20 }, "findings": [ { "id": "AST-SMB-003", "title": "SMBv1 enabled (EternalBlue vulnerability)", "severity": "critical", "confidence": "high", "description": "SMBv1 is enabled on this system. This protocol is vulnerable to EternalBlue (CVE-2017-0143), a critical remote code execution vulnerability exploited by WannaCry ransomware.", "evidence": { "type": "smb", "value": "SMBv1 negotiated successfully", "context": "Port 445/tcp open, SMB signing not required" }, "recommendation": "URGENT - Disable SMBv1 immediately:\n\nPowerShell:\nDisable-WindowsOptionalFeature -Online -FeatureName SMB1Protocol -NoRestart\n\nGroup Policy:\nComputer Configuration → Administrative Templates → MS Security Guide\n→ Configure SMBv1 client driver startup = Disabled\n→ Configure SMBv1 server = Disabled\n\nVerify:\nGet-SmbServerConfiguration | Select EnableSMB1Protocol", "references": [ "https://docs.microsoft.com/en-us/windows-server/storage/file-server/troubleshoot/detect-enable-and-disable-smbv1-v2-v3", "https://nvd.nist.gov/vuln/detail/CVE-2017-0143" ], "affected_component": "SMB Server" }, { "id": "AST-LDAP-001", "title": "LDAP anonymous bind allowed", "severity": "high", "confidence": "high", "description": "LDAP server allows anonymous bind, permitting unauthenticated enumeration of domain users, groups, and configuration.", "evidence": { "type": "ldap", "value": "Anonymous bind successful to port 389/tcp", "context": "Retrieved domain base DN: DC=corp,DC=local" }, "recommendation": "Disable LDAP anonymous bind:\n\nGroup Policy:\nComputer Configuration → Policies → Windows Settings → Security Settings → Local Policies → Security Options\n→ Network access: Allow anonymous SID/Name translation = Disabled\n→ Network access: Do not allow anonymous enumeration of SAM accounts = Enabled\n→ Network access: Do not allow anonymous enumeration of SAM accounts and shares = Enabled\n\nRegistry:\nreg add "HKLM\SYSTEM\CurrentControlSet\Control\Lsa" /v RestrictAnonymous /t REG_DWORD /d 1 /f", "affected_component": "LDAP Server" }, { "id": "AST-RDP-001", "title": "RDP without Network Level Authentication (NLA)", "severity": "high", "confidence": "high", "description": "Remote Desktop Protocol (RDP) is configured without Network Level Authentication (NLA). This allows unauthenticated attackers to reach the login screen and attempt brute-force attacks.", "evidence": { "type": "rdp", "value": "RDP port 3389/tcp open, NLA not required", "context": "Encryption level: High" }, "recommendation": "Enable Network Level Authentication:\n\nPowerShell:\n(Get-WmiObject -class Win32_TSGeneralSetting -Namespace root\cimv2\terminalservices -Filter "TerminalName='RDP-tcp'").SetUserAuthenticationRequired(1)\n\nGroup Policy:\nComputer Configuration → Administrative Templates → Windows Components → Remote Desktop Services → Remote Desktop Session Host → Security\n→ Require user authentication for remote connections by using Network Level Authentication = Enabled", "affected_component": "RDP Server" } ], "notes": { "scan_duration_seconds": 67.5, "targets_scanned": 12, "rate_limit_applied": true, "scope_limitations": "Scan limited to network services. Local system checks require SSH/WinRM credentials.", "false_positive_disclaimer": "Manual verification recommended for all findings before remediation." }, "aiAnalysis": { "executiveSummary": "The network scan identified 12 critical security vulnerabilities requiring immediate attention...", "technicalRemediation": "### Critical Issues\n\n1. \n - Affected systems: 10.0.0.5, 10.0.0.10\n - Remediation: Disable SMBv1...", "generatedAt": "2026-04-19T14:35:00Z", "modelUsed": "gpt-4o-mini-2024-07-18", "provider": "openai" } }

### Recursos do Relatório HTML

- **📊 Painel Executivo**: Cartões de resumo com contagens de severidade e identidade visual Minotaur
- **🤖 Análise de IA**: Seções expansíveis para insights executivos e técnicos
- **🔍 Descobertas Detalhadas**: Organizadas por severidade com comandos de remediação PowerShell/GPO
- **📋 Evidências**: Compartilhamentos SMB, consultas LDAP, configurações RDP, saída do PowerShell
- **🔗 Referências Externas**: Links para CVE, documentação da Microsoft, guias OWASP
- **📱 Responsivo para Dispositivos Móveis**: Funciona em todos os dispositivos
- **🎨 Tema Minotaur**: Esquema de cores vermelho/laranja/roxo

---

## 📁 Estrutura do Projeto```
asterion-network-minotaur/
│
├── src/
│   ├── Asterion/                     # Main C# application
│   │   ├── Asterion.csproj           # .NET project file
│   │   │
│   │   ├── Checks/                   # Security check modules
│   │   │   ├── ICheck.cs             # Check interface
│   │   │   ├── BaseCheck.cs          # Abstract base class (350 lines)
│   │   │   ├── CheckCategory.cs      # Check category enum
│   │   │   │
│   │   │   ├── CrossPlatform/        # Network service scanners (work from any OS)
│   │   │   │   ├── PortScanner.cs    # TCP port scanning
│   │   │   │   ├── SmbScanner.cs     # SMB/CIFS security (42KB)
│   │   │   │   ├── RdpScanner.cs     # RDP configuration (24KB)
│   │   │   │   ├── LdapScanner.cs    # LDAP/AD security (38KB)
│   │   │   │   ├── KerberosScanner.cs # Kerberos security (22KB)
│   │   │   │   ├── SnmpScanner.cs    # SNMP vulnerabilities (21KB)
│   │   │   │   ├── DnsScanner.cs     # DNS misconfigurations (14KB)
│   │   │   │   ├── FtpScanner.cs     # FTP security (27KB)
│   │   │   │   ├── TlsScanner.cs     # TLS/SSL certificate checks
│   │   │   │   ├── SysvolCheck.cs    # SYSVOL/GPP password exposure
│   │   │   │   ├── AdAggressiveCheck.cs # AS-REP roasting, delegation, weak ACLs
│   │   │   │   └── WinRmChecks.cs    # Remote Windows audit via WS-Man
│   │   │   │
│   │   │   ├── Windows/              # Local Windows system checks
│   │   │   │   ├── WinFirewallCheck.cs # Firewall configuration
│   │   │   │   ├── WinRegistryCheck.cs # Registry security
│   │   │   │   ├── AdPolicyCheck.cs    # Active Directory policies
│   │   │   │   ├── WinServicesCheck.cs # Service misconfigurations
│   │   │   │   └── PrivEscCheckWin.cs  # Windows privilege escalation
│   │   │   │
│   │   │   └── Linux/                # Local/remote Linux checks (via SSH)
│   │   │       ├── LinuxFirewallCheck.cs # iptables/nftables/ufw
│   │   │       ├── SshConfigCheck.cs     # SSH hardening
│   │   │       ├── SambaNfsCheck.cs      # Samba/NFS security
│   │   │       └── PrivEscCheckLinux.cs  # SUID, sudo misconfig
│   │   │
│   │   ├── Core/                     # Core infrastructure
│   │   │   ├── Orchestrator.cs       # Main execution engine (1,243 lines)
│   │   │   ├── Config.cs             # YAML configuration loader
│   │   │   ├── ScanOptions.cs        # Scan configuration
│   │   │   ├── Database.cs           # SQLite operations
│   │   │   ├── ConsentValidator.cs   # Consent token verification
│   │   │   ├── SshConnectionManager.cs  # SSH.NET wrapper (password/key/bastion)
│   │   │   ├── WinRmConnectionManager.cs # WS-Man HTTP/NTLM (Linux → Windows)
│   │   │   ├── AttackChainAnalyzer.cs   # Multi-step attack chain correlation
│   │   │   ├── NtlmSpnego.cs         # NTLM/SPNEGO auth implementation
│   │   │   ├── NtlmV2Auth.cs         # NTLMv2 auth implementation
│   │   │   │
│   │   │   ├── Output/
│   │   │   │   └── ReportBuilder.cs  # Report generation (risk score, labels)
│   │   │   │
│   │   │   └── Utils/
│   │   │       ├── NetworkUtils.cs   # Network operations
│   │   │       ├── CidrParser.cs     # CIDR/IP range parsing
│   │   │       ├── AuthenticationManager.cs # Credential handling
│   │   │       └── OsDetector.cs     # Per-target OS detection (SSH/SMB/TTL)
│   │   │
│   │   ├── Models/                   # Data models
│   │   │   ├── Report.cs             # Main report structure
│   │   │   ├── Finding.cs            # Security finding (OWASP/CVE/Compliance)
│   │   │   ├── Evidence.cs           # Finding proof
│   │   │   ├── ConsentInfo.cs        # Consent verification
│   │   │   └── AiAnalysis.cs         # AI-generated content (cost tracking)
│   │   │
│   │   ├── Program.cs                # Application entry point
│   │   └── Cli.cs                    # CLI argument parser (all flags)
│   │
│   └── Asterion.sln                  # Visual Studio solution
│
├── scripts/                          # Python bridge scripts
│   ├── ai_analyzer.py                # LangChain AI integration (stream/agent/compare)
│   ├── cve_lookup.py                 # NVD API v2 CVE enrichment
│   ├── owasp.py                      # OWASP Top 10 mapping (139 entries)
│   ├── compliance.py                 # CIS/NIST/PCI mapping (95 entries)
│   ├── db_migrate.py                 # Database setup
│   ├── render_html.py                # HTML report generation (Jinja2)
│   ├── setup.sh                      # Linux/macOS installation script
│   ├── setup.ps1                     # Windows PowerShell setup
│   └── requirements.txt              # Python dependencies
│
├── config/                           # Configuration files
│   ├── defaults.yaml                 # Default settings
│   └── prompts/                      # AI prompt templates
│       ├── technical.txt             # Technical remediation prompts
│       └── non_technical.txt         # Executive summary prompts
│
├── db/
│   └── migrate.sql                   # Database schema (shared with Argos Suite)
│
├── docker/                           # Docker deployment
│   ├── Dockerfile                    # Production image
│   ├── docker-compose.yml            # Production deployment
│   ├── compose.testing.yml           # Vulnerable lab environment
│   ├── .dockerignore
│   ├── .env.example
│   └── README.md                     # Docker instructions
│
├── docs/                             # Documentation
│   ├── AI_INTEGRATION.md             # AI setup guide
│   ├── CONSENT.md                    # Consent token system
│   ├── DATABASE_GUIDE.md             # SQLite schema and queries
│   ├── ETHICS.md                     # Ethical guidelines
│   ├── NETWORK_CHECKS.md             # Complete check catalog (50+ checks)
│   └── ROADMAP.md                    # Development roadmap
│
├── schema/
│   └── report.schema.json            # Argos Suite unified schema
│
├── templates/
│   └── report.html.j2                # HTML report template (35KB, Minotaur-themed)
│
├── assets/
│   └── ascii.txt                     # Minotaur ASCII art banner
│
├── CHANGELOG.md                      # Version history
├── README_PATTERN.md                 # README visual branding guide
├── LICENSE                           # MIT License
└── README.md                         # This file

Estatísticas:

Total de arquivos C#: ~46 arquivos
Total de arquivos Python: 6 scripts
Plataforma: Multiplataforma (.NET 8.0)
Linguagem: C# (principal), Python (ponte de IA)

🗺️ Roteiro

v0.1.0 — Lançamento Inicial ✅ (Novembro 2025)

✅ Mais de 50 verificações de segurança (SMB, RDP, LDAP, Kerberos, Windows, Linux)
✅ Análise baseada em IA (OpenAI, Anthropic, Ollama)
✅ Sistema de token de consentimento (verificação HTTP + DNS + SSH)
✅ Relatórios JSON + HTML (tema Minotaur), banco de dados compartilhado do Argos Suite
✅ Suporte a Docker, multiplataforma (.NET 8.0)

v0.2.0 — Auditoria Remota de Sistemas ✅ (Maio 2026)

Status: 🎉 Lançado

✅ Verificações Remotas do Windows via WinRM: Audite servidores Windows a partir de Linux/macOS (--winrm)
✅ SSH Aprimorado: Autenticação por chave, hosts bastion, elevação sudo (--ssh-key, --bastion, --sudo-password)
✅ Detecção de SO: Detecção por alvo (banner SSH + porta SMB/RDP + TTL)
✅ Modo Agressivo: AS-REP roasting, delegação, ACLs fracas, LAPS, AdminCount
✅ Scanner TLS: Certificados expirados/autoassinados, TLS 1.0/1.1, cifras fracas
✅ Verificação SYSVOL/GPP: Exposição de senhas em Group Policy Preferences
✅ Correlação de Cadeia de Ataques: 8 vetores de múltiplas etapas com IDs MITRE
✅ Relatórios Diff: --diff last / --diff <id> — acompanhe a regressão de segurança
✅ Arquivo Multi-Cred: --creds-file credentials.yaml
✅ Rastreamento de Custos de IA: --ai-budget, custos salvos no banco de dados + costs.json
✅ Streaming de IA / / : , ,

v0.3.0 — Recursos Empresariais (T3 2026)

Foco: Usabilidade, escala, IA interativa

🔜 CLI no Estilo Metasploit: Gerenciamento interativo de configuração (--show-options, --set)
🔜 CLI de Banco de Dados: Sem necessidade de SQL (ast db scans list, ast db findings search)
🔜 Varredura Multi-Rede: Processamento em lote a partir de arquivo
🔜 Interface de Chat com IA: Análise conversacional de vulnerabilidades com integração ao BloodHound
🔜 Integração CI/CD: Modelos para GitHub Actions, Jenkins, GitLab
🔜 Servidor de API REST: API ASP.NET Core para automação

v0.4.0 — Inteligência e Automação (T4 2026)

Foco: Remediação automatizada, detecção por ML, varredura distribuída

🔜 Remediação Automatizada: Geração de playbooks PowerShell DSC + Ansible
🔜 Detecção Baseada em ML: Detecção de anomalias, redução de falsos positivos
🔜 Varredura Distribuída: Nós de trabalho (workers) para ambientes de grande escala
🔜 Agentes de IA Avançados: Geração de consultas BloodHound, análise de caminhos de ataque

Para descrições detalhadas dos recursos, consulte docs/ROADMAP.md

🤝 Contribuindo

Recebemos contribuições! Seja:

🐛 Relatórios de bugs
💡 Solicitações de recursos
📝 Melhorias na documentação
🔧 Contribuições de código

Como Contribuir

Fork do repositório
Crie um branch de recurso (git checkout -b feature/amazing-feature)
Faça suas alterações
Escreva/atualize testes (quando aplicável)
Faça commit das suas alterações (git commit -m 'Add amazing feature')
Envie para o branch (git push origin feature/amazing-feature)
Abra um Pull Request

Configuração de Desenvolvimento```bash

Clone your fork

git clone https://github.com/YOUR-USERNAME/asterion-network-minotaur.git cd asterion-network-minotaur

Install dependencies

pip install -r scripts/requirements.txt dotnet restore

Build solution

dotnet build

Run with debugging

dotnet run --project src/Asterion -- scan --target 192.168.1.1 -v

### Code Style

- **Formatação C#**: Siga as convenções de codificação C# da Microsoft
- **Formatação Python**: Usamos [Black](https://github.com/psf/black) (tamanho de linha: 88)
- **Documentação XML**: Obrigatória para todas as classes/métodos públicos
- **Comentários de Código**: Use `//` para comentários inline, `///` para documentação XML

### Relatando Problemas

Encontrou um bug? Tem uma solicitação de recurso?

**Abra uma issue**: https://github.com/rodhnin/asterion-network-minotaur/issues

Por favor, inclua:

- Versão do Asterion (`ast version`)
- Versão do .NET (`dotnet --version`)
- Versão do Python (`python --version`)
- Sistema operacional
- Passos para reproduzir (para bugs)
- Comportamento esperado versus real

---

## 📚 Documentação

Documentação abrangente disponível no diretório `docs/`:

| Document                                    | Description                               |
| ------------------------------------------- | ----------------------------------------- |
| [AI_INTEGRATION.md](https://github.com/rodhnin/asterion-network-minotaur/blob/main/docs/AI_INTEGRATION.md) | Guia completo de configuração de IA (todos os 3 provedores) |
| [CONSENT.md](https://github.com/rodhnin/asterion-network-minotaur/blob/main/docs/CONSENT.md)               | Detalhes técnicos do sistema de token de consentimento |
| [DATABASE_GUIDE.md](https://github.com/rodhnin/asterion-network-minotaur/blob/main/docs/DATABASE_GUIDE.md) | Esquema SQLite, consultas, gerenciamento |
| [ETHICS.md](https://github.com/rodhnin/asterion-network-minotaur/blob/main/docs/ETHICS.md)                 | Estrutura legal e diretrizes éticas |
| [NETWORK_CHECKS.md](https://github.com/rodhnin/asterion-network-minotaur/blob/main/docs/NETWORK_CHECKS.md) | Catálogo completo de mais de 50 verificações de segurança |
| [ROADMAP.md](https://github.com/rodhnin/asterion-network-minotaur/blob/main/docs/ROADMAP.md)               | Recursos futuros e planos de desenvolvimento |

### Links Rápidos

- **Changelog**: [CHANGELOG.md](https://github.com/rodhnin/asterion-network-minotaur/blob/main/CHANGELOG.md)
- **Licença**: [LICENSE](https://github.com/rodhnin/asterion-network-minotaur/blob/main/LICENSE)
- **Arte ASCII**: [assets/ascii.txt](https://github.com/rodhnin/asterion-network-minotaur/blob/main/assets/ascii.txt)

---

## 🤝 Parte do Argos Suite

O Asterion é o quarto componente do **Argos Security Suite**:

| Tool           | Language    | Target                  | Status      |
| -------------- | ----------- | ----------------------- | ----------- |
| **Argus**      | Python      | WordPress               | ✅ Estável  |
| **Hephaestus** | Python      | Servidores (Linux/Windows) | ✅ Estável |
| **Pythia**     | Python      | Injeção SQL             | ✅ Estável  |
| **Asterion**   | C# + Python | Redes/Domínios/AD       | 🎉 Lançado  |

**Infraestrutura Compartilhada:**

- Banco de dados SQLite (`~/.argos/argos.db`)
- Esquema unificado de relatórios JSON
- Sistema de token de consentimento
- Análise de IA via LangChain

---

## ⚖️ Licença

Este projeto está licenciado sob a **MIT License** - consulte o arquivo [LICENSE](https://github.com/rodhnin/asterion-network-minotaur/blob/main/LICENSE) para obter detalhes.```
MIT License

Copyright (c) 2025-2026 Rodney Dhavid Jimenez Chacin

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

⚠️ Isenção de Responsabilidade

IMPORTANTE: Esta ferramenta é somente para testes de segurança autorizados.

Aviso Legal

Ao usar o Asterion, você reconhece e concorda que:

✅ Você somente escaneará redes/sistemas que possui ou tem permissão explícita por escrito para testar
✅ Você cumprirá todas as leis e regulamentos aplicáveis
✅ Você entende que acesso não autorizado é ilegal (CFAA, Computer Misuse Act, etc.)
✅ O autor e os colaboradores não assumem nenhuma responsabilidade por uso indevido
✅ Este software é fornecido "como está", sem garantia de qualquer tipo

Divulgação Responsável

Se você descobrir vulnerabilidades usando o Asterion:

📧 Entre em contato primeiro com o proprietário da rede/sistema, em particular
⏰ Dê um prazo razoável para correção (normalmente 90 dias)
🤝 Coordene o cronograma de divulgação
📝 Documente suas descobertas profissionalmente

Em Caso de Dúvida

Não escaneie. Se você não tem certeza se tem permissão, provavelmente não tem.

🙏 Agradecimentos

O Asterion se apoia nos ombros de gigantes:

Microsoft — Plataforma .NET e documentação de segurança
BloodHound — Pesquisa de segurança de AD e análise de caminhos de ataque
OWASP — Padrões de segurança (Top 10, Testing Guide, ASVS)
SMBLibrary — Implementação SMB em C# puro por Tal Aloni
SSH.NET — Implementação do protocolo SSH para .NET
DnsClient.NET — Biblioteca de cliente DNS por Michael Conrad
LangChain — Framework de IA que potencializa a análise inteligente
Anthropic & OpenAI — Modelos de IA para análise de vulnerabilidades
Ollama — Inferência de IA local para escaneamento focado em privacidade

Agradecimentos especiais a todos os pesquisadores de segurança que praticam e promovem o hacking ético.

👤 Autor

Rodney Dhavid Jimenez Chacin (rodhnin)

🌐 Site e Contato: rodhnin.com
💼 GitHub: @rodhnin
🐦 Twitter: @rodhnin

Para dúvidas, feedback ou propostas de colaboração, visite rodhnin.com

💬 Comunidade

Discussões: GitHub Discussions
Problemas: GitHub Issues
Lançamentos: GitHub Releases

Feito com ❤️ para profissionais de segurança e administradores de redes corporativas em todo o mundo

⭐ Dê uma estrela neste repositório se você o achar útil! ⭐

Reportar Bug • Solicitar Recurso • Documentação

🐂 Asterion — Navegando pelo Labirinto de Redes 🐂

Asterion v0.2.0 — Maio de 2026

Feito com ❤️ por rodhnin | Parte da Argos Security Suite

Segurança SMB/CIFS	Compartilhamentos anônimos, assinatura SMB, SMBv1 (EternalBlue), NTLMv1, compartilhamentos graváveis
Segurança RDP	Autenticação em Nível de Rede (NLA), níveis de criptografia, RDP exposto
LDAP/Active Directory	Bind anônimo, assinatura LDAP, políticas de senha, pré-autenticação Kerberos
Segurança Kerberos	AS-REP roasting, Kerberoasting, tempo de vida excessivo do ticket
SNMP	Strings de comunidade padrão, SNMPv1/v2c, acesso de escrita
DNS/NetBIOS	Transferências de zona (AXFR), envenenamento de LLMNR/NetBIOS, mDNS
Sistemas Windows	Firewall, Registro (UAC, LSA), serviços, escalonamento de privilégios
Sistemas Linux	iptables/nftables, SSH, Samba/NFS, binários SUID, configuração incorreta do sudo

JSON	`--output json`	Relatórios legíveis por máquina (padrão)
HTML	`--output html`	Belos relatórios com tema Minotauro
Both	`--output both`	Gera tanto JSON quanto HTML

`--target, -t`	IP/CIDR/domain	Obrigatório	Alvo(s): `192.168.1.0/24`, `10.0.0.1`, `corp.local`, lista separada por vírgulas
`--mode, -m`	safe, aggressive	`safe`	Modo de varredura (agressivo exige token de consentimento)
`--output, -o`	json, html, both	`json`	Formato de saída
`--ports, -p`	lista de portas	Detecção automática	Portas a varrer (ex.: `22,80,443` ou `8000-9000`)
`--threads`	1-20	5	Número de threads simultâneas
`--rate`	1-20	5	Limite de taxa de requisições (req/s)
`--timeout`	segundos	10	Tempo limite de conexão
`--verify-ssl`	flag	true	Verificar certificados SSL/TLS (desative para certificados autoassinados)
`--verbose, -v`	flag	false	Ativar log detalhado
`--diff`	last / scan_id	-	Comparar com a varredura anterior (`--diff last` ou `--diff 42`)
`--creds-file`	caminho para YAML	-	Carregar todas as credenciais do arquivo YAML

`--auth`	`DOMAIN\user:pass`	Credenciais de domínio para verificações LDAP/Kerberos/SMB/AD
`--auth-ntlm`	`user:hash`	Autenticação NTLM pass-the-hash
`--kerberos`	`user:pass@REALM`	Credenciais Kerberos
`--winrm`	`DOMAIN\user:pass`	Verificações Windows remotas via WinRM (firewall, registro, serviços, AD)
`--ssh`	`user:pass`	Autenticação por senha SSH para verificações Linux remotas
`--ssh-key`	`user:/path/key`	Autenticação baseada em chave SSH
`--sudo-password`	`pass`	Senha de elevação sudo para verificações Linux privilegiadas
`--bastion`	`host:user:key`	Host de salto/bastion para SSH multi-hop

`--use-ai`	flag	false	Ativar análise com IA
`--ai-tone`	technical, non_technical, both	technical	Formato da análise de IA
`--ai-provider`	openai, anthropic, ollama	openai	Provedor de IA
`--ai-model`	nome do modelo	gpt-4o-mini-2024-07-18	Modelo de IA a usar
`--ai-budget`	valor em USD	-	Abortar a IA se o custo estimado exceder este valor
`--ai-stream`	flag	false	Transmitir tokens de IA para stdout em tempo real
`--ai-agent`	flag	false	Modo agente LangChain com ferramenta de consulta de CVE da NVD
`--ai-compare`	`prov/model,prov/model`	-	Comparação entre vários modelos

Safe	Verificações de rede não intrusivas	❌ Não	5 req/s
Aggressive	Testes aprofundados de AD/sistema	✅ Sim	10 req/s
AI Analysis	Análise de vulnerabilidades	✅ Sim	N/A

Mais Populares

asterion-network-minotaur

Em Ação

🎯 O que é o Asterion?

Por que o Asterion?

O Que Ele Escaneia

✨ Recursos

🛡️ Varredura de Segurança de Rede Principal```bash

One command, comprehensive network analysis

🔐 Sistema de Token de Consentimento

1. Generate token

2. Place token (choose one method)

HTTP: Upload to https://corp.local/.well-known/verify-abc123.txt

DNS: Add TXT record: corp.local = "asterion-verify=verify-abc123"

SSH: Create file /tmp/consent_verify-abc123 with token content

3. Verify ownership

4. Now you can use aggressive mode

🚀 Início Rápido

Pré-requisitos

Instalação — Configuração Automatizada (Recomendada)

Linux / macOS```bash

Clone repository

Run setup script

Instalação — Configuração Manual

Passo 1: Clonar o repositório```bash

Passo 5: Crie os diretórios de configuração

Passo 6: (somente Linux/macOS) Criar comando global```bash

Create wrapper script

Paste this content:

Make executable

Or permanently:

Or with dotnet

Scan localhost (full path)

Scan local subnet (full path)

Formatos de Saída

Opções de Tom da IA

Exemplos Básicos

Build and start

Run a scan

View logs

Stop services

Opções do Comando Scan

Flags Principais

Flags de Credenciais

Flags de IA

Exemplos de Referência Rápida

Varredura Básica```bash

Scan local subnet (default: JSON output, safe mode)

Scan with HTML report

Scan specific IP

Otimização de Desempenho```bash

Slow, stealthy scan (3 threads, 2 req/s)

Fast scan (15 threads, 15 req/s)

Specific ports only

Auditoria do Sistema Linux```bash

Remote Linux SSH scan (password)

SSH with sudo elevation (for privileged checks)

SSH key authentication

Via bastion host

Full Linux audit: SSH + sudo + AI + HTML

Depuração```bash

Verbose output

Verbose + custom timeout

Test connectivity only (timeout 5s)

Verificar Consentimento (3 Métodos)

1. Create file at: https://corp.local/.well-known/verify-a3f9b2c1d8e4f5a6.txt

2. Verify:

1. Create file: /tmp/consent_verify-a3f9b2c1d8e4f5a6

2. Verify:

Cenários do Mundo Real

Cenário 1: Avaliação Rápida de Rede```bash

Fast, no-auth scan with HTML report

Cenário 3: Varredura Stealth```bash

Slow, careful scan to avoid detection

🤖 Análise com IA

Provedores Suportados

OpenAI GPT-4 Turbo

Ollama (Modelos Locais)

Install Ollama: https://ollama.ai

Future feature