How recepbaykara/fraud-guard works
Fraud Guard is a real-time fraud-detection plugin running inside Kong’s data plane. Its documented request path extracts a transaction, checks whitelists, evaluates rules against Redis-backed context, scores violations, applies shadow/enforce behavior, and reports results through logs, a webhook, and response headers. Rule categories and supporting detectors are shown as distinct capabilities. No source excerpts were provided, so relationships are limited to the README’s documented flow; paths for undocumented implementation details use their enclosing directories where appropriate.
Main entry points: rule_engine.lua Rule engine · execution_mode.lua Execution mode · transaction_extractor.lua Transaction extraction · modules Whitelist check
Components 22
Request handling
- Transaction extraction
modules/transaction_extractor.lua - Whitelist check
modules
Fraud detection
- Rule engine
modules/rule_engine.lua - Account rules
rules/account_rules.lua - POS rules
rules/pos_rules.lua - Transfer rules
rules/transfer_rules.lua - Mobile rules
rules/mobile_rules.lua - API security rules
rules/api_security_rules.lua - Amount detector
detectors/amount.lua - Geographic detector
detectors/geo.lua - Pattern detector
detectors/pattern.lua - Velocity detector
detectors/velocity.lua
Decision and state
- Risk scoring
utils/scorer.lua - Execution mode
modules/execution_mode.lua - Failure mode
modules/fail_mode.lua - Redis cache
storage/cache.lua - Redis adapter
storage/redis_adapter.lua
Reporting
- Compliance logging
utils/logger.lua - Kong response
handler.lua
Other components
- API client
- Redis
- Webhook receiver
Connections 17
- API client → Transaction extraction: submits transaction
README.md - Transaction extraction → Whitelist check: checks whitelist
README.md - Whitelist check → Redis: connects to
README.md - Redis → Rule engine: provides context
README.md - Rule engine → Account rules: runs rule set
README.md - Rule engine → POS rules: runs rule set
README.md - Rule engine → Transfer rules: runs rule set
README.md - Rule engine → Mobile rules: runs rule set
README.md - Rule engine → API security rules: runs rules
README.md - Rule engine → Risk scoring: scores violations
README.md - Risk scoring → Execution mode: passes score
README.md - Execution mode → Failure mode: applies failure policy
README.md - Execution mode → Compliance logging: logs result
README.md - Execution mode → Webhook receiver: sends webhook
README.md - Execution mode → Kong response: sets response headers
README.md - Redis adapter → Redis: accesses
- Redis cache → Redis adapter: delegates to