A desktop application firewall for Subgraph OS.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Go to file
dma a8321095be
fixing broken deps..
7 years ago
Godeps vendoring 7 years ago
fw-ozcli Change path of oz socket 7 years ago
fw-prompt Support for TLSGuard in prompter 7 years ago
fw-settings Should solve a (newly introduced) intermittent crash issue with fw-settings. 8 years ago
gnome-shell/firewall@subgraph.com Change default for non-sandboxed connections. 7 years ago
nfqueue Very dirty/experimental replacement of nfqueue with native github.com/subgraph/go-nfnetlink package. 8 years ago
proc-coroner Added per-process (ephemeral) rule support. 8 years ago
sgfw move sgfw socks config location 7 years ago
sources Merge remote-tracking branch 'origin/shw_dev' 7 years ago
vendor fixing broken deps.. 7 years ago
.gitignore ... 8 years ago
LICENSE Add license, closes #17 8 years ago
README-DEV.txt Full support for multiple protocol types (UDP, ICMP). 8 years ago
README.md Added info about iptable rules... 8 years ago
README.testing Readme for testing fw-daemon with bridged traffic. 8 years ago
main.go moved main... 8 years ago

README.md

Subgraph Firewall

A desktop application firewall for Subgraph OS.

Subgraph Firewall is an application firewall that is included in Subgraph OS. While most firewalls are designed to handle incoming network communications, an application firewall can handle outgoing network communications. Subgraph Firewall can apply policies to outgoing connections on a per-application basis.

Application firewalls are useful for monitoring unexpected connections from applications. For example, some applications may phone home to the vendor's website. Often this activity is legitimate (non-malicious) but it still may violate the user's privacy or expectations of how the software operates. Subgraph Firewall gives users the choice to allow or deny these connections.

Malicious code may also phone home to a website or server that is operated by the hacker or malicious code author. Subgraph Firewall can also alert the user of these connections so that they can be denied.

Application firewalls cannot prevent all malicious code from connecting to the Internet. Sophisticated malicious code can subvert the allowed connections to bypass the firewall. However, the firewall may alert the user of connection attempts by less sophisticated malicious code.

Read more in the Subgraph OS Handbook.

Building

# First install the build dependencies
apt install debhelper dh-golang dh-systemd golang-go libcairo2-dev libglib2.0-dev libgtk-3-dev libnetfilter-queue-dev
# To build the Debian package:
git clone -b debian https://github.com/subgraph/fw-daemon.git
cd fw-daemon
## To build from stable
gbp buildpackage -us -uc
## To build from head
gbp buildpackage -us -uc --git-upstream-tree=master
## Install the package
dpkg -i /tmp/build-area/fw-daemon{,-gnome}-*.deb
## Refresh your gnome-shell session 'alt-r' type 'r' hit enter.

You will be left to install the matching iptables rules. While this may vary depending on your environment, pre-existing ruleset and preferred mechanism; something like the following needs to be added:

iptables -t mangle -A OUTPUT -m conntrack --ctstate NEW -j NFQUEUE --queue-num 0 --queue-bypass
iptables -A INPUT -p udp -m udp --sport 53 -j NFQUEUE --queue-num 0 --queue-bypass
iptables -A OUTPUT -p tcp -m mark --mark 0x1 -j LOG
iptables -A OUTPUT -p tcp -m mark --mark 0x1 -j REJECT --reject-with icmp-port-unreachable