Welcome!

Article

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

WebGUI User Authentication with LDAP Setup

 

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

Groups

Member users

Group access to Datapower Domains

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

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

Full

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

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

SandboxDomain (Full)

Default (Read-Only)

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

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

DeveloperDomain (Full)

Default (Read-Only)

 Fig:1

LDAP Groups View 


Fig:2

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”

 

Fig:3

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

 

Fig:4

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”

 

Fig:5

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>

 

Fig:6

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”

 

Fig:7

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.

 

Fig:8

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

 Table:2

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

adm-grp

adm-grp

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

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

arch-grp

arch-grp

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

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

ops-grp

ops-grp

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

 

 

 


Fig:9

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.

 

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

Verify 1

 

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

Fig:11

Verify 2

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

Fig:12

Verify 3

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

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:FormatVersion>1</aaa:FormatVersion><aaa:Filename>local:///RBMLDAP-ibm.xml</aaa:Filename>

<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:MapCredentials>

       <aaa:InputCredential>cn=administrators,ou=groups,dc=ibm,dc=com</aaa:InputCredential>

       <aaa:OutputCredential>adm-grp</aaa:OutputCredential>

</aaa:MapCredentials>

<aaa:MapCredentials>

       <aaa:InputCredential>adm-grp</aaa:InputCredential>

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

</aaa:MapCredentials>

<aaa:MapCredentials>

       <aaa:InputCredential>cn=architects,ou=groups,dc=ibm,dc=com</aaa:InputCredential>

       <aaa:OutputCredential>arch-grp</aaa:OutputCredential>

</aaa:MapCredentials>

<aaa:MapCredentials>

       <aaa:InputCredential>arch-grp</aaa:InputCredential>

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

</aaa:MapCredentials>

<aaa:MapCredentials>

       <aaa:InputCredential>cn=operations,ou=groups,dc=ibm,dc=com</aaa:InputCredential>

       <aaa:OutputCredential>ops-grp</aaa:OutputCredential>

       </aaa:MapCredentials>

<aaa:MapCredentials>

       <aaa:InputCredential>ops-grp</aaa:InputCredential>

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

</aaa:MapCredentials>

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

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

</aaa:AAAInfo>

 

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.
"At the keynote this morning we spoke about the value proposition of Nutanix, of having a DevOps culture and a mindset, and the business outcomes of achieving agility and scale, which everybody here is trying to accomplish," noted Mark Lavi, DevOps Solution Architect at Nutanix, in this SYS-CON.tv interview at @DevOpsSummit at 20th Cloud Expo, held June 6-8, 2017, at the Javits Center in New York City, NY.
SYS-CON Events announced today that Massive Networks will exhibit at SYS-CON's 21st International Cloud Expo®, which will take place on Oct 31 – Nov 2, 2017, at the Santa Clara Convention Center in Santa Clara, CA. Massive Networks mission is simple. To help your business operate seamlessly with fast, reliable, and secure internet and network solutions. Improve your customer's experience with outstanding connections to your cloud.
Internet of @ThingsExpo, taking place October 31 - November 2, 2017, at the Santa Clara Convention Center in Santa Clara, CA, is co-located with 21st Cloud Expo and will feature technical sessions from a rock star conference faculty and the leading industry players in the world. The Internet of Things (IoT) is the most profound change in personal and enterprise IT since the creation of the Worldwide Web more than 20 years ago. All major researchers estimate there will be tens of billions devic...
"The Striim platform is a full end-to-end streaming integration and analytics platform that is middleware that covers a lot of different use cases," explained Steve Wilkes, Founder and CTO at Striim, in this SYS-CON.tv interview at 20th Cloud Expo, held June 6-8, 2017, at the Javits Center in New York City, NY.
Everything run by electricity will eventually be connected to the Internet. Get ahead of the Internet of Things revolution and join Akvelon expert and IoT industry leader, Sergey Grebnov, in his session at @ThingsExpo, for an educational dive into the world of managing your home, workplace and all the devices they contain with the power of machine-based AI and intelligent Bot services for a completely streamlined experience.
SYS-CON Events announced today that Calligo, an innovative cloud service provider offering mid-sized companies the highest levels of data privacy and security, has been named "Bronze Sponsor" of SYS-CON's 21st International Cloud Expo ®, which will take place on Oct 31 - Nov 2, 2017, at the Santa Clara Convention Center in Santa Clara, CA. Calligo offers unparalleled application performance guarantees, commercial flexibility and a personalised support service from its globally located cloud plat...
21st International Cloud Expo, taking place October 31 - November 2, 2017, at the Santa Clara Convention Center in Santa Clara, CA, will feature technical sessions from a rock star conference faculty and the leading industry players in the world. Cloud computing is now being embraced by a majority of enterprises of all sizes. Yesterday's debate about public vs. private has transformed into the reality of hybrid cloud: a recent survey shows that 74% of enterprises have a hybrid cloud strategy. Me...
"With Digital Experience Monitoring what used to be a simple visit to a web page has exploded into app on phones, data from social media feeds, competitive benchmarking - these are all components that are only available because of some type of digital asset," explained Leo Vasiliou, Director of Web Performance Engineering at Catchpoint Systems, in this SYS-CON.tv interview at DevOps Summit at 20th Cloud Expo, held June 6-8, 2017, at the Javits Center in New York City, NY.
SYS-CON Events announced today that DXWorldExpo has been named “Global Sponsor” of SYS-CON's 21st International Cloud Expo, which will take place on Oct 31 – Nov 2, 2017, at the Santa Clara Convention Center in Santa Clara, CA. Digital Transformation is the key issue driving the global enterprise IT business. Digital Transformation is most prominent among Global 2000 enterprises and government institutions.
SYS-CON Events announced today that Datera, that offers a radically new data management architecture, has been named "Exhibitor" of SYS-CON's 21st International Cloud Expo ®, which will take place on Oct 31 - Nov 2, 2017, at the Santa Clara Convention Center in Santa Clara, CA. Datera is transforming the traditional datacenter model through modern cloud simplicity. The technology industry is at another major inflection point. The rise of mobile, the Internet of Things, data storage and Big...
"Outscale was founded in 2010, is based in France, is a strategic partner to Dassault Systémes and has done quite a bit of work with divisions of Dassault," explained Jackie Funk, Digital Marketing exec at Outscale, in this SYS-CON.tv interview at 20th Cloud Expo, held June 6-8, 2017, at the Javits Center in New York City, NY.
"We were founded in 2003 and the way we were founded was about good backup and good disaster recovery for our clients, and for the last 20 years we've been pretty consistent with that," noted Marc Malafronte, Territory Manager at StorageCraft, in this SYS-CON.tv interview at 20th Cloud Expo, held June 6-8, 2017, at the Javits Center in New York City, NY.
Kubernetes is an open source system for automating deployment, scaling, and management of containerized applications. Kubernetes was originally built by Google, leveraging years of experience with managing container workloads, and is now a Cloud Native Compute Foundation (CNCF) project. Kubernetes has been widely adopted by the community, supported on all major public and private cloud providers, and is gaining rapid adoption in enterprises. However, Kubernetes may seem intimidating and complex ...
While the focus and objectives of IoT initiatives are many and diverse, they all share a few common attributes, and one of those is the network. Commonly, that network includes the Internet, over which there isn't any real control for performance and availability. Or is there? The current state of the art for Big Data analytics, as applied to network telemetry, offers new opportunities for improving and assuring operational integrity. In his session at @ThingsExpo, Jim Frey, Vice President of S...