HNODE Class

The HNODE class contains information about the organization's  hosts. Each record in the class represents a node in the enterprise.
capamsc141
The HNODE class contains information about the organization's 
PAM Server Control
hosts. Each record in the class represents a node in the enterprise.
This class is used to manage the information uploaded from the various PMDBs and endpoints and stored on the DMS.
The key of the HNODE class record is the actual host name for an endpoint (for example, myHost.ca.com) or the PMDB name for a Policy Model node (for example, [email protected]).
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.
  • ATTRIBUTES
    Defines the custom criteria that the DMS uses to assess if the host is automatically added to a host group.
    The DMS also examines the following HNODE properties to assess if a host should be automatically added to a host group: COMMENT, HNODE_INFO, HNODE_IP, HNODE_VERSION, NODE_TYPE
  • 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. 
    PAM Server Control
    does not use this information for authorization.
    Limit:
    255 characters.
  • COMPLIANT_UPDATE_TIME
    (Informational) Displays the date when and time when the status was last changed.
  • 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.
  • EFFECTIVE_POLICIES
    Defines the list of policy versions that should be deployed on this object.
    Display name: Effective Policies
  • GHNODES
    Defines the list of host groups this object is a member of.
    Display name: node groups
  • GROUPS
    Defines the list of CONTAINER records that a resource record belongs to.
    To modify this property in a class record, change the MEMBERS property in the appropriate CONTAINER record.
    Use the mem+ or mem- parameter with the chres, editres or newres command to modify this property.
  • HNODE_IP
    The IP address of the host.
    Display name: IP
  • HNODE_KEEP_ALIVE
    Defines the last time the HNODE sent a heartbeat to the Distribution Host.
    Display name: Last Heartbeat
  • HNODE_EVENTS
    Displays a list of strings representing health recovery events that occurred on the endpoint. Health recovery events are, for example, restarting of an agent due to critical memory threshold breach, or bypassing of a program that deteriorates the performance of the endpoint.
  • HNODE_INSTALL_STATUS
    Displays the installation status of an endpoint. You can search endpoints by status in 
    PAM Server Control
    Enterprise Management under World View.
    Values:
    Success, Failure, Pending Reboot, Upgrading.
    Display name: Install Status.
  • HNODE_BYPASS_EXIST
    Displays whether the endpoint is in bypass mode as a measure of precaution. In bypass mode, 
    PAM Server Control
    policy handling is temporarily reduced. If this value is No then the endpoint is fully operational.
    Value:
    Yes or No
    Display name: Bypass exist.
  • LOGIN
    Defines the default access type to the host.
    Display name: LOGIN
  • 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.
NODE_INFO
(Informational) Specifies details of the node OS.
NODE_TYPE
(Informational) Defines the type of 
PAM Server Control
installation on the host. Valid values are:
  • ACUCA ControlMinder for UNIX
  • ACWCA ControlMinder for Windows
  • UNABUNIX Authentication Broker (UNAB)
A HNODE record can have a value of both ACU and UNAB for the NODE_TYPE property.
NODE_VERSION
(Informational) Defines the 
PAM Server Control
version installed on the host. The version number is preceded by the NODE_TYPE.Example: ACU:12.50-00.647
NOTIFY
Defines the user to be notified when a resource or user generates an audit event. 
PAM Server Control
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.
PARENTS
(Informational). The list of PMDBs that are the parents of the node in the propagation tree (also defined by the parent_pmd configuration setting).
POLICYASSIGN
Defines the list of policies that are assigned to this object.
Display name: Assigned Policies
POLICY
The status of each of the policies listed in the POLICIES property. The value of the property is a structure with the following fields:
  • nNAME
    Object ID of the POLICY object. Same as the value of the POLICIES property.
  • STATUS
    An integer representing one of the following:
    • DeployedPolicy was deployed successfully on endpoint.
    • Deployed with FailuresPolicy was deployed with one or more rules from the deployment script failing to execute on the endpoint.
    • UndeployedPolicy was undeployed successfully from endpoint.
      Note:
      If a policy is undeployed, no status appears for the host (that is, the status is empty).
    • Undeployed with FailuresPolicy was undeployed with one or more rules from the undeployment script failing to execute on the endpoint.
    • Failed DeploymentPolicy failed to deploy due to an error in the deployment script.
      Note:
      This status can appear only if policy verification is enabled. Otherwise, policyfetcher deploys a policy even if the policy contains errors (Deployed with Failures status).
    • UnknownPolicy status is unknown.
    • Deploy PendingWaiting for a prerequisite policy to be deployed or the policy contains an undefined or unresolved variable.
    • Undeploy PendingWaiting for a dependent policy to be undeployed.
    • Out of SyncThe policy contains a variable and the variable value has changed on the endpoint.
    • Not ExecutedPolicy verification found one or more errors with the policy.
    • QueuedObsolete (for backward compatibility only.)
    • TransferredObsolete (for backward compatibility only.)
    • Transferred FailedObsolete (for backward compatibility only.)
    • Signature FailedObsolete (for backward compatibility only.)
  • deviation
    A value representing whether there is a policy deviation on this node. Valid values are:
    • Yes
    • No
    • Unset
  • dev_time
    Last deviation status update time.
  • ptime
    Last policy status update time.
  • updator
    The name of the user that deployed or removed the policy.
RAUDIT
Defines the types of access events that 
PAM Server Control
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.
PAM Server Control
 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.
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.
SUBSCRIBER_STATUS
The status of the node per parent. The value of the property is a structure with the following fields:
  • oidSubs
    Object ID of the HNODE object. Same as the value of the SUBSCRIBERS property.
  • status
    A value representing one of the following statuses:
    • Available
    • Unavailable
    • Sync (synchronizing)
    • Unknown
  • stime
    Last status update time.
SUBSCRIBERS
The list of subscribers of the node in the propagation tree. Updating this property, implicitly updates the PARENTS property with the value of the HNODE object name.
UACC
Defines the default access authority for the resource, which indicates the access granted to accessors who are not defined to
PAM Server Control
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.
UNAB_ID
(Informational) Displays the UNAB host ID for reporting purposes.
UPDATE_TIME
(Informational) Displays the date and time when the record was last modified.
UPDATE_WHO
(Informational) Displays the administrator who performed the update.
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.