Added support for automatically disconnecting from a tunnel when connected to a specified Wi-Fi network.

[asivery]

Added support for automatically disconnecting from a tunnel when connected to a specified Wi-Fi network.

How does this work for users?

Now when editing a tunnel, there's a field in which the user can enter the names of networks, connecting to which will cause this tunnel to be disconnected.
There's also a checkbox that will enable or disable this functionality for this particular tunnel.

What changes were made to previous components to support this?

1. In tunnel: Two new config fields were added:
   • enableAutoDisconnect (boolean) - whether or not the feature is enabled
   • autoDisconnectNetworks (string) - the comma separated list of SSIDs
     These values are stored in the WgQuick config as comments following the scheme ADD;key;value:

   #ADD;wifi_auto_disconnect;<1 or 0 - enabled or disabled>
   #ADD;wifi_auto_disconnect_networks;<networks>
   

2. In ui:
   • Added the libs.androidx.work.runtime.ktx library for Job Scheduling
   • ConfigProxy was reworked to add the two aforementioned config fields
   • tunnel_detail_fragment and tunnel_editor_fragment now have separate sections for this feature
   • Added the required permissions in Android Manifest (Location permissions are needed in order to get the SSID of currently active Wi-Fi connection)
   • TunnelManager now contains the code for the worker which detaches and (re)attaches a new NetworkCallback every 15 minutes, so that android doesn't kill it. The worker is started and stopped depending on whether or not a tunnel with the feature enabled is active. If the last tunnel which uses this feature is DOWNed, the worker will be cancelled. If there are no tunnels which use this feature, the worker will not be started.
   • TunnelEditorFragment now contains the code for checking the location permission, needed for requesting the SSID. If the user refuses to grant the permission, the feature will be disabled.

Limitations and possible points for future improvement

• The way this feature stores data in the tunnel config files could be improved - I am storing them as specially formatted comments, so that there will be no conflicts with any other software that might use WgQuick-formatted tunnel config files.

Why was this added?

If NAT hairpinning doesn't work correctly in a Wi-Fi network, and there is a tunnel to that same network open, all packets will go through Wireguard, and eventually get dropped. With this feature active, the Wireguard app will terminate the tunnel once the user connects to that network, and, as a result, the user will still have an internet connection.
This is already a feature in the iOS app, but there it has more features (it can f.ex. auto-connect to a tunnel when connected to a certain network).

[msfjarvis]

Can you add a use case for this in the PR description? You've explained how and what but not why, which is a necessity for something this big.

Was this feature discussed somewhere prior to implementation? I can't seem to find anything on the mailing list.

[asivery]

@msfjarvis I've added an explanation. I didn't discuss this feature on any mailing list, because I wasn't aware there was a mailing list. If needed, I can close this PR here, and first discuss it on the mailing list.

[Svenum]

I am waiting for this for a year now. Nice work. If this works then only the automatic connecting to the tunnel if you disconnect from the SSID is missing.

[da-anda]

@msfjarvis if you search the web on how to automatically disable WireGuard on local wifi, you will get a ton of hits where people are looking for exactly this feature.
I am also looking for this for ages, because the VPN causes random issues when I am in the local wifi network. There certainly might be ways to fix this via a special router config as my FritzBox is supposed to support DNS rebind protection (which is hairpinning I suppose?) - but not everybody understands this stuff (me neither). Such a toggle however is as easy and userfriendly as it can get.

[m-klecka]

Will this ever get implemented? I'd like to automatically disconnect from my home VPN, when I'm at home.. And not rely on third party apps to do that.

[bmoore]

@msfjarvis and @zx2c4 Can we get this reviewed and merged? So many people would love this feature, and are looking toward other apps to solve it. I've experienced this with iphones and it's a dream.

[heikojansen]

I'd really love to see this merged BUT I wonder if the opposite functionality - reconnecting the VPN tunnel once the device leaves the configured networks - is also available?
Otherwise I might not notice that I lost VPN protection and would have had to manually reactivate it prior to sending sensitive data over untrustworthy networks ...

[tom-jm69]

Hey, what's the state of this?
I really want this to be merged, because when coming home, the VPN connection is still active :)

[advert665]

I just want to add support for this. The iOS client has it, the android one should too. It's so useful to just disconnect automatically when home and then reconnect when I leave.

[bmoore]

For folks who are waiting, I've since uninstalled this app and use WG Tunnel as it has this feature. Until this pr gets merged, you can too.

https://play.google.com/store/apps/details?id=com.zaneschepke.wireguardautotunnel

[Svenum]

Thanks for the Tipp. I looked at the app and now I am awitching to it permanently too. It is much better and had more features than I need. 👍

[ktmaul]

@msfjarvis I'm curious what's needed to get this integrated into the app? This feature is already present in the iOS and MacOS versions, and there's plenty of easily discovered discussion out there on why users would want this feature.