Update direct mapping syntax for mapping examples

One of the mapping examples that shows how direct mapping is
performed was using the old syntax. Before switching to the {0},
{1}, etc. convention.

Change-Id: If514167e6fe0c5ff9d299ae21c8384e38d0cb592
Add information on how to request tokens for federated users

Add information describing the authentication process required
to retrieve an unscoped and scoped token, as a federated user.

Change-Id: I9abffcd3f3e5a886bf5e7e184faed6aa7bd5c684
blueprint: saml-id
Update local examples to arrays in federation docs

The federation docs did not have local as a json array.
I've updated the examples and some other spots in the documentation.

Change-Id: Icc1d70de0080cb877d1839a0085d12efd4fd7450
Merge "Update direct mapping syntax for mapping examples"
Merge "Add information on how to request tokens for federated users"
Merge "Update local examples to arrays in federation docs"