Restructure federation guide

Having everything on a single page is nice for ctrl-F-ability but it
makes the flow very confusing. This change breaks the guide into three
logical parts: the introduction, the configuration steps, and the
advanced mapping rules guide. Keeping all the configuration steps within
one page means it can still be searched easily, but removing the prose
of the introduction and breaking out the deep-dive mapping rules guide
reduces clutter and enhances readability.

Partial-bug: #1793374

Change-Id: Id2fd59d62a2675691d545e4cd0404558f00cf481
This commit is contained in:
Colleen Murphy 2018-12-09 23:16:49 +01:00
parent 733d170e5b
commit 131acaccaf
6 changed files with 19 additions and 20 deletions

View File

@ -538,3 +538,9 @@ scoped token from the SP.
--os-remote-project-name federated_project \
--os-remote-project-domain-name federated_domain \
token issue
.. include:: openidc.rst
.. include:: mellon.rst
.. include:: shibboleth.rst
.. include:: websso.rst

View File

@ -2,12 +2,9 @@
Federated Identity
==================
Keystone's one-stop-shop for all federated identity documentation.
.. toctree::
:maxdepth: 2
.. include:: introduction.rst
.. include:: configure_federation.rst
.. include:: mapping_combinations.rst
.. include:: openidc.rst
.. include:: mellon.rst
.. include:: shibboleth.rst
.. include:: websso.rst
introduction.rst
configure_federation.rst
mapping_combinations.rst

View File

@ -11,10 +11,10 @@
License for the specific language governing permissions and limitations
under the License.
------------
Setup Mellon
============
------------
------------------------------------------
Configure Apache HTTPD for mod_auth_mellon
------------------------------------------
@ -73,7 +73,6 @@ Enable the ``auth_mellon`` module, for example:
$ a2enmod auth_mellon
----------------------------------
Configuring the Mellon SP Metadata
----------------------------------

View File

@ -11,10 +11,10 @@
License for the specific language governing permissions and limitations
under the License.
--------------------
Setup OpenID Connect
====================
--------------------
----------------------------
Configuring mod_auth_openidc
----------------------------
@ -79,7 +79,6 @@ Once you are done, restart your Apache daemon:
$ sudo service apache2 restart
----
Tips
----

View File

@ -11,10 +11,10 @@
License for the specific language governing permissions and limitations
under the License.
----------------
Setup Shibboleth
================
----------------
-----------------------------------------
Configure Apache HTTPD for mod_shibboleth
-----------------------------------------
@ -78,7 +78,6 @@ Restart Apache, for example:
$ service apache2 restart
---------------------------
Configuring shibboleth2.xml
---------------------------

View File

@ -11,10 +11,10 @@
License for the specific language governing permissions and limitations
under the License.
------------------------------
Setup Web Single Sign-On (SSO)
==============================
------------------------------
----------------
Keystone Changes
----------------
@ -171,7 +171,6 @@ Alternatively, a generic option may be set at the `[federation]` level.
<https://git.openstack.org/cgit/openstack/keystone/plain/etc/sso_callback_template.html>`__
template into the location specified by `[federation]/sso_callback_template`.
---------------
Horizon Changes
---------------