Nouveaux modules: - cmd/ja4sentinel/main.go : point d'entrée avec pipeline capture→parse→fingerprint→output - internal/config/loader.go : chargement YAML + env (JA4SENTINEL_*) + validation - internal/tlsparse/parser.go : extraction ClientHello avec suivi d'état de flux (NEW/WAIT_CLIENT_HELLO/JA4_DONE) - internal/fingerprint/engine.go : génération JA4/JA3 via psanford/tlsfingerprint - internal/output/writers.go : StdoutWriter, FileWriter, UnixSocketWriter, MultiWriter Infrastructure: - Dockerfile (multi-stage), Dockerfile.dev, Dockerfile.test-server - Makefile (build, test, lint, docker-build-*) - docker-compose.test.yml pour tests d'intégration - README.md (276 lignes) avec architecture, config, exemples API (api/types.go): - Ajout Close() aux interfaces Capture et Parser - Ajout FlowTimeoutSec dans Config (défaut: 30s, env: JA4SENTINEL_FLOW_TIMEOUT) - ServiceLog: +Timestamp, +TraceID, +ConnID - LogRecord: champs flatten (ip_meta_*, tcp_meta_*, ja4*) - Helper NewLogRecord() pour conversion TLSClientHello+Fingerprints→LogRecord Architecture (architecture.yml): - Documentation module logging + interfaces LoggerFactory/Logger - Section service.systemd complète (unit, security, capabilities) - Section logging.strategy (JSON lines, champs, règles) - api.Config: +FlowTimeoutSec documenté Fixes/cleanup: - Suppression internal/api/types.go (consolidé dans api/types.go) - Correction imports logging (ja4sentinel/api) - .dockerignore / .gitignore - config.yml.example Tests: - Tous les modules ont leurs tests (*_test.go) - Tests unitaires : capture, config, fingerprint, output, tlsparse - Tests d'intégration via docker-compose.test.yml Build: - Binaires dans dist/ (make build → dist/ja4sentinel) - Docker runtime avec COPY --from=builder /app/dist/ Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>
33 lines
735 B
Plaintext
33 lines
735 B
Plaintext
# Sample configuration file for ja4sentinel
|
|
# Copy to config.yml and adjust as needed
|
|
|
|
core:
|
|
# Network interface to capture traffic from
|
|
interface: eth0
|
|
|
|
# TCP ports to monitor for TLS handshakes
|
|
listen_ports:
|
|
- 443
|
|
- 8443
|
|
|
|
# Optional BPF filter (leave empty for auto-generated filter based on listen_ports)
|
|
bpf_filter: ""
|
|
|
|
outputs:
|
|
# Output to stdout (JSON lines)
|
|
- type: stdout
|
|
enabled: true
|
|
params: {}
|
|
|
|
# Output to file
|
|
# - type: file
|
|
# enabled: false
|
|
# params:
|
|
# path: /var/log/ja4sentinel/ja4.log
|
|
|
|
# Output to UNIX socket (for systemd/journald or other consumers)
|
|
# - type: unix_socket
|
|
# enabled: false
|
|
# params:
|
|
# socket_path: /var/run/ja4sentinel.sock
|