summarylogtreecommitdiffstats
path: root/README.rst
blob: 1b1b218fd2df38c77606a8b194efafb67e236e19 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
f5vpn for Linux
===============

The F5 VPN client uses the Point-to-Point Protocol to connect to F5Networks BIG-IP APM 13.0.

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:

    .. code-block:: javascript

        snaGetLaunchLink('network_access', dcl.getBins[0].res.reduce((result, bin) => bin.type === 'network_access' ? bin.id : result, {}))['link']

    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):

   .. code-block:: shell

        f5vpn 'f5-vpn://...'

If everything worked, the GUI for F5 VPN should be visible. Assuming continuous Internet connectivity, you should remain connected for several hours.

Known Bugs
----------

If you resize the window, it disconnects. If that happens, you can re-run the ``f5vpn`` command with the same URL as before.

Open Source Alternatives
------------------------

* `zrhoffman/f5vpn-login <https://github.com/zrhoffman/f5vpn-login>`_