POLICY Class

Each record in the POLICY class defines the information required to deploy and undeploy a policy version. It includes a link to the RULESET objects that contain a list of the selang commands for deploying and undeploying the policy. When the policy is deployed, the deploy selang command is run, which executes all of the commands that define the policy and are stored in the linked RULESET object. When the policy is undeployed, the deploy- selang command is run, which executes all of the commands that refine policy undeployment and are stored in the linked RULESET object.
capamsc141
Each record in the POLICY class defines the information required to deploy and undeploy a policy version. It includes a link to the RULESET objects that contain a list of the selang commands for deploying and undeploying the policy. When the policy is deployed, the deploy selang command is run, which executes all of the commands that define the policy and are stored in the linked RULESET object. When the policy is undeployed, the deploy- selang command is run, which executes all of the commands that refine policy undeployment and are stored in the linked RULESET object.
The key of the POLICY class is the name of the policy followed by the hash symbol (#) and a two-digit version number. For example, mypolicy#13.
The following definitions describe the properties contained in this class record. Most properties are modifiable and can be manipulated using selang or the administration interfaces. Non-modifiable properties are marked
informational
.
  • ACL
    Defines a list of accessors (users and groups) permitted to access the resource, and the accessors' access types.
    Each element in the access control list (ACL) contains the following information:
    • Accessor
      Defines an accessor.
    • Access
      Defines the access authority that the accessor has to the resource.
    Use the access parameter with the authorize or authorize- command to modify the ACL.
  • CATEGORY
    Defines one or more security categories assigned to a user or a resource.
  • COMMENT
    Defines additional information that you want to include in the record. 
    Privileged Access Manager
    does not use this information for authorization.
    Limit:
    255 characters.
  • CREATE_TIME
    (Informational) Displays the date and time when the record was created.
  • DAYTIME
    Defines the day and time restrictions that govern when an accessor can access a resource.
    Use the restrictions parameter with the chres, ch[x]usr, or ch[x]grp commands to modify this property.
    The resolution of daytime restrictions is one minute.
  • EFFECTS_ON
    Defines the list of hosts (HNODE objects) on which this policy is effective (should be deployed).
  • FINALIZE
    Specifies whether this policy version is finalized (can be deployed).
  • GROUPS
    Defines the list of CONTAINER records that a resource record belongs to or the GPOLICY object this policy version belongs to.
    Use the mem+ or mem- parameter with the chres, editres or newres command to modify this property.
  • HNODES
    (Informational). The list of 
    Privileged Access Manager
    nodes which should have this policy deployed.
  • NACL
The
NACL
property of a resource is an access control list that defines the accessors that are denied authorization to a resource, together with the type of access that they are denied (for example, write). See also ACL, CALACL, PACL. Each entry in the NACL contains the following information:
Accessor
Defines an accessor.
  • Access
    Defines the type of access that is denied to the accessor.
Use the authorize deniedaccess command, or the authorize- deniedaccess- command, to modify this property.
NOTIFY
Defines the user to be notified when a resource or user generates an audit event. 
Privileged Access Manager
can email the audit record to the specified user
.
Limit:
30 characters.
OWNER
Defines the user or group that owns the record.
PACL
Defines a list of accessors that are permitted to access the resource when the access request is made by a specific program (or a program that matches a name-pattern) and their access types. Each element in the program access control list (PACL) contains the following information:
  • Accessor
    Defines an accessor.
  • Program
    Defines a reference to a record in the PROGRAM class, either specifically or by wildcard pattern matching.
  • Access
    Defines the access authority that the accessor has to the resource.
You can use wildcard characters to specify the resource in a PACL.
Use the via(
pgm
) parameter with the selang authorize command to add programs, accessors, and their access types to a PACL, You can use the authorize- command to remove accessors from a PACL.
POLICY_BASE_NAME
Defines the name of the GPOLICY object this policy version is a member of.
POLICY_VERSION
Defines the version number of this policy version.
POLICY_TYPE
Defines the policy type. Valid values are:
  • None
  • LoginSpecifies that the policy is a UNAB login policy.
  • ConfigurationSpecifies that the policy is a UNAB configuration policy.
RAUDIT
Defines the types of access events that
Privileged Access Manager
records in the audit log. RAUDIT derives its name from
R
esource
AUDIT
. Valid values are:
  • all
    All access requests.
  • success
    Granted access requests.
  • failure
    Denied access requests (default).
  • none
    No access requests.
Privileged Access Manager
 records events on each attempted access to a resource, and does not record whether the access rules were applied directly to the resource, or were applied to a group or class that had the resource as a member.
Use the audit parameter of the chres and chfile commands to modify the audit mode.
RULESETS
The list of RULESET objects which define the policy.
SECLABEL
Defines the security label of a user or resource.
The SECLABEL property corresponds to the label[-] parameter of the chres and ch[x]usr commands.
SECLEVEL
Defines the security level of an accessor or resource.
Note:
This property corresponds to the level[-] parameter of the ch[x]usr and chres commands.
SIGNATURE
A hash value based on signatures of the RULESET objects associated with the policy.
UACC
Defines the default access authority for the resource, which indicates the access granted to accessors who are not defined to 
Privileged Access Manager
or who do not appear in the ACL of the resource.
Use the defaccess parameter with the chres, editres, or newres command to modify this property.
UPDATE_TIME
(Informational) Displays the date and time when the record was last modified.
UPDATE_WHO
(Informational) Displays the administrator who performed the update.
VARIABLES
(Informational) Displays all versions of the variables in the policy.
WARNING
Specifies whether Warning mode is enabled. When Warning mode is enabled on a resource, all access requests to the resource are granted, and if an access request violates an access rule, a record is written to the audit log.