For z/OS platforms

Configuring distributed identity filters in z/OS security

Distributed identity filters must be configured when the mapDistributedIdentities attribute in the safCredentials configurations element is set to true.

About this task

Before you map distributed identities to System Authorization Facility (SAF) users, you must first configure distributed identity filters in z/OS security.

The distributed identity filter in the SAF class RACMAP consists of the distributed user name and the realm name of the distributed user name. You can configure the filters to map many distributed identities to one SAF user or you can have a one-to-one mapping.

The following example illustrates the syntax for creating a distributed identity filter that uses the RACMAP command:
RACMAP ID(<SAFUser>) MAP USERDIDFILTER(NAME('<distributedUserId>'))
REGISTRY(NAME('<distributedRealmName>'))
    WITHLABEL('<someLabel>')
    
In the example:
  • The SAFUser element is the SAF user in z/OS security.
  • The distributedUserID element is the distributed identity.
  • The distributedRealmName element is the realm name of the distributed identity.
  • The someLabel element is a field that describes this distributed identity filter.

Procedure

  1. Activate the IDIDMAP class. This command needs to be run only once at the beginning. SETROPTS CLASSACT(IDIDMAP) RACLIST(IDIDMAP)
  2. After you edit the RACMAP profiles, you must use the following command for the changes to take effect: SETROPTS RACLIST(IDIDMAP) REFRESH

Example

The following example illustrates the LDAP user (LDAPUser1) mapped to the SAF user (USER1):
RACMAP ID(USER1)  MAP USERDIDFILTER(NAME('CN=LDAPUser1,o=ibm,c=us')) 
    REGISTRY(NAME('ccwin12.austin.ibm.com:389')) 
    WITHLABEL('Mapping LDAP LDAPUser1 to USER1')

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: Friday, 16 September 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_config_dist_idfilter
File name: twlp_config_dist_idfilter.html