[docs] document the API/cli

2 files changed, 53 insertions, 1 deletions

diff --git a/src/leap/bitmask/vpn/README.rst b/src/leap/bitmask/vpn/README.rst
new file mode 100644
index 0000000..f08d7ab
--- /dev/null
+++ b/src/leap/bitmask/vpn/README.rst
@@ -0,0 +1,52 @@
+VPN port
+--------
+What's here is a quick port of the legacy bitmask_client vpn code.
+It only work through the cli right now::
+
+  bitmaskctl user create tmp_user_baz002@demo.bitmask.net --pass 1234
+  signup    ok
+  user      tmp_user_baz002
+
+  bitmaskctl user auth tmp_user_baz002@demo.bitmask.net --pass 1234
+  srp_token iye7s1J7M3_iCdB4gXEAhxs-if3XOCwpKNPnvTC8ycE
+  uuid      b63ac83826c7e1e903ed18f6f7780491
+
+  bitmaskctl eip get_cert demo.bitmask.net
+  get_cert  ok
+
+  bitmaskctl eip check
+  eip_ready ok
+
+
+You also might want to install the helpers (a pop-up should appear, asking for
+authentication)::
+
+  bitmaskctl eip install
+  install   ok
+
+And finally you should be able to launch the VPN::
+
+  bitmaskctl eip start demo.bitmask.net
+  start     ok
+  result    started
+
+  bitmaskctl eip status
+  firewall  ON
+  EIP       AUTH
+
+  bitmaskctl eip status
+  firewall  ON
+  EIP       CONNECTED
+  ↑↑↑       11.3 K
+  ↓↓↓       3.9 K
+
+
+Feedback needed
+---------------
+Much of what's exposed in the above API should be made transparently (download
+certificate). However, I prefer to test it manually before hiding it from the
+CLI.
+
+The UI integration should follow soon.
+
+Meanwhile, please report any bugs you find with its expected behavior.
diff --git a/src/leap/bitmask/vpn/service.py b/src/leap/bitmask/vpn/service.py
index 170c5af..bbde104 100644
--- a/src/leap/bitmask/vpn/service.py
+++ b/src/leap/bitmask/vpn/service.py
@@ -104,7 +104,7 @@ class EIPService(HookableService):
             os.makedirs(cert_dir, mode=0700)
         with open(cert_path, 'w') as outf:
             outf.write(cert_str)
-        heck_and_fix_urw_only(cert_path)
+        check_and_fix_urw_only(cert_path)
         defer.returnValue({'get_cert': 'ok'})
 
     def do_install(self):