From fa7479d1cba758de2eccbd196b8192f01f60b024 Mon Sep 17 00:00:00 2001
From: Itxaka Serrano <itxaka.serrano@virdata.com>
Date: Tue, 21 Jul 2015 14:29:01 +0200
Subject: [PATCH] add keystone backend info to the docs

---
 docs/source/authentication.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/docs/source/authentication.rst b/docs/source/authentication.rst
index ee3a16d120..592bb8ed20 100644
--- a/docs/source/authentication.rst
+++ b/docs/source/authentication.rst
@@ -192,6 +192,30 @@ Example ``auth`` section in the |st2| configuration file. ::
     logging = /path/to/st2auth.logging.conf
     api_url = http://myhost.example.com:9101/
 
+Keystone backend
+~~~~~~~~~~~~~~~~
+
+Keystone backend supports authenticating against a Keystone auth server.
+
+    **Backend configuration options:**
+
+    * ``keystone_url`` - Keystone server url, port included (e.x. "http://keystone.com:5000").
+    * ``keystone_version`` - Keystone api version to use. Defaults to 2.
+
+Example ``auth`` section in the |st2| configuration file. ::
+
+    [auth]
+    mode = standalone
+    backend = keystone
+    backend_kwargs = {"keystone_url": "http://keystone.com:5000", "keystone_version": 2}
+    enable = True
+    debug = True
+    use_ssl = True
+    cert = /path/to/mycert.crt
+    key = /path/to/mycert.key
+    logging = /path/to/st2auth.logging.conf
+    api_url = http://myhost.example.com:9101/
+
 After the configuration change, restart all st2 components. ::
 
     st2ctl restart