UCMD_REQUEST - UCMD UACL Entry
Description
A UCMD_REQUEST UACL entry allows or denies access to Universal Command Server services based on client identification and request type.
If access is permitted, the UCMD_REQUEST also specifies whether or not user authentication is required.
There are two forms of the UCMD_REQUEST entry based on the client identification method:
- ucmd_request form is for IP-based client identification.
- ucmd_cert_request is for X.509 certificate-based client identification.
A ucmd_request UACL entry is matched if all of the following occur:
- Request comes from an IP address identified by host.
- Remote end is executing as user remote_user.
- Remote user is requesting to execute a command as local user local_user.
A ucmd_cert_request UACL entry is matched if both of the following occur:
- Request comes from a client with a certificate identifier of certid.
- Remote user is requesting to execute a command as local user local_user.
The first matching rule is used to control access.
Usage
Method | Syntax | IBM i | UNIX | Windows | z/OS |
UACL File Keyword | ucmd_request host,remote_user,local_user,req_type,req_name,access,auth |
|
|
|
|
UACL File Keyword | ucmd_cert_request certid,local_user,req_type,req_name,access,auth |
|
|
|
|
Values
req_type
req_type specifies the type of request that the Universal Command Manager is requesting.
Valid values for req_type are:
Value | Description | IBM i | Windows | UNIX | z/OS |
---|---|---|---|---|---|
cmd | IBM i command (may be user-defined). | ||||
rexx | Single line consisting entirely of REXX statements (maximum 1000 bytes). | ||||
cmdref | Request is for the execution of a command reference.
| ||||
shell | Request is for the execution of a shell command or shell script:
| ||||
stc | Request is for the execution of a started task.
|
req_name
req_name further qualifies the request by its specified name.
Valid values for req_name depend on the req_type value.
req_name includes any options provided by the Universal Command Manager.
For Example
ucmd -c "cmd3 o1 o2" -cmd_type cmdref ...
This command will not match the following UACL entry:
ucmd_request ALL,*,*,cmdref,cmd3,allow,auth
Since the options o1
and o2
are part of the request name field, the UACL entry must be written as:
ucmd_request "ALL,*,*,cmdref,cmd3*,allow,auth"
access
Valid values for access are:
- deny
Service is denied. A message is returned to the remote end. The connection is closed. - allow
Service is accepted and processed.
auth
Valid values for auth are:
- auth
Local user account must be authenticated. The Manager must provide a proper user ID and password. noauth
Local user account does not require user authentication. The Manager still must supply a password to satisfy command syntax rules, but it will not be verified. Any password value will suffice.
Note
noauth should be used with care. Turning off user authentication may violate your local security policies on the Server system.
Windows
noauth is not a valid value.
See UACL Entries for details on host, remote_user, local_user, and certid specification syntax.