Browse Source

Add prerequisites section to keystone-to-keystone

Make the keystone-to-keystone section mirror the keystone-as-sp section
by adding a prerequisites section that identifies some useful background
information, and clean up some outdated information.

Partial-bug: #1793374

Change-Id: I39235a394d6bc59aad84e6f6a779d39036199302
tags/15.0.0.0rc1
Colleen Murphy 5 months ago
parent
commit
94b3ba6310
1 changed files with 17 additions and 10 deletions
  1. 17
    10
      doc/source/admin/federation/configure_federation.rst

+ 17
- 10
doc/source/admin/federation/configure_federation.rst View File

@@ -436,22 +436,29 @@ Example
436 436
 Keystone as an Identity Provider (IdP)
437 437
 --------------------------------------
438 438
 
439
-.. NOTE::
439
+Prerequisites
440
+-------------
440 441
 
441
-    This feature is experimental and unsupported in Juno (with several issues
442
-    that will not be backported). These issues have been fixed and this feature
443
-    is considered stable and supported as of the Kilo release.
442
+When keystone is configured as an Identity Provider, it is often referred to as
443
+`Keystone to Keystone`, because it enables federation between multiple OpenStack
444
+clouds using the SAML2.0 protocol.
444 445
 
445
-.. NOTE::
446
+If you are not familiar with the idea of federated identity, see the
447
+`introduction`_ first.
448
+
449
+When setting up `Keystone to Keystone`, it is easiest to `configure a keystone
450
+Service Provider`_ first with a sandbox Identity Provider such as
451
+`samltest.id`_.
446 452
 
447
-    This feature requires installation of the xmlsec1 tool via your
448
-    distribution packaging system (for instance apt or yum)
453
+.. _configure a keystone Service Provider: :ref:`Keystone as a Service Provider (SP)`
454
+.. _samltest.id: https://samltest.id
449 455
 
450
-    Example for apt:
456
+This feature requires installation of the xmlsec1 tool via your distribution
457
+packaging system (for instance apt or yum)
451 458
 
452
-    .. code-block:: console
459
+.. code-block:: console
453 460
 
454
-       # apt-get install xmlsec1
461
+   # apt-get install xmlsec1
455 462
 
456 463
 .. note::
457 464
 

Loading…
Cancel
Save