summaryrefslogtreecommitdiff
path: root/docs/dev/automating_login.rst
diff options
context:
space:
mode:
authorKali Kaneko <kali@leap.se>2016-04-14 20:25:29 -0400
committerKali Kaneko <kali@leap.se>2016-04-15 11:54:39 -0400
commit32b01d729ea8c0e6ecd1bd1def909fc41156d405 (patch)
tree535994c1955fed826c27cf030dd5091d72e60241 /docs/dev/automating_login.rst
parent249864008ae8640042573bd6dfc42b6ce28324e8 (diff)
[docs] add note about login automation
Diffstat (limited to 'docs/dev/automating_login.rst')
-rw-r--r--docs/dev/automating_login.rst21
1 files changed, 21 insertions, 0 deletions
diff --git a/docs/dev/automating_login.rst b/docs/dev/automating_login.rst
new file mode 100644
index 00000000..7017dd8e
--- /dev/null
+++ b/docs/dev/automating_login.rst
@@ -0,0 +1,21 @@
+.. _automating_login:
+
+Automating login
+================
+
+There's an annoying bug with python keyring module, that makes the 'remember
+login' checkbox non functional.
+
+That, and the need to script end-to-end tests with the client inside a docker
+environment, made us put a mechanism to pass credentials via environment
+variables.
+
+To automate login, set BITMASK_CREDENTIALS env var::
+
+ BITMASK_CREDENTIALS=/tmp/secrets.conf bitmask --debug
+
+where the pointed file looks like this::
+
+ [Credentials]
+ username = user@provider
+ password = mypass