Document keystone_authtoken section

It's necessary to document how to configure the keystone_authtoken
section in the ceilometer.conf file so clients can authenticate
against the API server.

Fixes bug: 1177765

Change-Id: I93b45a7e65546246bbf1af795be5887e9a80c1fa
Merge "Document keystone_authtoken section"