From dd7c63bd9ca5570d9a924d131c4786ffd15e2d2d Mon Sep 17 00:00:00 2001
From: "Kali Kaneko (leap communications)" <kali@leap.se>
Date: Mon, 6 Feb 2017 15:53:26 +0100
Subject: [docs] document the API/cli

---
 src/leap/bitmask/vpn/README.rst | 52 +++++++++++++++++++++++++++++++++++++++++
 src/leap/bitmask/vpn/service.py |  2 +-
 2 files changed, 53 insertions(+), 1 deletion(-)
 create mode 100644 src/leap/bitmask/vpn/README.rst

(limited to 'src/leap/bitmask/vpn')

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):
-- 
cgit v1.2.3