diff options
Diffstat (limited to 'README.rst')
-rw-r--r-- | README.rst | 38 |
1 files changed, 28 insertions, 10 deletions
diff --git a/README.rst b/README.rst index 1b1b218fd2df..e74a21f329ad 100644 --- a/README.rst +++ b/README.rst @@ -8,13 +8,19 @@ Usage 1. In a web browser, go to `<https://[your-BIG-IP-APM-server]/>`_ and log in (including 2-factor authentication, if you use it). -2. Open Developer Tools and run this JavaScript: +2. Choose Web Network Access. If this works for you, the following steps do not apply to you. + If you prefer connecting from the command line, open Developer Tools and run this JavaScript: - .. code-block:: javascript + .. code-block:: javascript - snaGetLaunchLink('network_access', dcl.getBins[0].res.reduce((result, bin) => bin.type === 'network_access' ? bin.id : result, {}))['link'] + resourceType = "network_access"; + with (new XMLHttpRequest()) { + open("GET", `https://${location.host}:${location.port}/vdesk/resource_list.xml?resourcetype=res`); + onload = () => console.log(`f5-vpn://${location.host}:${location.port || 443}/?server=${location.host}&resourcename=${responseXML.querySelector(`list[type=${resourceType}] entry`).textContent}&resourcetype=${resourceType}&cmd=launch&protocol=https&port=${location.port || 443}&sid=${document.cookie.match(/MRHSession=(.*?); /)[1]}`); + send(); + } - You should have received a URL starting with ``f5-vpn://``. + You should have received a URL starting with ``f5-vpn://``. 3. In a terminal, run ``f5vpn`` using the URL from Step 2 as its argument (including single quotes): @@ -24,12 +30,24 @@ Usage If everything worked, the GUI for F5 VPN should be visible. Assuming continuous Internet connectivity, you should remain connected for several hours. -Known Bugs ----------- +Troubleshooting +--------------- -If you resize the window, it disconnects. If that happens, you can re-run the ``f5vpn`` command with the same URL as before. +If you get an error that looks like -Open Source Alternatives ------------------------- + .. code-block:: shell + + f5vpn: error while loading shared libraries: libicuuc.so.72: cannot open shared object file: No such file or directory + +that means that your version of `qt5-webkit <https://aur.archlinux.org/packages/qt5-webkit>`_ is out-of-date with your `icu <https://archlinux.org/packages/core/x86_64/icu/>`_ version, and rebuilding the latest version of `qt5-webkit <https://aur.archlinux.org/packages/qt5-webkit>`_ (or installing the latest prebuilt package) will fix your issue. + +CLI-Only Alternatives +--------------------- + +* `kayrus/gof5 <https://github.com/kayrus/gof5>`_ - FOSS + +* `zrhoffman/svpn-login <https://github.com/zrhoffman/svpn-login>`_ + +* `zrhoffman/f5vpn-login <https://github.com/zrhoffman/f5vpn-login>`_ - FOSS, but very slow due to no PPP-over-DTLS -* `zrhoffman/f5vpn-login <https://github.com/zrhoffman/f5vpn-login>`_ +* `openvpn <https://www.infradead.org/openconnect/f5.html>`_ - FOSS (use --cookie-on-stdin for 2FA) |