www.auth implementation

This implements the authentication part of the problem, and a nice
avatar interface, which can deliver corporates photos, as well as gravatar

Everything is integrated when possible with twisted.web.guard,
which is probably the less user friendly API I have ever seen.
comment addressing + auth.py unit tests

Signed-off-by: Pierre Tardy <pierre.tardy@intel.com>
ldap tests

Signed-off-by: Pierre Tardy <pierre.tardy@intel.com>
tests for oauth + fix for remaining tests

Signed-off-by: Pierre Tardy <pierre.tardy@intel.com>
User documentation

Signed-off-by: Pierre Tardy <pierre.tardy@intel.com>
fix integration test
remaining tests and docs
fix remaining review comment
lates pep8/ pylint fixes, and add in the manual you need to install sanction for oauth2
IConfigured: add a standardized way to access the configuration as dictionaries


Signed-off-by: Pierre Tardy <pierre.tardy@intel.com>
address review comments

Signed-off-by: Pierre Tardy <pierre.tardy@intel.com>
more documentation on use cases
some more review comment addressing:

refactor documentation
s/userInfos/userInfoProvider/
remove spurious ')'
Move ConfiguredMixin and adapters to a sub-module

Keeping this in buildbot.util was causing problems with re-importing
util in multiprocessing, and anyway was cluttering __init__.py.
s/user_infos/user_info/g

Plus fix docs so they build

+autopep8
use class names as auth names, rather than inventing variations
move SessionConfigResource to its own module, since it's not auth-related
reorg docs to break out auth classes, auth docs, and avatars.
edit auth.rst

This includes a more explicit description of the HTTP transactions, but
is otherwise pretty much the same content.