(zos)Update system login configurations to perform a System Authorization Facility identity user mapping
Use this task to modify configurations to perform System Authorization Facility (SAF) identity mapping.
For the SAF distributed identity mapping feature, we do not need to configure a mapping module.
A mapping module must be placed in the Java Authentication and Authorization Service (JAAS) configuration to provide the mapping from a non-local operating system registry to a SAF user ID. The com.ibm.ws.security.common.auth.module.MapPlatformSubject login module follows this mapping module in the configuration. We can do this using either the SWAM or the LTPA authentication mechanism.
Refer to Selecting an authentication mechanism for more information. Refer to Java Authentication and Authorization Service for more information.
SWAM is deprecated in WebSphere Application Server v8.5 and will be removed in a future release.
Application login configurations do not require changes to modify configurations to perform SAF identity mapping. The WebSphere application login configuration entry WSLogin, calls a system login module configured as the default, which performs the mapping if SAF authorization is required.
To modify configurations to perform System Authorization Facility (SAF) identity mapping and if WebSphere Application Server is configured, you must take the following steps.
- Use the WAS console or the scripting tools to update the required system login configurations.
- If required, update the appropriate user registry panel to enable SAF authorization.
- If we are migrating an existing WebSphere Application Server Network Deployment installation, you must update all the nodes to the service level that supports SAF identity mapping before enabling SAF authorization for a non-local operating system registry.
Results
What to do next
When LTPA is configured, if you are mapping the WAS registry to a SAF user ID, the following system login configuration entries must be configured to provide the user mapping:
- WEB_INBOUND
- The WEB_INBOUND login configuration handles logins for web application requests, including servlets and JavaServer pages (JSP). This login configuration interacts with the output object that is generated from a trust association interceptor (TAI) if configured. The Subject that is passed into the WEB_INBOUND login configuration can contain objects that are generated by the TAI.
WebSphere Application Server console requests and a subset of administrative functions, including file transfer, authenticate using this login configuration entry.
- RMI_INBOUND
- The RMI_INBOUND login configuration handles logins for inbound RMI requests. Typically, these logins are requests for authenticated access to EJB files, and can be performed as JMX requests when using the RMI connector.
- DEFAULT
- The DEFAULT login configuration handles the logins for inbound requests made by most other protocols and internal authentications, such as communication between a z/OS controller and servant processes after an initial authentication request is performed.
When SWAM is configured and you are mapping the WAS user registry to a SAF identity, configure the following system login configuration entry to provide the user mapping:
SWAM is deprecated in WebSphere Application Server v8.5 and will be removed in a future release.
- SWAM
- This entry is used for all authentication when SWAM is selected.
Related concepts
Java Authentication and Authorization Service Distributed identity mapping using SAF
Related tasks
Performing identity mapping for authorization across servers in different realms
(zos) z/OS System Authorization Facility authorization