titrate-firewall-tutor/project.yaml at master · hnai-787/titrate-firewall-tutor · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
name: Titrate
slug: titrate

category: cybersecurity
subcategory: "Object-Oriented Programming"

status: completed

visibility: public

description:
  short: "Firewall Tutor: a Blazor WebAssembly + C# tool that steps through Cisco ACL evaluation field-by-field, showing exactly why a packet was allowed or denied."
  long: |
    Started as a Windows Forms teaching app and was rebuilt into an
    interactive ACL execution visualizer. A pure C#
    evaluation engine (FirewallTutor.Core) parses a real (bounded-subset)
    Cisco extended ACL and produces a full execution trace for one packet:
    every rule considered, every field (protocol/source/port/destination)
    checked individually with a plain-English reason, the exact point
    evaluation stops at the first match, and the always-present implicit
    deny. A Blazor WebAssembly UI (client-side only, no backend) lets a
    learner predict the outcome, then step forward/backward through the
    trace, including a bit-level breakdown for wildcard-mask address
    rules. A Spectre.Console CLI provides the same step-through in a
    terminal. Positioned as the teaching counterpart to the sibling
    project firewall-rule-engine-cpp (fwlint), which audits whole
    rulesets rather than explaining single-packet execution. The original
    WinForms program is preserved unmodified under archive/original/.

technologies: ["C#", ".NET 10", "Blazor WebAssembly", "Spectre.Console", "xUnit"]
tags: ["cybersecurity", "firewall", "csharp", "blazor", "webassembly", "networking-education", "cli-tool"]

repository:
  provider: github
  visibility: public
  sync: true

portfolio:
  enabled: true
  featured: false

documentation:
  readme: true
  case_study: false

dates:
  started: null
  completed: null

links:
  github: https://github.com/hnai-787/titrate-firewall-tutor
  demo: https://hnai-787.github.io/titrate-firewall-tutor/
  documentation: null

assets:
  hero: assets/brand/titrate-readme-banner.png
  screenshots: []

achievements: []

metrics:
  - label: "Unit tests passing (xUnit)"
    value: "33/33"
    verified: true
  - label: "Rule-order reversal demo: same rules, opposite result"
    value: "Verified via CLI (ordering-demo.acl vs ordering-demo-reordered.acl)"
    verified: true