Inspired by 1x_prox as posted here:
AT&T Residential Gateway Bypass - True bridge mode!
Forked from jaysoffian/eap_proxy.
This fork has been modified for a regular Debian/Ubuntu/whatever system. It should also work with non-Debian-based distributions like RHEL, CentOS, Fedora, etc. just fine.
Note: The package, initscript, and systemd .service file are named eap-proxy. Everything else is named with an underscore as eap_proxy.
A .deb package is provided. Download the latest release.
Install the package with sudo dpkg --install eap-proxy_<version>_all.deb. Configure your system and set the proxy to start at boot (see OPTIONS, CONFIGURATION, EXAMPLES, and USAGE).
Reboot.
If everything worked, you will have connectivity. You can verify that eap_proxy is doing its job with grep eap_proxy /var/log/syslog. If you screwed up, redo your configuration and reboot/restart the daemon with systemctl restart eap-proxy as necessary.
(also Debian-based systems if you don't want to store your configuration in /etc/eap_proxy.conf, or you don't want to use the package)
Assuming you have Python 2 installed, all you really need to download is eap_proxy.py. Move it somewhere in your PATH and set it executable with something like sudo install --owner=root --group=root --mode=0755 eap_proxy.py /usr/sbin/eap_proxy.
You will have to handle starting the proxy with the proper options yourself. A .service file for systemd is provided in the repository as a model.
To keep your configuration, run sudo dpkg --remove eap-proxy.
To get rid of everything, run sudo dpkg --purge eap-proxy.
Delete the proxy script and any related files from the locations to which you saved them.
For a 6rd tunnel through AT&T, start here.
For native IPv6 through AT&T, start here.
If you do end up using both eap_proxy and either script, remember that your WAN interface may be a VLAN named something like eth0.0 and not eth0.
Here, have a manual page.
eap_proxy [-h|--help] [--ping-gateway] [--ignore-when-wan-up] [--ignore-start] [--ignore-logoff] [--vlan IF_VLAN] [--restart-dhcp] [--set-mac] [--daemon] [--pidfile [PIDFILE]] [--syslog] [--promiscuous] [--debug] [--debug-packets] IF_WAN IF_ROUTER
eap_proxy proxies 802.1X EAPOL (Extensible Authentication Protocol over LAN) frames between the Ethernet interfaces IF_WAN and IF_ROUTER.
Interface to which the WAN uplink is connected.
A VLAN configured to get its IP address automatically via DHCP may also exist on it (e.g. as eth0.0 on an interface named eth0).
See CONFIGURATION, EXAMPLES, and interfaces(5) for more information on how to configure a VLAN interface.
Interface to which the ISP router is connected.
Print a help message.
Normally the WAN is considered up if IF_VLAN) has an IP address.
This option additionally requires that there is a default route gateway that responds to a ping.
Do not proxy any EAPOL traffic from the router when the WAN is up (see −−ping−gateway).
Always ignore EAPOL−Start from the router.
A new device on a network with EAP access control is not allowed to use the network for any non-EAP traffic. To start the authentication process, it replies with a EAP−Response Identity packet to periodic EAP−Request Identity transmissions made by an authenticator. Although not required, devices can also send a EAPOL−Start frame on their own to ask any available authenticator to immediately transmit EAP−Request Identity.
Always ignore EAPOL−Logoff from the router.
Once a device sends EAPOL−Logoff, it must authenticate again before using the network for any non-EAP traffic.
Configuring the VLAN subinterface on IF_WAN
VLAN ID or interface name of the VLAN subinterface on IF_WAN (e.g. 0, eth0.4, vlan0). The value of IF_VLAN that is passed to eap_proxy is a hint to influence what it uses for IF_VLAN internally. If --vlan is specified, both --vlan and IF_VLAN must be specified together. IF_VLAN may be a VLAN ID number (0 - 4094, inclusive), a network interface name, or none.
If IF_VLAN is specified as a VLAN ID number, the system's VLAN configuration will be checked and the existing VLAN subinterface on IF_WAN with that VLAN ID will be used. For example, given that IF_WAN is eth0, and IF_VLAN was specified as '2', eap_proxy will change the value of IF_VLAN that it uses internally to point to the correct VLAN subinterface for your system. The existing VLAN subinterface on eth0 with VLAN ID 2 could have been named eth0.2, eth0.0002, vlan2, vlan0002, or perhaps even something else.
If IF_VLAN is specified as a network interface name, the system's VLAN configuration will be checked and that network interface will be used if it is an existing VLAN subinterface on IF_WAN. For example, given that IF_WAN is eth0, IF_VLAN was specified as eth0.0, and eth0.0 is actually present on the system, eap_proxy will use eth0.0 as IF_VLAN.
If IF_VLAN is specified as none, eap_proxy will use IF_WAN directly as its internal value for IF_VLAN.
In the case that --vlan is not specified at all, eap_proxy will behave by default as though it were called with --vlan 0. For example, given that IF_WAN is eth0, eap_proxy will change the value of IF_VLAN that it uses internally to point to the VLAN subinterface on eth0 with VLAN ID 0, whether the system's name for it is eth0.0, eth0.0000, vlan0, vlan0000, or something else. However, if no such subinterface exists, this default for IF_VLAN will be treated as specified but invalid.
Finally, in the error case that IF_VLAN is specified but invalid, eap_proxy will behave as though it were called with --vlan none, and use IF_WAN directly.
The addition of --vlan is to accommodate the fact that although the majority of users with routers set to use VLAN ID 0 appear to be able to successfully use eap_proxy with no VLAN at all, some users have routers set to use a nonzero VLAN ID and may still need to use a VLAN with a corresponding nonzero VLAN ID. Configurations for older versions of eap_proxy that assumed the necessity and presence of a VLAN with VLAN ID 0 will continue to be usable with no changes.
Check whether WAN (i.e. IF_VLAN) is up after receiving EAP−Success on IF_WAN (see −−ping−gateway).
If not, restart the system’s DHCP client on IF_VLAN).
Set IF_WAN and IF_VLAN’s MAC (Ethernet) address to the router’s MAC address.
Matching MAC addresses is probably required, but you may prefer to do it manually instead of having eap_proxy do it for you.
Become a daemon. Implies −−syslog.
Record eap_proxy’s process identifier to PIDFILE.
If −−pidfile is given, but PIDFILE is not, PIDFILE will default to /var/run/eap_proxy.pid.
Log messages to syslog instead of to the standard error stream stderr.
Place the IF_WAN and IF_ROUTER interfaces into promiscuous mode instead of multicast mode.
Enable debug-level logging.
Print packets in a hexdump-like format to assist with debugging.
Implies −−debug.
eap_proxy is installed as a daemon. An initscript is placed at /etc/init.d/eap−proxy and a default configuration file at /etc/eap_proxy.conf. The configuration file is not used by the proxy itself. Instead, the proxy is configured when it is launched by the initscript, which parses the configuration file to pass on the proper options.
Note that the package and initscript are named eap−proxy. Everything else is named with an underscore as eap_proxy.
The default configuration file is a standard text file. Each line contains one option or a comment. Lines beginning with # are considered comments and will not be parsed.
The first two options (lines that are not comments) must contain IF_WAN and IF_ROUTER, the device names of the physical network interfaces connected to the WAN uplink and the ISP router. Most users will only need to edit these two lines in the configuration file.
Users who must use a VLAN subinterface of IF_WAN with a nonzero VLAN ID in order to successfully use eap_proxy will also need to specify the VLAN ID or interface name by uncommenting and editing the −−vlan line.
If PIDFILE is specified in addition to −−pidfile, and PIDFILE contains spaces, it must be enclosed in quotes.
If eap_proxy is run as a daemon via the initscript (or by systemd’s systemctl, which itself runs the initscript), −−daemon is implied and its setting in the configuration file is ignored.
See the OPTIONS section for more information about options.
IF_WAN and IF_ROUTER should be physical network interfaces for most users, but more exotic setups in which they are bridges (hopefully with a single port assigned) are now possible. There may also be a VLAN subinterface on IF_WAN that has VLAN ID 0 to match the behavior of most users' routers, but a VLAN is not a requirement to use eap_proxy, with the probable exception of users whose routers are configured to use a nonzero VLAN ID.
For −−restart−dhcp to work, at least IF_WAN (and, if present, also IF_VLAN) should not be be managed by NetworkManager (which uses an internal DHCP client), but in /etc/network/interfaces. IF_WAN (or, if present, IF_VLAN, but not both) should be configured to get its IP via DHCP.
For more information on configuring network interfaces, VLANs, and DHCP, see EXAMPLES and interfaces(5).
These examples are for a system running a typical Debian-based Linux distribution, and should be followed only with consideration for individual circumstances. If everything is configured perfectly, issuing sudo systemctl enable eap-proxy from a command line and restarting the system will fulfill various hopes and dreams.
Firewalling, routing, DNS, IPv6, VPNs, and local DHCP assignments are beyond this document’s scope.
- The network interface to be used as
IF_WANis namedeth0, - the interface to be used as
IF_ROUTERis namedeth1, - a VLAN subinterface named
eth0.0will be created and used asIF_VLAN, and - the MAC address of the ISP router is
DE:AD:8B:AD:F0:0D.
- We would like to disable
NetworkManager(see DisablingNetworkManagerbelow) oneth0andeth1, - change
eth0's MAC address toDE:AD:8B:AD:F0:0D, - create a VLAN (see Creating VLANs below) named
eth0.0on top ofeth0with VLAN ID 0 that gets its IP via DHCP, - and bring
eth0,eth0.0, andeth1up automatically when the system starts.
Place the following lines in /etc/network/interfaces.
allow−hotplug eth0
iface eth0 inet manual
hwaddress de:ad:8b:ad:f0:0d
auto eth0.0
iface eth0.0 inet dhcp
vlan−raw−device eth0
allow−hotplug eth1
iface eth1 inet manual
Now that definitions for the network interfaces are in /etc/network/interfaces, NetworkManager is most likely disabled on them. The MAC address set on eth0 will be inherited by the VLAN subinterface eth0.0.
Some systems will hang for several minutes during boot while eth0.0 tries and fails to get a DHCP assignment. To fix this, either edit the configuration file for your DHCP client so that it uses a sane value for DHCP timeout, and/or (if using systemd) edit /etc/systemd/system/network-online.target.wants to do the same by adding something like TimeoutStartSec=10sec to the [Service] section.
Edit the first two noncommented lines in /etc/eap_proxy.conf, substituting the actual names of your interfaces.
[ ... ]
# Required options
# IF_WAN
eth0
# IF_ROUTER
eth1
[ ... ]Because the VLAN ID of eth0.0 is 0, explicitly configuring it as IF_VLAN is not required.
The surest way to stop using NetworkManager is to uninstall it. It will also will not manage interfaces listed in /etc/network/interfaces, if the following is present (which is likely) in /etc/NetworkManager/NetworkManager.conf:
[main]
plugins=ifupdown,keyfile
[ifupdown]
managed=false
VLAN support is provided by the vlan package.
VLAN autocreation is handled by the /etc/network/if−pre−up.d/vlan script, which normally guesses parameters for the VLAN name type, ID, and raw interface from reading /etc/network/interfaces.
At this point, the interface configuration in /etc/network/interfaces will probably result in a VLAN subinterface on eth0 named eth0.0000.
eap_proxy now supports discovering and using this interface as IF_VLAN based on its VLAN ID of 0, but if the automatic creation of a VLAN subinterface named eth0.0 is desired instead, it is necessary to also edit /etc/network/interfaces to supply the aforementioned parameters explicitly:
case "$IFACE" in
[ ... ]
# for eap_proxy: special case to create eth0.0 properly
eth0.0)
vconfig set_name_type DEV_PLUS_VID_NO_PAD
VLANID=0
IF_VLAN_RAW_DEVICE=eth0
;;
[ ... ]The preferred method of running eap_proxy is through systemd by issuing sudo systemctl start eap-proxy from the command line.
Issue sudo systemctl stop eap-proxy to stop the proxy.
Issue sudo systemctl enable eap-proxy to make the proxy run at every boot.
Directly call the proxy from the command line by issuing eap_proxy [options].
Issue man eap_proxy to read the manual page.
Setting up routing between IF_WAN (or, if used, IF_VLAN) and another network interface is likely the next step, but will be left as an exercise for the reader.
See the CONFIGURATION and EXAMPLES sections for more information.
Default configuration file. See CONFIGURATION and EXAMPLES for more information.
Default initscript. See CONFIGURATION for more information.
Program executable.
The package and initscript are named eap−proxy.
Everything else is named with an underscore as eap_proxy.
An initscript is used instead of a modern systemd .service file to parse /etc/eap_proxy.conf and pass on the correct options to the proxy. (Backward compatibility, too, for what that’s worth.)
Jay Soffian <jaysoffian@gmail.com> (original)
kangtastic <kangscinate@gmail.com> (modifications, documentation, and packaging for Debian)