The sample files were being rendered in two separate places. This
commit removes one of them and adjusts the references accordingly.
This commit also removes the sample files from the Operator guide
since they have their own dedicated section under configuration/.
Change-Id: I6da0843e2cb9dc7451d97af661a6cb4873eba671
The self-service password API was left intentionally
unprotected in a change during the stable/ocata cycle:
I4d3421c56642cfdbb25cb33b3aaaacbac4c64dd1
The default policy was not removed from the same config and as a
result it was migrated into code during the policy-in-code work.
This isn't necessary since it's not used to protect anything. Policy
should still be enforced on administrative password resets, but that
is done using the `update_user` API.
Change-Id: I431f5ef9d6d5d689a06736640d22997fbddb869c
Closes-Bug: 1705485
This commit merges two documents that were both attempting to
document integrating keystone with LDAP. Instead, we should have a
single document so that it's easier to operators to understand and
find.
Change-Id: I1b1927b498d93f39d57a03b60384de22f07ad2f2
The specification detailing the great documentation migration
requires a doc/source/cli/ directory be added to the project.
The directory is intended for cli documentation.
This commit add the directory so that we are in compliance with the
specification but doesn't move any content into the directory. It is
instead treated like a placeholder until we can migrate the right
content into the cli guide.
Change-Id: Ida5ffc979d3c596547e9664dce8933d2cf9a4486
Closes-Bug: 1694460
The specification detailing the great documentation migration
requires a doc/source/user/ directory be added to the project.
The directory is intended for end user documentation.
This commit add the directory so that we are in compliance with the
specification but doesn't move any content into the directory. It is
instead treated like a placeholder until we can migrate the right
content into the user guide.
Change-Id: I7d9cde958957bff20c7221f37cb0b03b61aa38f9
Partial-Bug: 1694460
The specification detailing the great documentation migration
requires a doc/source/contributor/ directory for all contributor
documentation. Keystone had a directory specifically for this type
of content but it was in doc/source/devref/.
This commit renames devref/ to contributor/ because the term
`contributor` is more inclusive of other community members that
aren't necessarily developers. The specification also requires this
convention for consistency with other projects.
Change-Id: Id6363213dc6ba6946bd272ca5ee67b4604afc5ac
Partial-Bug: 1694460
The guide uses the Apache HTTP server with mod_wsgi to serve
identity service, but it did not introduce the step to install
Apache2 and libapache2-mod-wsgi package in this guide. The identity
service will not be started without these two packages.
This patch modify the step 1 in part "Install and configure components"
for installing two packages metioned above.
Change-Id: I8ca55e605f806bdc48f753ab893040d9a76aa93d
Closes-Bug: 1707176
Some references to whitelisting and blacklisting was confusing in the
mapping documentation. This commit attempts to clarify the wording
and purpose for both whitelists and blacklists.
Change-Id: I09f4762f03824acc689600c8561fe99ea113ad9a
Closes-Bug: 1693690
Now that the admin-guide lives within keystone, it should be home to
our performance documentation.
Change-Id: I522cf238a977e9cead384fcf993300e7f8c2a395
The operator documentation had a section specific to developing
authentication plugins. This type of documentation is better suited
to the contributor guide. This commit moves it there.
Change-Id: I74337e8b3d8c9031fa3cb7fb709cc41042161bb9
Merged the basic docs, keystone architecture and
external developers related docs to create separate
sections for the three.
Change-Id: I23b4ac709e0040e5580c451f4c7f54dc194a5529
The doc migration spec requires each sub directory
to have an index page which could be directly
referenced in the main openstack documentation under
the topic specific pages, along with other projects.
This patch validates that and adds new files where
they are absent.
Change-Id: I180952857db758482fd767aa9f5cf6343fec9c42
The development environment setup docs were duplicated in two
separate places. This commit remove it from the "Getting Started"
section and into the contributor guide.
Change-Id: If243fd9896be286f9d4c80139eb3cb86600f0052
For a better readability and flow, reorganised and
renamed various sections in developer documentation.
Change-Id: I23ac014701e0ca0984e23ff07192cfdf4d8fd4dd
In a previous change [0] when warning-is-error was
added, the sphinx todo extension was causing errors
with duplicate registration.
However with the recent changes between pbr and
sphinx, this extension no longer throws a duplicate
error when using warning-is-error and we can add
it back in.
[0] https://review.openstack.org/#/c/439674/
Change-Id: Ie28d87dfca8ee5cbea28616b32c471d848c50759
Keystone nows has it's own configuration guide, which means we no
longer need to maintain a separate configuration reference in the
operator guide.
Change-Id: Iadfb90db9f5f23798d57a442e372d35519332a49
As a part of reorganisation of developer docs, removed the
best practices documentation and made the subsections in it
as overall sections. More renaming and reorganisation will
be addressed in the following patches.
Change-Id: I21bf8fe3855fd1d441ec3dba342babc90516714d
The operator documentation had two sections that described
bootstrapping keystone. This is better suited for the admin-guide
and this commit moves it there.
Change-Id: Ibca2bc3e439ca6e26d8e4ead13ed101fd9010f12
Currently there are two subsections named caching layer in
the admin docs. This commit merges the information in the
two and removes the duplicate docs.
Change-Id: I0f8a89c0eccc2ad6078b4d21dae274df3fc9da18
A new policy class was introduced that requires
additional parameters when defining policy objects.
This patch switches our trust policy object to
the policy.DocumentedRuleDefault and fills the
required policy parameters as needed.
Implements: bp policy-docs
Change-Id: I7d4bab14ff257ede59a1b49088e16842e5b59a64
The image migrated as a part of openstack-manuals is
a little pixelated and blurred. This commit replaces
the image with a higher resolution one.
Also a .svg version of this file is updated. The file
is not used as such in the docs but is useful if
someone wants to make changes to the png image, which
can be generated from the .svg file.
Change-Id: I56b863974adb5642f47e7561aa70bc582c85485f
Changes identity:get_identity_providers policy rule to
identity:get_identity_provider to match what is checked by the code.
Change-Id: I0841abd30fd15c034b5836e42a18938634b509b1
Closes-Bug: #1703369
The config files included from openstack manuals refer
to policy.json sample configuration file. Currently policy.yaml
is being used as the sample file in keystone.
To avoid any confusion, this commit replaces instances of
policy.json with policy.yaml.
Change-Id: Ib2d4496fa90639b2ed9b72d1f03354a0c0beffd2
There are auto generated configuration and policy guides which
were earlier manually copied and referenced. Used sphinext
module in oslo_config and oslo_policy to automatically render
those pages.
Change-Id: I2b49eb0083661cce70c5b9457fe5bd32dfe5e5e8