diff --git a/doc/admin-guide-cloud/image/section_glance-property-protection.xml b/doc/admin-guide-cloud/image/section_glance-property-protection.xml index 9d7e1ef378..9a53e9318a 100644 --- a/doc/admin-guide-cloud/image/section_glance-property-protection.xml +++ b/doc/admin-guide-cloud/image/section_glance-property-protection.xml @@ -1,26 +1,33 @@
- Image property protection - There are currently two types of properties in the Image - Service: "core properties," which are defined by the system, and - "additional properties," which are arbitrary key/value pairs that - can be set on an image. - Any such property can be protected - through configuration. When you put protections on a property, it - limits the users who can perform CRUD operations on the property - based on their user role. The use case is to enable the cloud - provider to maintain extra properties on images. Typically this - would be performed by an administrator who has access to protected - properties, managed in the policy.json file. - The extra property could be licensing information or billing information, - for example. - Properties that don't have protections defined for them will - act as they do now: the administrator can control core properties, - with the image owner having control over additional properties. - Property protection can be set in - /etc/glance/property-protections.conf, using - roles found in policy.json. + xmlns:xi="http://www.w3.org/2001/XInclude" + xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" + xml:id="glance-property-protection"> + Image property protection + An image property is a key and value pair that is attached to + OpenStack Image Service image. + Core properties, such as the image name, are defined and set + by the cloud administrator. Additional properties, such as + licensing and billing information, are defined and set by the + cloud administrator and the image owner. + The cloud administrator can configure any property as + protected, + which limits which user roles can perform CRUD operations on that + property. Protected properties are generally extra properties to + which only cloud administrators have access. + For unprotected image properties, the cloud administrator can + manage core properties and the image owner can manage additional + properties. + + To configure property protection + + Define roles in the policy.json + file. + + + Define which roles can manage which properties in the + /etc/glance/property-protections.conf + file. + +