Grammatical and Format errors - Chapter 35. Case studies: database in OpenStack Security Guide

Bug #1342912 reported by Shellee Aragon
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
openstack-manuals
Fix Released
Medium
Andreas Steil

Bug Description

The paragraph below has multiple grammatical errors, inclusive of awkward wording and improper punctuation:

Alice's private cloud
Alice's organization has high availability concerns, so she has elected to use MySQL for the database. She further places the database on the Management network and uses SSL with mutual authentication among the services to ensure secure access. Given there will be no external access of the database, she uses certificates signed with the organization's self-signed root certificate on the database and its access endpoints. Alice creates separate user accounts for each database user, and configures the database to use both passwords and X.509 certificates for authentication. She elects not to use the nova-conductor sub-service due to the desire for fine-grained access control policies and audit support.

Proposed Revisions:
Alice's organization has high availability concerns, thus she has selected MySQL as the database for the cloud environment. She places the database on the Management network, utilizing SSL with mutual authentication among the services to ensure secure access. Based on the assumption that external access of the database will not be facilitated, she generates self-signed certificates from the organization’s root certificate, installing the certificates on the database and its access endpoints. Alice creates separate user accounts for each database user then configures the database to use both passwords and X.509 certificates for authentication. She elects not to use the nova-conductor sub-service due to the desire for fine-grained access control policies and audit support.

Also on the same page the below sentence has an additional, unnecessary space following the term database with a couple of grammatical and spelling errors:

Bob is concerned about strong separation of his tenants' data, so he has elected to use the Postgres database , known for its stronger security features.

Revision:
Bob is concerned about strong separation of his tenants' data, therefore he has elected to use the PostgreSQL database, known for its stronger security features.

-----------------------------------
Built: 2014-07-16T11:22:53 00:00
git SHA: f3f89b2859c9baae9a0415bf7dab5ef8d20c12a9
URL: http://docs.openstack.org/security-guide/content/case-studies-database.html
source File: file:/home/jenkins/workspace/security-doc-tox-doc-publishdocs/security-guide/ch_case-studies-database.xml
xml:id: case-studies-database

Tags: sec-guide
Bryan D. Payne (bdpayne)
Changed in openstack-manuals:
status: New → Confirmed
importance: Undecided → Low
importance: Low → Medium
Andreas Steil (steil)
Changed in openstack-manuals:
assignee: nobody → Andreas Steil (steil)
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to security-doc (master)

Fix proposed to branch: master
Review: https://review.openstack.org/110865

Changed in openstack-manuals:
status: Confirmed → In Progress
Revision history for this message
OpenStack Infra (hudson-openstack) wrote :

Fix proposed to branch: master
Review: https://review.openstack.org/110873

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Change abandoned on security-doc (master)

Change abandoned by Andreas Steil (<email address hidden>) on branch: master
Review: https://review.openstack.org/110873
Reason: Abandoned because of an undesigned duplication

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to security-doc (master)

Fix proposed to branch: master
Review: https://review.openstack.org/111005

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Change abandoned on security-doc (master)

Change abandoned by Andreas Steil (<email address hidden>) on branch: master
Review: https://review.openstack.org/110865
Reason: Abandoned because of an undesigned duplication
(see https://review.openstack.org/#/c/111005/)

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to security-doc (master)

Fix proposed to branch: master
Review: https://review.openstack.org/111176

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Change abandoned on security-doc (master)

Change abandoned by Andreas Steil (<email address hidden>) on branch: master
Review: https://review.openstack.org/111176
Reason: -> https://review.openstack.org/#/c/111005/

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to security-doc (master)

Fix proposed to branch: master
Review: https://review.openstack.org/111254

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Change abandoned on security-doc (master)

Change abandoned by Andreas Steil (<email address hidden>) on branch: master
Review: https://review.openstack.org/111254

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to security-doc (master)

Fix proposed to branch: master
Review: https://review.openstack.org/111258

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Change abandoned on security-doc (master)

Change abandoned by Andreas Steil (<email address hidden>) on branch: master
Review: https://review.openstack.org/111258

Changed in openstack-manuals:
assignee: Andreas Steil (steil) → Christian Berendt (berendt)
Changed in openstack-manuals:
assignee: Christian Berendt (berendt) → Andreas Steil (steil)
Changed in openstack-manuals:
assignee: Andreas Steil (steil) → Christian Berendt (berendt)
Changed in openstack-manuals:
assignee: Christian Berendt (berendt) → Andreas Steil (steil)
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix merged to security-doc (master)

Reviewed: https://review.openstack.org/111005
Committed: https://git.openstack.org/cgit/openstack/security-doc/commit/?id=2e069e353fa2ee23db363fb6047cc52127647dc4
Submitter: Jenkins
Branch: master

commit 2e069e353fa2ee23db363fb6047cc52127647dc4
Author: Andreas Steil <email address hidden>
Date: Mon Aug 4 11:28:34 2014 +0200

    Fixing some issues in section_case-studies-database.xml

    * improved some wording
    * replaced "SSL" by "SSL/TLS"
    * changed Postgres to PostgreSQL
    * removed "self-signed" while using certificates

    Closes-Bug: #1342912

    Change-Id: I45753743c9a88990b2d087ffbbddea6be6d2ff63

Changed in openstack-manuals:
status: In Progress → Fix Released
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.