VoidAccess

Snelstart

Installeer de software via pip: pip install voidaccess

Voorbeelden van commando's:

  • voidaccess investigate "LockBit ransomware" --no-llm --no-tor --depth shallow
  • voidaccess list
  • voidaccess actors
  • voidaccess status

Functionaliteiten

  • Parallelle collectie: Zoekt gelijktijdig in Tor-indexen, paste-sites, code-forges, security-feeds en gecureerde .onion-seeds.
  • Entiteitextractie: Identificeert IOC's, wallets, inloggegevens, handles, kwetsbaarheden, actoren, malware, personen en organisaties.
  • Verrijking uit meerdere bronnen: Voegt context toe op basis van reputatie, datalekken, passief DNS, sandboxen, blockchain en threat-feeds.
  • Actor-intelligence: Legt aliassen, infrastructuur, notities, tijdlijnen en relaties tussen verschillende onderzoeken vast.
  • Relatiegrafieken: Bouwt co-occurrence grafieken, communities, paden en infrastructuurclusters.
  • Inhoudsveiligheid: Filtert verboden queries, URL's, inhoud en geëxtraheerde entiteiten via verplichte pipeline-gates.
  • Gestructureerde exports: Produceert resultaten in STIX 2.1, MISP, Sigma, YARA, Snort, Suricata, CSV, Markdown, JSON en IOC-pakketten.
  • CLI en web-UI: Kan lokaal worden uitgevoerd met SQLite of als een Docker Compose-stack met PostgreSQL en een browserinterface.

De Pipeline

Het proces verloopt in 13 stappen:

  1. Verfijnen van de onderzoeksvraag met het geselecteerde LLM.
  2. Parallelle collectie vanuit Tor-zoekmachines, paste-sites, code-forges, RSS-feeds en gecureerde seeds.
  3. Filteren van ruis of irrelevante pagina's.
  4. Verrijken van de query en vroege indicatoren via threat-intelligence bronnen.
  5. Recursief ontdekken van aanvullende .onion-links.
  6. Hergebruiken van recent verwerkte pagina's vanuit de vector-cache.
  7. Ophalen van geselecteerde pagina's via Tor met limieten op de responsgrootte.
  8. Vastleggen (persist) van nieuw verzamelde inhoud.
  9. Samenvoegen van verzamelde en verrijkte intelligentie.
  10. Extraheren van entiteiten met regex, NER en optionele LLM-analyse.
  11. Cross-referencen van entiteiten met historische en seed-datasets.
  12. Bouwen van relaties, communities en infrastructuurclusters.
  13. Genereren van de uiteindelijke intelligence-samenvatting en exportklaar resultaat.

Details over het volledige pipeline-gedrag, timeouts, herstel en datastromen zijn gedocumenteerd in de Architectuur.

Entiteitstypen

CategorieVoorbeelden
CryptovalutaBitcoin, Ethereum, Monero, Litecoin, Zcash, Solana, Tron, ENS
NetwerkindicatorenIPv4, IPv6, domeinen, URL's, .onion-adressen, MAC-adressen, PGP-keys
BestandsindicatorenMD5, SHA-1, SHA-256, malware-families
InloggegevensCloud-keys, tokens, JWT's, API-keys, stealer logs, combo-list entries
BerichtenverkeerTelegram, Discord, XMPP, Tox, Session, Matrix, Wire, ICQ, Wickr
KwetsbaarhedenCVE's, MITRE ATT&CK technieken en tactieken, Exploit-DB ID's
Detectie-inhoudYARA-regels, Nuclei-templates, Snort- en Suricata-indicatoren
Threat IntelligenceActor-handles, ransomware-groepen, paste-links, personen, organisaties, locaties

Collectie en Verrijking

LaagBronnen
Dark-web search16+ Tor-zoekmachines en gecureerde .onion-seeds
Open-web collectiePastebin, dpaste, paste.ee, Rentry, GitHub, GitLab en gecureerde RSS-feeds
Threat feedsAlienVault OTX, abuse.ch, MalwareBazaar, ThreatFox, URLhaus, ransomware.live, CISA KEV
IP en domein contextShodan InternetDB, GreyNoise, AbuseIPDB, Feodo Tracker, C2IntelFeeds, crt.sh, URLScan.io, Wayback Machine, CIRCL PDNS, RDAP
Bestand en identiteit contextVirusTotal, Hybrid Analysis, Have I Been Pwned, EmailRep
BlockchainBlockCypher en Etherscan

Bronnen die API-keys vereisen worden automatisch overgeslagen als deze keys afwezig zijn. De volledige referentie voor keys en configuratie staat in de Architectuur.

Optionele Vector Embeddings

De standaardinstallatie kan zonder PyTorch draaien. Wanneer de embedding-stack niet beschikbaar is, gebruikt VoidAccess een deterministische SHA-256 fallback-encoder. Om volledige sentence-transformer vector embeddings te activeren, kunnen de optionele NLP-afhankelijkheden worden geïnstalleerd:

pip install "voidaccess[nlp]"

LLM-providers

ProviderTypische modellenNotities
OpenRouterDeepSeek, Llama, ClaudeStandaardroute; gratis modellen beschikbaar
GroqLlamaSnelle hosted inferentie met een gratis laag
OpenAIGPT-modellenAPI-key vereist
AnthropicClaudeClaude Haiku is de geteste standaard
Google GeminiGemini Flash en ProGoogle AI Studio key vereist
OllamaElk geïnstalleerd lokaal modelLokaal en geschikt voor air-gapped implementaties

CLI-referentie

CommandoBeschrijving
voidaccess investigate "QUERY"Start een onderzoek
voidaccess showOpent de interactieve entiteitsbrowser
voidaccess export INVESTIGATION_ID --format FORMATExport als STIX, MISP, Sigma, YARA, Snort, Suricata, package, CSV, Markdown of JSON
voidaccess package INVESTIGATION_IDBouwt een IOC-pakket (ZIP)
voidaccess enrich INVESTIGATION_IDVerrijkt een opgeslagen onderzoek opnieuw
voidaccess listLijst opgeslagen onderzoeken op
voidaccess statusToont status van configuratie, Tor, cache, engine en seeds
voidaccess actorsLijst persistente actor-profielen op
voidaccess actor HANDLEToont een actor-profiel
voidaccess actor HANDLE --timelineToont een tijdlijn van de activiteiten van een actor
voidaccess actor HANDLE --note "TEXT"Voegt een analistennotitie toe aan een actor-profiel
voidaccess timeline HANDLEOpent direct de tijdlijn van een actor
voidaccess configureStart de setup-wizard
voidaccess configure llmConfigureert de LLM-provider, het model en de key
voidaccess configure keysConfigureert API-keys voor verrijking
voidaccess configure torOverschrijft de Tor-proxy host en poort
voidaccess versionPrint de geïnstalleerde versie

Optionele clearnet-verzoeken kunnen ScrapingAnt gebruiken met --use-scraping-api of --use-proxies; verkeer naar Tor, .onion, GitHub en GitLab is hiervan niet beïnvloed.

Zelf-hosten

De volledige stack (PostgreSQL, Tor, FastAPI en Next.js) kan worden gedraaid met Docker Compose. De handleiding voor zelf-hosten bevat informatie over de begeleide installatie, omgevingsconfiguratie, beheer en probleemoplossing.

Documentatie en Links

  • Self-hosting guide: Docker Compose, omgevingsinstellingen, beheer en troubleshooting.
  • Architecture: Pipeline-internals, modules, schema, API, verrijking, grafieken en configuratiereferentie.
  • Contributing: Ontwikkelomgeving, standaarden en pull requests.
  • Security: Ondersteunde versies en rapporteren van private kwetsbaarheden.
  • Usage policy: Vereisten voor geautoriseerd gebruik en verboden activiteiten.
  • PyPI: Gepubliceerd pakket en release-bestanden.
  • GitHub: Broncode, issues en releases.
  • License: MIT. Gebruik VoidAccess uitsluitend voor geautoriseerd beveiligingsonderzoek en threat-intelligence werk; zie de Usage Policy.