Skip to content

docs: add egress filtering documentation#202

Merged
Mossaka merged 3 commits intomainfrom
docs/security-model-port-vs-domain
Jan 13, 2026
Merged

docs: add egress filtering documentation#202
Mossaka merged 3 commits intomainfrom
docs/security-model-port-vs-domain

Conversation

@Mossaka
Copy link
Collaborator

@Mossaka Mossaka commented Jan 13, 2026

Summary

Adds docs/egress-filtering.md explaining AWF's security model for network filtering, specifically addressing: Why use port restrictions if they can be bypassed?

Key points:

  • Domain allowlist is the primary security control
  • Port restrictions are defense-in-depth, not primary security
  • Includes literature citations from industry sources

Literature Cited

Supporting domain allowlist as primary control:

Supporting port restrictions as defense-in-depth:

Test plan

  • Document renders correctly in markdown
  • All external links are valid and accessible

🤖 Generated with Claude Code

Explains why AWF uses domain allowlist as primary security control with
port restrictions as defense-in-depth. Includes:

- Literature citations from Squid Wiki, NIST SP 800-41, CMU SEI
- Counter-arguments on port filtering obsolescence (Palo Alto, Gartner NGFW)
- Analysis of bypass techniques (SSH over 443, DNS tunneling)
- Balanced conclusion with industry best practices

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@github-actions
Copy link

github-actions bot commented Jan 13, 2026

💫 TO BE CONTINUED... Smoke Claude was cancelled! Our hero faces unexpected challenges...

@github-actions
Copy link

github-actions bot commented Jan 13, 2026

📰 VERDICT: Smoke Copilot has concluded. All systems operational. This is a developing story. 🎤

@github-actions
Copy link

Test Coverage Report

Metric Coverage Covered/Total
Lines 77.12% 1281/1661
Statements 77.17% 1312/1700
Functions 77.04% 141/183
Branches 69.29% 431/622
Coverage Thresholds

The project has the following coverage thresholds configured:

  • Lines: 38%
  • Statements: 38%
  • Functions: 35%
  • Branches: 30%

Coverage report generated by `npm run test:coverage`

More specific name that accurately describes the content (port vs domain
filtering for egress traffic). Avoids confusion with docs/security.md
which covers vulnerability reporting policy.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@Mossaka Mossaka changed the title docs: add security model for port vs domain filtering docs: add egress filtering documentation Jan 13, 2026
@github-actions
Copy link

github-actions bot commented Jan 13, 2026

📰 DEVELOPING STORY: Smoke Copilot reports was cancelled. Our correspondents are investigating the incident...

@github-actions
Copy link

💥 WHOOSH! Smoke Claude springs into action on this pull request! [Panel 1 begins...]

@github-actions
Copy link

📰 BREAKING: Smoke Copilot is now investigating this pull request. Sources say the story is developing...

@github-actions
Copy link

Smoke Test Results

✅ GitHub MCP - PRs: #190, #188
✅ File Write - Test file created
✅ Bash - Verification successful

Status: PASS

📰 BREAKING: Report filed by Smoke Copilot fer issue #202 🗺️

@github-actions
Copy link

Smoke Test Results - Claude

GitHub MCP: #131, #141
File Write: Test file created
Bash: File verified
Playwright: Navigation failed (tunnel connection errors)

Status: FAIL (Playwright connectivity issue)

💥 [THE END] — Illustrated by Smoke Claude fer issue #202 🗺️

@Mossaka Mossaka merged commit 167cd1d into main Jan 13, 2026
38 checks passed
@Mossaka Mossaka deleted the docs/security-model-port-vs-domain branch January 13, 2026 07:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant