summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorAdam Young <ayoung@redhat.com>2013-03-18 15:22:31 -0400
committerAdam Young <ayoung@redhat.com>2013-04-24 15:20:15 -0400
commit23634d780cd61a45e303171955cd42f29e53669f (patch)
tree540ef79d30a6b324f09e9a96e61945f79bf7f34b /doc
parenteefc8e047392c80388391a5d1ae815e93df10849 (diff)
downloadkeystone-23634d780cd61a45e303171955cd42f29e53669f.tar.gz
keystone-23634d780cd61a45e303171955cd42f29e53669f.tar.xz
keystone-23634d780cd61a45e303171955cd42f29e53669f.zip
HACKING LDAP
A short blurb indicating how to do development for LDAP Change-Id: Id75d9f9af8742b44158ed739d34dbdccb62eccf2
Diffstat (limited to 'doc')
-rw-r--r--doc/source/developing.rst16
1 files changed, 16 insertions, 0 deletions
diff --git a/doc/source/developing.rst b/doc/source/developing.rst
index e1cb5767..f04f5e61 100644
--- a/doc/source/developing.rst
+++ b/doc/source/developing.rst
@@ -170,6 +170,22 @@ You may also be interested in either the
.. _OpenStack Continuous Integration Project: https://github.com/openstack/openstack-ci
.. _OpenStack Integration Testing Project: https://github.com/openstack/tempest
+
+LDAP
+----
+LDAP has a fake backend that performs rudimentary operations. If you
+are building more significant LDAP functionality, you should test against
+a live LDAP server. Devstack has an option to set up a directory server for
+Keystone to use. Add ldap to the ``ENABLED_SERVICES`` environment variable,
+and set environment variables ``KEYSTONE_IDENTITY_BACKEND=ldap`` and
+``KEYSTONE_CLEAR_LDAP=yes`` in your ``localrc`` file.
+
+The unit tests can be run against a live server with
+``tests/_ldap_livetest.py``. The default password is ``test`` but if you have
+installed devstack with a different LDAP password, modify the file
+``tests/backend_liveldap.conf`` to reflect your password.
+
+
Building the Documentation
==========================