Page MenuHomePhabricator

Misleading Help Text for IPSEC Connection Type
Open, NormalPublicBUG


Command completion text is misleading compared to the underlying config generated for IPSec:

set vpn ipsec site-to-site peer x.x.x.x connection-type [tab]
Possible completions:
initiate This endpoint can initiate or respond to a connection
respond This endpoint will only respond to a connection

initiate results in auto=start in /etc/ipsec.conf
respond results in auto=route in /etc/ipsec.conf

The wiki page for this in strongswan states:

auto = ignore | add | route | start
what operation, if any, should be done automatically at IPsec startup. add loads a connection without
starting it. route loads a connection and installs kernel traps. If traffic is detected between
leftsubnet and rightsubnet, a connection is established. start loads a connection and brings
it up immediately. ignore ignores the connection. This is equal to deleting a connection from the config
file. Relevant only locally, other end need not agree on it.

At a minimum, the completion help text needs to be updated to reflect actual behavior.

From a config perspetive, it seems that the /etc/ipsec.conf file should end up with auto=add for "respond".

Adding a new 3rd connection-type of on-demand (or similar) that sets auto=route would then complete the available options in /etc/ipsec.conf

The EdgeOS forums have a thread ( that's reporting the same background info with the same suggestions. I'm copying/documenting it here as I think the config commands should match actual function.


Difficulty level
Easy (less than an hour)
1.1.8 confirmed, others likely
Why the issue appeared?
Will be filled on close
mpoublon created this task.Aug 15 2018, 3:13 AM
mpoublon updated the task description. (Show Details)
mpoublon updated the task description. (Show Details)Aug 15 2018, 3:15 AM
syncer triaged this task as Normal priority.Sep 1 2018, 2:53 PM
syncer edited projects, added VyOS 1.2.x; removed VyOS 1.1.x (1.1.8).
syncer added a subscriber: syncer.

@mpoublon please confirm is same in 1.2
not likely that we going to fix it in 1.1.x

dmbaturin claimed this task.Sep 2 2018, 9:44 PM
dmbaturin edited projects, added VyOS 1.2.x (VyOS 1.2.0-rc1); removed VyOS 1.2.x.
dmbaturin changed Difficulty level from Unknown (require assessment) to Easy (less than an hour).