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
Stephen Watt b9c2e03afd
Overhaul of GetPendingRequests DBus method to call AddRuleAsync multiple times instead of returning a string array.
7 years ago
Godeps Re-sync to master. 7 years ago
fw-ozcli Re-sync to master. 7 years ago
fw-prompt Overhaul of GetPendingRequests DBus method to call AddRuleAsync multiple times instead of returning a string array. 7 years ago
fw-settings Re-sync to master. 7 years ago
gnome-shell/firewall@subgraph.com Merge newest branch changes with latest changes to master. 7 years ago
nfqueue Very dirty/experimental replacement of nfqueue with native github.com/subgraph/go-nfnetlink package. 8 years ago
proc-coroner Re-sync to master. 7 years ago
sgfw Overhaul of GetPendingRequests DBus method to call AddRuleAsync multiple times instead of returning a string array. 7 years ago
sources Merge newest branch changes with latest changes to master. 7 years ago
vendor Various code cleanups (still buggy/WIP). 7 years ago
.gitignore Re-sync to master. 7 years ago
LICENSE Add license, closes #17 8 years ago
README-DEV.txt Re-sync to master. 7 years ago
README.md Re-sync to master. 7 years ago
README.testing Readme for testing fw-daemon with bridged traffic. 8 years ago
TODO Overhaul of GetPendingRequests DBus method to call AddRuleAsync multiple times instead of returning a string array. 7 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