From: Zac Dover Date: Fri, 8 Dec 2023 19:45:43 +0000 (+0100) Subject: doc/radosgw: edit front matter - role.rst X-Git-Tag: v19.1.0~690^2 X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=9d10361961e01c4d60f600f6e7ed106d6203e554;p=ceph.git doc/radosgw: edit front matter - role.rst Clarify the front matter in doc/radosgw/role.rst. Co-authored-by: Anthony D'Atri Signed-off-by: Zac Dover --- diff --git a/doc/radosgw/role.rst b/doc/radosgw/role.rst index 3ef78d8d209cf..029d8b778d63a 100644 --- a/doc/radosgw/role.rst +++ b/doc/radosgw/role.rst @@ -2,9 +2,15 @@ Role ====== -A role is similar to a user and has permission policies attached to it, that determine what a role can or can not do. A role can be assumed by any identity that needs it. If a user assumes a role, a set of dynamically created temporary credentials are returned to the user. A role can be used to delegate access to users, applications, services that do not have permissions to access some s3 resources. - -The following radosgw-admin commands can be used to create/ delete/ update a role and permissions associated with a role. +A role is similar to a user. It has permission policies attached to it that +determine what it can do and what it cannot do. A role can be assumed by any +identity that needs it. When a user assumes a role, a set of +dynamically-created temporary credentials are provided to the user. A role can +be used to delegate access to users, to applications, and to services that do +not have permissions to access certain S3 resources. + +The following ``radosgw-admin`` commands can be used to create or delete or +update a role and the permissions associated with it. Create a Role -------------