Extract interface config from SD-WAN edge activation link

Products

• VMware VeloCloud SD-WAN

Issue/Introduction

SD-WAN edge is usually activated by clicking the activation link after connecting a personal computer or mobile device to SD-WAN edge. Interface config is included in the activation link encoded in Base64 format. When activation fails, we can decode the configuration and verify.

Once customer clicks the link, SD-WAN edge decodes it and apply the interface config to reach the SD-WAN orchestrator, below is the decoded output in json format from above configuration code block:

[
    {
        "interface": "GE6",
        "v4Disable": false,
        "proto": "static",
        "ip": "192.168.10.2",
        "gateway": "192.168.10.1",
        "netmask": "255.255.255.0",
        "v6Disable": true
    },
    {
        "interface": "GE5",
        "v4Disable": false,
        "proto": "pppoe",
        "username": "zh013326",
        "password": "test1",
        "v6Disable": true
    },
    {
        "interface": "GE4",
        "v4Disable": false,
        "proto": "static",
        "ip": "169.254.3.34",
        "gateway": "169.254.3.33",
        "netmask": "255.255.255.248",
        "v6Disable": true
    }
]

 

Please note:

1. Only routed interface config is coded into activation link, no matter WAN overlay's enablement. Switched GE interface and L2 switching only interface (LAN) are not included.
2. If interface's addressing type is "DHCP", it is not included into the activation link as default interface addressing type is DHCP.
3. Sub interface and secondary IP are not included in the activation link. For customer using SIF or SIP to access Internet, use other interface to activate the SD-WAN edge.
4. If customer wants to use a temporary IP to activate the SD-WAN edge, for example, activate it in the partner's depot and ship it to end customer's site, just remove the configuration code block and config the IP address manually in the SD-WAN edge local UI.

Environment

All supported VMware VeloCloud SD-WAN edge versions

Resolution

• Decode Base64 via Linux command line or MAC OS Terminal:

echo 'YOUR_BASE64_ENCODED_DATA' | base64 --decode

• Decode Base64 via Windows PowerShell:

[Convert]::FromBase64String("YOUR_BASE64_ENCODED_DATA") | Out-File -Encoding UTF8 "output.txt"

• Decode Base64 via third-party website such as https://www.base64decode.org, as interface config may contain public IP address, this is NOT best practice.