Introduction

The purpose of this document is to describe the technical integration of the WebSphere Datapower WebGUI login process with the LDAP server using Role Based Management (RBM). RBM provides a flexible and integrated means to control whether an authenticated user has the necessary privileges to access resources through access policies.

 IBM WebSphere Datapower firmware 3.7.x provides a new LDAP Search Parameters WebGUI interface. The LDAP Search Parameters object serves as a container for the parameters to perform an LDAP search operation. This can now be used in the RBM as an added support to perform an LDAP search that retrieves the Group of the user, and thus credential maps.

 In our scenario, users must be defined with their respective groups in the LDAP server. Users login to the appliance and only allowed to log in to the authorized domains defined in RBM mapping policy file.

Requirements

1-     WebSphere Datapower firmware must be at 3.7.x

2-     Usernames and groups must be defined in the LDAP server

 In our sample scenario, the following groups and usernames are defined in the LDAP server:

 Table:1

 Fig:1

Fig:2

WebSphere Datapower Configurations with LDAP Server

To configure the WebSphere Datapower with LDAP server using RBM, perform the following steps:

1-     Login in to the default domain using the admin account.

2-     Expand “Administration” and click on “RBM Settings”

Fig:3

3-     Click on the “Authentication” tab menu and type the following information:

User Authentication Method:      ldap

Authentication Server Host:      <LDAP hostname>

Authentication Server Port:      389

LDAP Version:                    v3

Search LDAP for DN:              on

LDAP Bind DN:                    cn=root,dc=ibm,dc=com

LDAP Bind Password:              <password>

Local Login As Fallback:         specific-users

Fallback User:                   admin

Fig:4

LDAP Search Parameters:        click “+” and type the following

Name:                aldapsearch

LDAP Base DN:        ou=people,dc=ibm,dc=com

LDAP Filter Prefix:  cn=

Keep the other values at default and press “Apply”

Fig:5

Note: The LDAP search parameters used to perform an LDAP Search in order to retrieve the user's DN.

4-     Click on the “Credentials” tab menu and type the following information:

Mapping Credentials Method:      xmlfile

Search LDAP for Group Name:      on

Credentials Server Host:         <LDAP hostname>

Credentials Server Port:         389

LDAP Bind DN:                    cn=root,dc=ibm,dc=com

LDAP Bind Password:              <password>

Fig:6

LDAP Search Parameters:          click “+” and type the following

Name:                ldapsearch

LDAP Base DN:        ou=groups,dc=ibm,dc=com

LDAP Filter Prefix:  (&(member=

LDAP Filter Suffix:  )(|(cn=administrators)(cn=architects)(cn=operations)))

Keep the other values at default and press “Apply”

Fig:7

Note: The filter means that I am looking for all groups which have a member = <authenticated user's dn> and the group name dn.

Mapping RBM Policy URL:          click “+” and type the following

i-                    Select the “RBMInfo.xml” file from the store and then click Next.

Fig:8

ii-                  Click Next twice and delete all the entries from the “User Identities” screen and then press Next.

iii-                On the “Access Profile Mappings” screen, add the following. Press Next

 Table:2

Fig:9

iv-                Select “local:///” from the dropdown and name the file “RBMLDAP-ibm.xml” . Click on Next then click on Commit.

5-     Click on the “Apply”.

6-     Save configuration.

Verification

In order to test the group policy implementation, login to the Datapower WebGUI using the all three users:

1.      Login with “adminuser”, all the domain are visible

Fig:10

2.      Login with “archuser”, only “SandboxDomain” and “default” domains are visible

Fig:11

3.      Login with “opsuser”, only “DeveloperDomain” and “default” domains are visible

Fig:12

Conclusion

In general, Role Based Management (RBM) controls the relationships between authenticated users and resources. By using the RBM, this relationship can be mapped at the group level for the LDAP users and groups. However, there is a little restriction that WebSphere Datapower doesn’t support users being in multiple groups.

Resources

1.      WebSphere Datapower SOA Appliances – Product support

2.      Administration Guide 3.7.3

Appendix A - LDAP users & groups import

Appendix B - RBMLDAP-ibm.xml

• DataPower's New XML Security Gateway
• Over 100 Banks Use VASCO's Strong User Authentication in the U.S.A.
• Authernative Granted Key Patent for User Authentication Technology