openstack/openstack-manuals
Code Issues Proposed changes

Merge "Included new section to 'Create and manage roles' in Admin User Guide"

Browse Source
This commit is contained in:
Jenkins
2014-03-25 07:36:11 +00:00
committed by Gerrit Code Review
parent eb839b6f2a 429af4ba8d
commit f94404b40a
2 changed files with 102 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
doc/user-guide-admin/ch_dashboard.xml
View File

@@ -19,8 +19,9 @@
Guide</citetitle></link>.</para>
<xi:include href="../common/section_dashboard_access.xml"/>
<?hard-pagebreak?>
<xi:include
href="section_dashboard_admin_manage_projects_users.xml"/>
<xi:include href="section_dashboard_admin_manage_projects_users.xml"/>
<?hard-pagebreak?>
<xi:include href="section_dashboard_admin_manage_roles.xml"/>
<?hard-pagebreak?>
<xi:include href="section_dashboard_admin_manage_instances.xml"/>
<?hard-pagebreak?>

99
doc/user-guide-admin/section_dashboard_admin_manage_roles.xml Normal file
View File

@@ -0,0 +1,99 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section [
<!-- Some useful entities bortred from HTML -->
<!ENTITY ndash "&#x2013;">
<!ENTITY mdash "&#x2014;">
<!ENTITY hellip "&#x2026;">
<!ENTITY plusmn "&#xB1;">
]>
<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:svg="http://www.w3.org/2000/svg"
xmlns:html="http://www.w3.org/1999/xhtml" version="5.0"
xml:id="section_dashboard_admin_manage_roles">
<?dbhtml stop-chunking?>
<title>Create and manage roles</title>
<para>A role is a personality that a user assumes to perform a specific set
of operations. A role includes a set of rights and privileges. A user
assuming that role inherits those rights and privileges.</para>
<note>
<para>OpenStack Identity service defines a user's role on a project but it
is completely up to the individual service to define what that role means.
This is referred to as the service's policy. To get details about what the
privileges for each role are, refer to the <filename>policy.json</filename>
file available for each service in the
<filename>/etc/<replaceable>SERVICE</replaceable>/policy.json</filename>
file. For example, the policy defined for OpenStack Identity service is
defined in the <filename>/etc/keystone/policy.json</filename> file.
</para>
</note>
<section xml:id="create_role">
<title>Create a role</title>
<procedure>
<step>
<para>Log in to the dashboard and choose the <guilabel>admin</guilabel>
project from the <guilabel>CURRENT PROJECT</guilabel> drop-down list.
</para>
</step>
<step>
<para>On the <guilabel>Admin</guilabel> tab, click the <guilabel>Roles
</guilabel> category.
</para>
</step>
<step>
<para>Click the <guibutton>Create Role</guibutton> button.</para>
<para>In the <guilabel>Create Role</guilabel> window, enter a
name for the role.</para>
</step>
<step>
<para>Click the <guibutton>Create Role</guibutton> button to confirm
your changes.</para>
</step>
</procedure>
</section>
<section xml:id="edit_role">
<title>Edit a role</title>
<procedure>
<step>
<para>Log in to the dashboard and choose the <guilabel>admin</guilabel>
project from the <guilabel>CURRENT PROJECT</guilabel> drop-down list.
</para>
</step>
<step>
<para>On the <guilabel>Admin</guilabel> tab, click the <guilabel>Roles
</guilabel> category.
</para>
</step>
<step>
<para>Click the <guibutton>Edit</guibutton> button.</para>
<para>In the <guilabel>Update Role</guilabel> window, enter a new
name for the role.</para>
</step>
<step>
<para>Click the <guibutton>Update Role</guibutton> button to confirm
your changes.
</para>
</step>
</procedure>
<note>
<para>Using the dashboard, you can edit only the name assigned to a role.</para>
</note>
</section>
<section xml:id="delete_role">
<title>Delete a role</title>
<procedure>
<step>
<para>Log in to the dashboard and choose the <guilabel>admin</guilabel>
project from the <guilabel>CURRENT PROJECT</guilabel> drop-down list.
</para>
</step>
<step>
<para>On the <guilabel>Admin</guilabel> tab, click the <guilabel>Roles
</guilabel> category.</para>
</step>
<step>
<para>Select the role you want to delete and click the <guibutton>Delete
Roles</guibutton> button.</para>
</step>
</procedure>
</section>
</section>