How nidusvespae/liao-ioc-timeline works
Liao is a self-checking Linux host-inspection toolkit, scheduled every six hours. Its main workflow collects host telemetry and baseline comparisons into a case folder, then assembles events—including off-host DNS findings—into a correlated timeline. A phone-side verifier independently checks case-reported toolkit hashes against an off-host trust anchor; review scripts summarize the resulting case. The README documents pipeline wiring, while sampled source confirms timeline feeder calls and review-file reads. Collector-to-analyzer details and several integration points are therefore represented only where documented.
Main entry points: collect_case.sh Case collector · ioc_timeline.py IOC timeline · assemble_case.sh Case assembler · liao-collect.service Collector service
Components 25
Scheduling
- Six-hour timer
systemd/liao-timeline.timer - Collector service
systemd/liao-collect.service - Assembler service
systemd/liao-assemble.service
Host collection
- Case collector
liao/collect_case.sh - Case folder
- Host baselines
- File integrity
liao/fim.py - Persistence audit
liao/persistence_audit.py - Account audit
liao/account_audit.py - Log integrity
liao/log_integrity.py - Auth log analysis
liao/log_parser.py - Process inventory
liao/proc_inventory.py - Socket inventory
liao/conn_inventory.py
Analysis and timeline
- Off-host DNS log
- Case assembler
liao/assemble_case.sh - DNS analysis
liao/dns_parser.py - IOC timeline
liao/ioc_timeline.py - Reputation lookup
liao/rep_lookup.py
Trust verification
- Phone verifier
phone/verify_case.py - Anchor verifier
phone/verify_anchor_tar.py - Off-host anchor
Case review
- Case summary
tools/review_case.py - Detail review
tools/review_detail.py
Other components
- Phone operator
- Case reviewer
Connections 29
- Six-hour timer → Collector service: triggers
README.md - Collector service → Case collector: runs
README.md - Case collector → File integrity: collects hashes
README.md - Case collector → Persistence audit: collects and diffs
README.md - Case collector → Account audit: collects and diffs
README.md - Case collector → Log integrity: collects and diffs
README.md - Case collector → Auth log analysis: collects auth log
README.md - Case collector → Process inventory: collects processes
README.md - Case collector → Socket inventory: collects sockets
README.md - Host baselines → Case collector: provides references
README.md - Case collector → Case folder: writes findings
README.md - Collector service → Assembler service: on success
README.md - Assembler service → Case assembler: runs
README.md - Off-host DNS log → Case assembler: provides logs
README.md - Case assembler → Case folder: assembles in
README.md - IOC timeline → Persistence audit: calls audit
liao/ioc_timeline.py - IOC timeline → DNS analysis: calls analysis
liao/ioc_timeline.py - Case assembler → IOC timeline: runs assembler
README.md - IOC timeline → Case folder: writes timeline
README.md - DNS analysis → Reputation lookup: optional lookup
README.md - Phone operator → Phone verifier: runs
README.md - Case folder → Phone verifier: supplies hashes
phone/verify_case.py - Off-host anchor → Phone verifier: supplies manifest
phone/verify_case.py - Phone operator → Anchor verifier: checks anchor
README.md - Off-host anchor → Anchor verifier: is verified
phone/verify_anchor_tar.py - Case reviewer → Case summary: runs
tools/review_case.py - Case reviewer → Detail review: runs
tools/review_detail.py - Case folder → Case summary: reads case files
tools/review_case.py - Case folder → Detail review: reads findings
tools/review_detail.py