diff options
Diffstat (limited to 'README.rst')
-rw-r--r-- | README.rst | 25 |
1 files changed, 18 insertions, 7 deletions
diff --git a/README.rst b/README.rst index a0a09b0c804a..e74a21f329ad 100644 --- a/README.rst +++ b/README.rst @@ -9,16 +9,14 @@ 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. Choose Web Network Access. If this works for you, the following steps do not apply to you. - If you prefer connecting in the command line, open Developer Tools and run this JavaScript: + If you prefer connecting from the command line, open Developer Tools and run this JavaScript: .. code-block:: javascript - xhr = new XMLHttpRequest(); resourceType = "network_access"; - with (xhr) { - responseType = "document"; + 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}/?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]}`); + 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(); } @@ -32,11 +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. +Troubleshooting +--------------- + +If you get an error that looks like + + .. 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) +* `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, very slow) +* `zrhoffman/f5vpn-login <https://github.com/zrhoffman/f5vpn-login>`_ - FOSS, but very slow due to no PPP-over-DTLS + +* `openvpn <https://www.infradead.org/openconnect/f5.html>`_ - FOSS (use --cookie-on-stdin for 2FA) |