Add documentation for customising authentication

[lloydmeta]

Currently the main documentation site doesn't have a section talking about how to customise authentication. It should be addressed by adding such a section.

Might make sense to do this after the upgrade to 2.4 since that mechanism is going to change completely.

[heat]

:+1: Nice feature. It make sense keep auth in octoparts avoiding every services auth the request.