Each controller, servant, and client must have its own MVS user ID. When a request flows from a client to the cluster or from a cluster to a cluster, WebSphere Application Server for z/OS passes the user identity (client or cluster) with the request. Thus, each request is performed on behalf of the user identity and the system checks to see if the user identity has the authority to make such a request. The tables in this article outline System Authorization Facility (SAF) and non-SAF authorizations.
Each controller and servant must run under a valid MVS user ID assigned as part of the definition of a started task. This MVS user ID must have a valid UNIX Systems Services user identity (UID) and be connected to WebSphere configuration group that is common to all servers in the cell with a valid MVS and UNIX System Services group identity (GID) identity.
Control | Authorization |
---|---|
DATASET class | Access to data sets |
DSNR class | Access to Database 2 (DB2) |
FACILITY class (BPX.WLMSERVER) | Access to the BPX.WLMSERVER profile to perform Workload Manager (WLM) enclave management in the servant. Without this access, classification is not performed. |
FACILITY class (IMSXCF.OTMACI) | Access to Open Transaction Manager Access (OTMA) for Information Management System (IMS), and access to the BPX.WLMSERVER profile |
HFS file permissions | Access to Hierarchical File System (HFS) files |
LOGSTRM class | Access to log streams |
OPERCMDS class | Access to startServer.sh shell script and Integral JMSProvider |
SERVER class | Access to controller by a servant |
STARTED class | Associate user ID (and optionally group ID) to start procedure |
SURROGAT class (*.DFHEXCI) | Access to EXCI for Customer Information Control System (CICS) access |
The customization dialogs and Resource Access Control Facility (RACF) customization jobs set these up for the initial server settings for the *'ed profiles.
Note that MVS SAF Authorization to all other MVS subsystem resources accessed by J2EE applications is typically performed using the identity of the servant MVS user ID. Refer to Java 2 Platform, Enterprise Edition identity and an operating system thread identity for more information.
The BPX.WLMSERVER profile in the FACILITY class is used to authorize an address space to use the Language Environment (LE) run-time services that interface with workload management (WLM) to perform workload management within a server region. These LE run-time services are by used by WebSphere Application Server to extract classification information from enclaves and to manage the association of work with an Enclave. Because unauthorized interfaces are used to manipulate WLM enclaves for server region work that has not been passed from a controller to a servant, WebSphere Application Server servants should be permitted READ access to this profile. Without this permission, attempts to create, delete, join, or leave a WLM enclave fails with a java.lang.SecurityException.
When global security is enabled, SSL must be available for encryption and message protection. In addition, authentication and authorization of J2EE and administrative clients is enabled.
The FACILITY class authorization needed for SSL services and the definition of SAF keyrings are required when global security is enabled.
When a request flows from a client to WebSphere Application Server or from a cluster to a cluster, WebSphere Application Server for z/OS passes the user identity (client or cluster) with the request. Thus each request is performed on behalf of the user identity and the system checks to see if the user identity has the authority to make such a request. The tables in this article outline z/OS specific authorizations using SAF.
Control | Authorization |
---|---|
CBIND class | Access to a cluster |
EJBROLE or GEJBROLE class | Access to methods in enterprise beans |
FACILITY class (IRR.DIGTCERT.LIST and IRR.DIGTCERT.LISTRING) | SSL key rings, certificates, and mappings |
FACILITY Class (IRR.RUSERMAP) | Kerberos credentials |
PTKTDATA class | PassTicket enabling in the sysplex |
Set OS Thread Identity to RunAs Identity | J2EE cluster property used to enable the start identity for non-J2EE resources |