WebSphere Datapower’s WebGUI User Authentication with LDAP Sever using RBM

WebGUI User Authentication with LDAP Setup



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.



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:



Member users

Group access to Datapower Domains






SandboxDomain (Full)

Default (Read-Only)



DeveloperDomain (Full)

Default (Read-Only)


LDAP Groups View 


LDAP Users


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”



Configure RBM -Main

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



Configure RBM - Authentication 

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”



Configure LDAP Search Parameters

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>



Configure RBM Credentials


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”



Configure LDAP Search Parameters 2

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.



RBM Policy 1 

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









*/SandboxDomain/*?Access=r+w+a+d+x */default/*?Access=r+w+a+d+x




*/DevelopersDomain/*?Access=r+w+a+d+x */default/*?Access=r+w+a+d+x





RBM Policy 2

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.



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


Verify 1


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


Verify 2

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


Verify 3


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.


1.      WebSphere Datapower SOA Appliances – Product support

2.      Administration Guide 3.7.3

Appendix A - LDAP users & groups import

dn: dc=ibm,dc=com

dc: ibm

description: My wonderful company

objectClass: dcObject

objectClass: organization

o: IBM Inc.


dn: ou=people, dc=ibm,dc=com

ou: people

description: All people in organisation

objectClass: organizationalUnit


dn: cn=adminuser,ou=people, dc=ibm,dc=com

sn: adminuser

userPassword:: password

ou: Datapower Admin Resource

carLicense: HISCAR 123

mail: [email protected]

objectClass: inetOrgPerson

uid: admin

homePhone: 555-111-2222

cn: adminuser

description: swell guy


dn: cn=archuser,ou=people, dc=ibm,dc=com

sn: archuser

userPassword:: password

ou: Datapower Architect Resource

carLicense: HISCAR 123

mail: [email protected]

objectClass: inetOrgPerson

uid: arch

homePhone: 555-111-2222

cn: archuser

description: swell guy


dn: cn=opsuser,ou=people, dc=ibm,dc=com

sn: opsuser

userPassword:: password

ou: Datapower Operation Resource

carLicense: HISCAR 123

mail: [email protected]

objectClass: inetOrgPerson

uid: ops

homePhone: 555-111-2222

cn: opsuser

description: swell guy


dn: ou=groups, dc=ibm,dc=com

ou: groups

objectClass: organizationalUnit

description: generic groups branch


dn: cn=administrators,ou=groups, dc=ibm,dc=com

objectClass: groupOfNames

description: Administrator group

member: cn=adminuser,ou=people,dc=ibm,dc=com

cn: administrators


dn: cn=architects,ou=groups, dc=ibm,dc=com

objectClass: groupOfNames

description: Operation group

member: cn=archuser,ou=people,dc=ibm,dc=com

cn: architects


dn: cn=operations,ou=groups, dc=ibm,dc=com

description: Operation group

objectClass: groupOfNames

member: cn=opsuser,ou=people,dc=ibm,dc=com

cn: operations




Appendix B - RBMLDAP-ibm.xml

<aaa:AAAInfo xmlns:dpfunc="http://www.datapower.com/extensions/functions" xmlns:aaa="http://www.datapower.com/AAAInfo">


<aaa:Summary>This is an example of the file format.</aaa:Summary>

<!-- Determine credential from output of the extract-identity phase. -->

<!-- Specify credential (if any) to use when there is no authenticated identity. -->

<!-- Map credentials to different credentials. -->















       <aaa:OutputCredential>*/SandboxDomain/*?Access=x+d+a+w+r */default/*?Access=r</aaa:OutputCredential>










<!-- Determine resource from output of the extract-resource phase. -->

<!-- Authorize access to resource for credentials. -->



More Stories By Asim Saddal

Asim Saddal works in the Middleware (WebSphere Application Server, WebSphere Datapower, WebSphere Process Server, WebSphere VE) practice of IBM Software Services for WebSphere.

Latest Stories
DX World EXPO, LLC, a Lighthouse Point, Florida-based startup trade show producer and the creator of "DXWorldEXPO® - Digital Transformation Conference & Expo" has announced its executive management team. The team is headed by Levent Selamoglu, who has been named CEO. "Now is the time for a truly global DX event, to bring together the leading minds from the technology world in a conversation about Digital Transformation," he said in making the announcement.
"Space Monkey by Vivent Smart Home is a product that is a distributed cloud-based edge storage network. Vivent Smart Home, our parent company, is a smart home provider that places a lot of hard drives across homes in North America," explained JT Olds, Director of Engineering, and Brandon Crowfeather, Product Manager, at Vivint Smart Home, in this SYS-CON.tv interview at @ThingsExpo, held Oct 31 – Nov 2, 2017, at the Santa Clara Convention Center in Santa Clara, CA.
SYS-CON Events announced today that Conference Guru has been named “Media Sponsor” of the 22nd International Cloud Expo, which will take place on June 5-7, 2018, at the Javits Center in New York, NY. A valuable conference experience generates new contacts, sales leads, potential strategic partners and potential investors; helps gather competitive intelligence and even provides inspiration for new products and services. Conference Guru works with conference organizers to pass great deals to gre...
DevOps is under attack because developers don’t want to mess with infrastructure. They will happily own their code into production, but want to use platforms instead of raw automation. That’s changing the landscape that we understand as DevOps with both architecture concepts (CloudNative) and process redefinition (SRE). Rob Hirschfeld’s recent work in Kubernetes operations has led to the conclusion that containers and related platforms have changed the way we should be thinking about DevOps and...
The Internet of Things will challenge the status quo of how IT and development organizations operate. Or will it? Certainly the fog layer of IoT requires special insights about data ontology, security and transactional integrity. But the developmental challenges are the same: People, Process and Platform. In his session at @ThingsExpo, Craig Sproule, CEO of Metavine, demonstrated how to move beyond today's coding paradigm and shared the must-have mindsets for removing complexity from the develop...
In his Opening Keynote at 21st Cloud Expo, John Considine, General Manager of IBM Cloud Infrastructure, led attendees through the exciting evolution of the cloud. He looked at this major disruption from the perspective of technology, business models, and what this means for enterprises of all sizes. John Considine is General Manager of Cloud Infrastructure Services at IBM. In that role he is responsible for leading IBM’s public cloud infrastructure including strategy, development, and offering m...
The next XaaS is CICDaaS. Why? Because CICD saves developers a huge amount of time. CD is an especially great option for projects that require multiple and frequent contributions to be integrated. But… securing CICD best practices is an emerging, essential, yet little understood practice for DevOps teams and their Cloud Service Providers. The only way to get CICD to work in a highly secure environment takes collaboration, patience and persistence. Building CICD in the cloud requires rigorous ar...
Companies are harnessing data in ways we once associated with science fiction. Analysts have access to a plethora of visualization and reporting tools, but considering the vast amount of data businesses collect and limitations of CPUs, end users are forced to design their structures and systems with limitations. Until now. As the cloud toolkit to analyze data has evolved, GPUs have stepped in to massively parallel SQL, visualization and machine learning.
"Evatronix provides design services to companies that need to integrate the IoT technology in their products but they don't necessarily have the expertise, knowledge and design team to do so," explained Adam Morawiec, VP of Business Development at Evatronix, in this SYS-CON.tv interview at @ThingsExpo, held Oct 31 – Nov 2, 2017, at the Santa Clara Convention Center in Santa Clara, CA.
To get the most out of their data, successful companies are not focusing on queries and data lakes, they are actively integrating analytics into their operations with a data-first application development approach. Real-time adjustments to improve revenues, reduce costs, or mitigate risk rely on applications that minimize latency on a variety of data sources. In his session at @BigDataExpo, Jack Norris, Senior Vice President, Data and Applications at MapR Technologies, reviewed best practices to ...
Widespread fragmentation is stalling the growth of the IIoT and making it difficult for partners to work together. The number of software platforms, apps, hardware and connectivity standards is creating paralysis among businesses that are afraid of being locked into a solution. EdgeX Foundry is unifying the community around a common IoT edge framework and an ecosystem of interoperable components.
"ZeroStack is a startup in Silicon Valley. We're solving a very interesting problem around bringing public cloud convenience with private cloud control for enterprises and mid-size companies," explained Kamesh Pemmaraju, VP of Product Management at ZeroStack, in this SYS-CON.tv interview at 21st Cloud Expo, held Oct 31 – Nov 2, 2017, at the Santa Clara Convention Center in Santa Clara, CA.
Large industrial manufacturing organizations are adopting the agile principles of cloud software companies. The industrial manufacturing development process has not scaled over time. Now that design CAD teams are geographically distributed, centralizing their work is key. With large multi-gigabyte projects, outdated tools have stifled industrial team agility, time-to-market milestones, and impacted P&L stakeholders.
"Akvelon is a software development company and we also provide consultancy services to folks who are looking to scale or accelerate their engineering roadmaps," explained Jeremiah Mothersell, Marketing Manager at Akvelon, in this SYS-CON.tv interview at 21st Cloud Expo, held Oct 31 – Nov 2, 2017, at the Santa Clara Convention Center in Santa Clara, CA.
Enterprises are adopting Kubernetes to accelerate the development and the delivery of cloud-native applications. However, sharing a Kubernetes cluster between members of the same team can be challenging. And, sharing clusters across multiple teams is even harder. Kubernetes offers several constructs to help implement segmentation and isolation. However, these primitives can be complex to understand and apply. As a result, it’s becoming common for enterprises to end up with several clusters. Thi...