Skip to content

Latest commit

 

History

History

examples

README.md

AWF Examples

This directory contains example scripts demonstrating common ways to use the Agentic Workflow Firewall (awf).

Prerequisites

  • Docker running on your machine
  • awf installed (see installation instructions)
  • sudo access (required for iptables manipulation)

Examples

File Description
basic-curl.sh Simple HTTP request through the firewall
github-copilot.sh Using GitHub Copilot CLI with the firewall
using-domains-file.sh Using a file to specify allowed domains
blocked-domains.sh Blocking specific domains with allowlist/blocklist
debugging.sh Debug mode with log inspection
domains.txt Example domain allowlist file

Running Examples

Each example is a standalone shell script. Run with:

# Make executable (if needed)
chmod +x examples/*.sh

# Run an example
./examples/basic-curl.sh

Note: Most examples require sudo for iptables manipulation. The scripts will prompt for sudo access if needed.

Domain Matching

AWF automatically matches subdomains. For example:

  • github.com matches github.com, api.github.com, raw.githubusercontent.com, etc.

See domains.txt for domain file format examples.