TERMINAL Class

Each record in the TERMINAL class defines a terminal of the local host, another host on the network, or an X terminal from which a login session can be made. A record also defines terminals that match a terminal name or IP address pattern (using wildcards). Terminal permissions are checked during the user login procedure, so that users cannot succeed in logging in from terminals they have not been authorized to use.
capamsc141
Each record in the TERMINAL class defines a terminal of the local host, another host on the network, or an X terminal from which a login session can be made. A record also defines terminals that match a terminal name or IP address 
pattern
 (using wildcards). Terminal permissions are checked during the user login procedure, so that users cannot succeed in logging in from terminals they have not been authorized to use.
The TERMINAL class also controls administrative access. ADMIN users can only administer 
PAM Server Control
 from terminals for which they have appropriate access permissions.
When you define a new TERMINAL record, 
PAM Server Control
 tries to convert the name you provide to a fully qualified name. If it succeeds, it stores the fully qualified name in the database. If it fails, it stores the name you specify. When you issue subsequent commands referencing this record (
chres
showres
rmres
, authorize, and so on), use the name as it appears in the database.
The key of the TERMINAL record is the name of the terminal. This name identifies the terminal to 
PAM Server Control
.
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 accessor 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.
  • 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. Whether the access rules were applied directly to the resource, group or class that had the resource as a member is not recorded.
    Use the audit parameter of the 
    chres
     and 
    chfile
     commands to modify the audit mode.
  • CALACL
    Defines a list of the accessors (users and groups) that are permitted to access the resource, and their access types according to the Unicenter NSM calendar status.
    Each element in the calendar access control list (CALACL) contains the following information:
    • Accessor
      Defines an accessor.
    • Calendar
      Defines a reference to a calendar in Unicenter TNG.
    • Access
      Defines the access authority that the accessor has to the resource.
    Access is permitted only when the calendar is ON. Access is denied in all other cases.
    Use the calendar parameter with the authorize command to permit user or group access to the resource according to the access defined in the calendar ACL.
  • CALENDAR
    Represents a Unicenter TNG calendar object for user, group, and resource restrictions in 
    PAM Server Control
    PAM Server Control
     fetches Unicenter TNG active calendars at specified time intervals.
  • 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
  • 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.
  • GROUPS
    The list of GTERMINAL or CONTAINER records a resource record belongs to.
    To modify this property in a TERMINAL class record, change the MEMBERS property in the appropriate CONTAINER or GTERMINAL record.
    Use the 
    mem+
     or 
    mem-
     parameter with the 
    chres
    editres, or
     
    newres 
    command to modify this property.
  • NACL
    The 
    NACL
     property of a resource is an access control list that defines the accessors with authorization denied to a resource, together with the type of access that they are denied (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. 
    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.
      Note:
      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.
  • SECLABEL
    Defines the security label of a user or resource.
    Note:
    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.
  • UACC
    Defines the default access authority for the resource. This indicates that the access is 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.
  • 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. If Warning mode is enabled on a resource, then all access request to a resource is granted. If an access request violates an access rule, a record is written to the audit log.
Example 1:
 This example shows how to authorize a user to access Selang on a terminal on the local host by using the TERMINAL class on a Unix/Linux endpoint. 
Follow these steps:
  1. Create a user "John".
    PAMSC> eu John password(John_Pwd)
  2. Log in as "John" user in a different terminal on the same local host, and try to execute Selang commands. John fails to access Selang because by default all users are not authorized to access Selang.
    ERROR: Initialization failed, EXITING! (localhost) ERROR: Login procedure failed ERROR: You are not allowed to administer this site from terminal MyLocalHost.sample.com
  3. The superuser (root) creates a policy using TERMINAL class that authorizes "John" to access Selang in a terminal on the local host.
    PAMSC> authorize TERMINAL MyLocalHost.sample.com uid(John) access(r w) (localhost)
  4. John attempts to access Selang in a terminal on the local host and succeeds.
    MyLocalHost.sample.com:~> /opt/CA/PAMSC/bin/selang CA PAMSC selang v12.81.0.2606 - CA PAMSC command line interpreter Copyright (c) YYYY CA. All rights reserved.
Example 2:
 This example shows how to authorize a user to access Selang on a terminal on another host on the network by using the TERMINAL class on a Unix/Linux endpoint. 
Follow these steps:
  1. From the local host (MyLocalHost.sample.com), a root user logs in to another host (AnotherHost.sample.com) on the network.
    MyLocalHost.sample.com:~> ssh root@ AnotherHost.sample.com [email protected]'s password: # id uid=0(root) gid=0(system) groups=2(bin),3(sys),7(security),8(cron),10(audit),11(lp) # hostname AnotherHost.sample.com
  2. The root user accesses Selang, and creates a user “John” in another host on the network (AnotherHost.sample.com).
    # ./opt/CA/PAMSC/bin/selang
    PAMSC> eu John password(John_pwd)
  3. From the local host (MyLocalHost.sample.com), John user opens a terminal and logs in to another host (AnotherHost.sample.com) on the network, and attempts to access Selang but fails.
    MyLocalHost.sample.com:~> ssh John@ AnotherHost.sample.com [email protected]'s password: $ id uid=203(John) gid=1(staff) $ hostname AnotherHost.sample.com $ /opt/CA/PAMSC/bin/selang ERROR: Initialization failed, EXITING! (localhost) ERROR: Login procedure failed ERROR: You are not allowed to administer this site from terminal AnotherHost.sample.com
  4. The root user authorizes John to execute Selang commands in another terminal on the network.
    PAMSC> authorize terminal AnotherHost.sample.com uid(John) access(r w)
  5. John can now execute Selang commands in another terminal on the network.
    $ /opt/CA/PAMSC/bin/selang
    CA PAMSC selang v12.81.0.2690 - CA PAMSC command line interpreter
    Copyright (c) YYYY CA. All rights reserved.