Add dedicated URL for federated authentication.

Describe new URL for federated authentication
``/v3/OS-FEDERATION/identity_providers/{identity_provider}/
protocols/{protocol}/auth``  and available HTTP methods.

Change-Id: Ic25e726c9c146050575b68c29ed3c6c8dab27016
Closes-Bug: #1296348