Add invalidate doc string to identity plugin

This was simply copied and pasted from the abstract method it overrides.

Change-Id: Ica349e7302434be43e08fc272e8fce5699553d9a
Sync with oslo-incubator fd90c34a9

This syncs python-keystoneclient with oslo-incubator commit hash
fd90c34a914ef98e0c7ccdbf823d9b6d04aa436b

First, remove the existing code to cleanup:
    $ rm -r keystoneclient/openstack/*

Then, sync from oslo-incubator:
    $ python update.py ../python-keystoneclient

Commits since last sync (caed79d):
----------------------------------
de4adbc pep8: fixed multiple violations
e42e77f Restore UUID and human-ID bash completion
250cd88 Fixed a new pep8 error and a small typo
9e88af1 fixed typos found by RETF rules
0d7296f Add kwargs to jsonutils.load(s) functions
822e09b Don't slugify names that don't exist

Change-Id: I33378512593a0cdbc0db0def171b66911aba8708
Document authentication plugins

Explain the plugins that are provided and some information on how to
write new ones. This will obviously need to be expanded as more features
are added.

Change-Id: Ie67e93f2ed994c3702ac66e388cf216609dd44ff
Ensure no double slash in get token URL

Before appending a slash to an URL, we should make sure
that the url doesn't already have one at the end.

Change-Id: Iff864d9b49cf3e3138f602a2c6615ed742f35698
Closes-Bug: 1337880
Add CRUD operations for Federated Protocols.

Add relevant methods for adding, updating, listing, getting, and deleting
Federated Protocol objects.

Change-Id: Ibd8488158619d1689fbdfe21df114433c41c91f8
Implements: blueprint federation-crud-operations
Docstrings for usability.

The keystoneclient docstrings should give guidance for an
application developer to actually use the library. Here's a start.

Partial-Bug: #1330769
Change-Id: I1a9434704d0cd6b58de76933ff78c8d5c0aa3e3b
Provide an __all__ for auth module

Define the public functions for the auth module. To access actual auth
plugins users should still be expected to pull in the right file but
this shows the interface most service will need.

Change-Id: If389c8c0e91166ca46c1766bf5b76ad9d66417b0
Merge "Add invalidate doc string to identity plugin"
Merge "Provide an __all__ for auth module"
Use jsonutils to load adapter response

This is not technically needed, however we and the libraries we use,
aren't very good about keeping our strings and bytes straight for python
3. jsonutils has an attempt to decode stage that means we can let it
manage the correct types.

Change-Id: I2caf4a5b9a04495aa0286f2b6e3193a17ff246e5
Add v2 Token manager authenticate tests

This function is currently completely untested. Create tests to
reinforce behaviour.

Change-Id: I8cfbea37964e3d96cc444ad6f62542786429e44b
Test that tenant list function can use auth_url

Listing tenants can be done on the auth URL because it is often needed
to be performed with an unscoped token. The behaviour is not tested
though so add a test to cover it.

Change-Id: Ic14d54f0f1d8cca2c3a5a6a6da7465c703773aa0
Merge "Add CRUD operations for Federated Protocols."
Merge "Ensure no double slash in get token URL"
Merge "Docstrings for usability."
remove useless part of error message

also did a bit of code cleanup for consistency

Change-Id: I48832c36e1a8b5a0029598dc74aaeaa3b3d2a66f
SAML2 ECP auth plugin

Auth plugin authenticating against remote SAML based Identity Providers.
Upon successful authentication the plugin retrieves and stores unscoped token.
Plugin object should be later used for scoping the token.

Currently only HTTP BasicAuth Method is supported as
an IdP authn method.

Will not work for ADFS, as that has extensions to the document formats
as well as a different workflow.

Change-Id: Ieea40505a406bedf7219fa6f9e6cf29a45ad6e88
Implements: blueprint add-saml2-cli-authentication
Merge "Use jsonutils to load adapter response"
add deprecation warning for auth_token

Change-Id: I1faaae0373a7ae12ee528ab5c71741a2b1122d43
Closes-Bug: 1342274
Merge "SAML2 ECP auth plugin"