Federated documentations lacks a concise introduction
Affects | Status | Importance | Assigned to | Milestone | |
---|---|---|---|---|---|
OpenStack Identity (keystone) |
Fix Released
|
Low
|
Colleen Murphy |
Bug Description
The documentation for federated identity [1] doesn't clearly describe what the purpose of federated identity is or why someone would want to use it.
This was apparent during the Stein PTG in Denver [0] when working with a set of people with fresh perspectives. Most regular keystone contributors have such an in-depth understanding of identity federation that it makes us gloss over some things that might be confusing to new-comers.
This bug is to track reworking the federated identity documentation to include a clear and concise introduction that helps people understand the purpose of federation before leading them into technical details.
The introduction should try and describe the following:
What is identity federation?
Why is it useful?
What is SAML?
What protocols can be used?
What are the benefits of using different protocols, if any?
[0] https:/
[1] https:/
Changed in keystone: | |
importance: | Undecided → Low |
status: | New → Triaged |
tags: | added: documentation |
tags: | added: federation |
description: | updated |
Changed in keystone: | |
assignee: | nobody → Colleen Murphy (krinkle) |
description: | updated |
Changed in keystone: | |
milestone: | none → stein-2 |
Reviewed: https:/ /review. openstack. org/613408 /git.openstack. org/cgit/ openstack/ keystone/ commit/ ?id=914885fefda 269e27d815c52f8 134e206222259c
Committed: https:/
Submitter: Zuul
Branch: master
commit 914885fefda269e 27d815c52f8134e 206222259c
Author: Colleen Murphy <email address hidden>
Date: Thu Oct 25 21:58:34 2018 +0200
Delete administrator federation guide
The federated-identity guide in the admin section is out of date
relative to the one in the operator section. It is sort of incoherent
and the information within it that is valuable is already present in the
other guide. Delete this guide in favor of just promoting the operator
guide.
Related-bug: #1793374
Change-Id: I8c0190725d0f72 97957bbf10fd9d7 184e52ff5f3