summaryrefslogtreecommitdiff
path: root/bonafide/README.rst
diff options
context:
space:
mode:
authorKali Kaneko (leap communications) <kali@leap.se>2016-08-29 22:58:18 -0400
committerKali Kaneko (leap communications) <kali@leap.se>2016-08-29 22:58:18 -0400
commit52abf28677a90780505228dbd6bcba54780766b8 (patch)
treee272e268333f8294022670a84e7c6dbfc3fc4021 /bonafide/README.rst
parent4401e9b2e14cba93adb2534ddda94b657caa58e4 (diff)
parent15394a9cefdf6f8ca9cbb6604c6f68425577ae90 (diff)
Merge bonafide repo into unified bitmask repo
Diffstat (limited to 'bonafide/README.rst')
-rw-r--r--bonafide/README.rst27
1 files changed, 27 insertions, 0 deletions
diff --git a/bonafide/README.rst b/bonafide/README.rst
new file mode 100644
index 0000000..7a7b20e
--- /dev/null
+++ b/bonafide/README.rst
@@ -0,0 +1,27 @@
+Bonafide
+========
+Bonafide is the protocol for secure user registration, authentication, and provider discovery for the LEAP
+applications. See the `Bonafide`_ design docs.
+
+This is a client implementation, written in python. It consists of a python library, a
+twisted service and a command-line interface to interact locally with it.
+
+.. _`Bonafide`: https://leap.se/en/docs/design/bonafide
+
+Using
+-----
+
+This is still in development. To play with it, create a virtualenv, and deploy
+the package in development mode by running::
+
+ python setup.py develop
+
+from the parent folder.
+
+To run the bonafide service, you can use the bitmask.core daemon. From an
+environment in which you have installed the bitmask_core repo::
+
+ bitmaskd
+
+Then you can use `bitmask_cli` to see the available actions, under the user
+command.