Skip to content

genesisgzdev/nexus-intelligence

Repository files navigation

Nexus Intelligence Framework (v1.6.0)

Technical Specification

Nexus Intelligence is a distributed, asynchronous forensic orchestration platform designed for autonomous Open Source Intelligence (OSINT) and cross-project threat correlation. It operates under a Zero-API Mandate, utilizing native network protocols to interact directly with target infrastructure.

System Architecture

`mermaid graph TB subgraph Input_Layer [Orchestration] M[main.py] -->|argparse| ORCH[IntelligenceOrchestrator] ORCH -->|asyncio.Queue| Q[Task Queue] end

subgraph Analysis_Layer [Forensic Engines]
    Q --> W1[Worker 1]
    Q --> W2[Worker 2]
    W1 & W2 --> DNS[DNS: raw UDP/53]
    W1 & W2 --> SSL[SSL: Local X.509 Parser]
    W1 & W2 --> WEB[Web: JA3 Impersonation]
    W1 & W2 --> MAIL[Mail: SMTP Banner Grabbing]
end

subgraph Intelligence_Layer [AI Correlation]
    DNS & SSL & WEB & MAIL -->|JSONL| DB[(SQLite Persistence)]
    DB -->|Text Context| VEC[VectorCorrelator]
    VEC -->|Sentence-Transformers| EMB[all-MiniLM-L6-v2]
    EMB -->|Inner Product| FAISS[FAISS Vector Index]
end

subgraph Output_Layer [Forensics]
    FAISS -->|Recall@K| REL[Related Threats Mapping]
    REL -->|Markdown| REP[Automated ReportingEngine]
end

`

Core Modules & Protocol Implementation

1. Advanced DNS Forensics

  • Mechanism: Utilizes \dns.asyncresolver\ for non-blocking recursion.
  • Protocol Integrity: Bypasses HTTPS-based resolvers (DoH) to interact directly with nameservers, capturing raw record sets (A, AAAA, MX, TXT, SOA, CAA).
  • Security: Implements SSRF gating, preventing queries to internal RFC 1918 addresses or cloud metadata endpoints.

2. TLS/SSL Forensic Engine

  • Local Handshake: Performs a full async TLS handshake without verifying chains (Forensic Mode) to extract raw DER-encoded certificates.
  • X.509 Analysis: Parses Issuer, Subject, Validity, Serial, and Subject Alternative Names (SAN) locally using the \cryptography\ library.
  • Fingerprinting: Calculates SHA-256 fingerprints and analyzes signature hash algorithms to detect compromised or spoofed certificates.

3. Application Stack Fingerprinting

  • JA3 Impersonation: Uses \curl_cffi\ to mimic specific browser cryptographic signatures (Chrome 120), bypassing perimeter Bot-Management (Cloudflare/Akamai).
  • Security Header Audit: Passively analyzes CSP, HSTS, X-Frame-Options, and X-Content-Type-Options to identify misconfigurations.

4. Semantic Correlation (Vector Search)

  • Local Embeddings: Generates 384-dimension vectors locally. No data leaves the trust boundary.
  • Similarity Search: Uses FAISS (Facebook AI Similarity Search) for high-speed Inner Product calculations.
  • Cross-Project Linking: Correlates EDR kernel events (\ hreat-detection-suite) with OSINT findings to identify multi-stage attack chains.

Data Governance & Persistence

  • SQLite Schema: All findings are stored in a relational schema with JSON blobs for modular extensibility.
  • Integrity Auditing: The \VectorIntegrityAuditor\ routine validates mathematical normalization and detects semantic drift in the embedding model.

Deployment

  • Docker: Hardened Alpine-based containers with unprivileged user contexts (\USER nexususer).
  • CI/CD: Workflows are configured for \workflow_dispatch\ to ensure successful, manually-gated deployments.

5. Automated Vector Correlation

Nexus now automatically triggers a semantic search after each report generation.

  • Contextual Ingestion: Ingests EDR kernel logs and historical OSINT findings.
  • Live Search: Performs a cosine similarity search using the local FAISS index to find related threat patterns.
  • Integrity Gating: Automatically executes the \VectorIntegrityAuditor\ to ensure mathematical precision of search results.

About

Asynchronous OSINT orchestration platform with local Vector Similarity Search (FAISS). Protocol-driven intelligence (DNS, TLS, SMTP) with zero-API reliance and automated forensic reporting.

Topics

Resources

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors