#execute-command #automation #linux-networking #networking

app network-manager-connection-action

Execute commands on connections change using DBus network manager events

5 stable releases

1.3.1 Jul 26, 2023
1.3.0 Jun 25, 2022
1.2.1 Jan 14, 2022
1.2.0 Sep 16, 2021
1.1.0 Sep 16, 2021

#416 in Unix APIs

BSD-2-Clause

18KB
281 lines

network-manager-connection-action Crates.io

Listen connections/deconnections using network-manager's dbus interface and execute specified commands without the need of root access

Use case

One possible use case is adding automatic ssh canonicalization for company domains when connecting to company VPN, this usage can be found in example directory.

Example run

Output when configured to run with canonicalization on a vpn connection and connecting/disconnecting from NetworkManager:

<user>$ network-manager-connection-action -c example/config.toml
[2021-05-02T13:51:45Z INFO] Watching for NetworkManager events
[2021-05-02T13:53:41Z INFO] Entreprise VPN Up
CanonicalDomains public.entreprise.com internal.entreprise.com anotherdomains.fromvpn
[2021-05-02T13:56:21Z INFO] Entreprise VPN Down
CanonicalDomains public.entreprise.com

Build and Install

cargo build --release
cp target/release/network-manager-connection-action /usr/bin/network-manager-connection-action

Config

You need the UUID of networks you want to watch

You can find connections's UUID using nmcli c

Create a config file, example $HOME/.config/network_manager_connection_actionrc

Config contains network manager uuid that correspond to an existing connection.

For each connection's config you can choose a command and a context, see examples

Systemd autostart

Put the unit file here

$HOME/.config/systemd/user/network-manager-connection-action.service

Run and enable

systemctl --user daemon-reload
systemctl --user start network-manager-connection-action.service
systemctl --user enable network-manager-connection-action.service
journalctl --user -fu network-manager-connection-action.service

Future

Use systemd varlink interface

At start the program could query already connected connections and apply configuration

The code and functionality could be improved in many ways, don't hesitate to open merge requests :)

Dependencies

~13–23MB
~333K SLoC