2. www.sanjeetpandey.com
Overview
Mule Management Console (MMC) can be configured (or integrated) with an LDAP server for
user authentication. In this case, the LDAP server creates and manages users and this information
about users is not stored on the MMC. The main benefit of using LDAP is the consolidation of
information for an entire organization into a central repository. For example, rather than
managing user lists for each group within MMC, LDAP can be used as a central directory which is
accessible anywhere on the network. Since, LDAP supports Secure Sockets Layer (SSL) and
Transport Layer Security (TLS), sensitive data can be protected from prying eyes.
When using LDAP, the MMC needs to authenticate itself on the LDAP server to gain access to the
LDAP database. Later, MMC needs to log in with a user account defined on the LDAP database.
This user account can be from either of the accounts set up for users of the MMC, or it can be a
separate account altogether (belonging to neither of them) with sole purpose of authenticating
the MMC.
2
3. www.sanjeetpandey.com
Steps to configure Mule MMC
• Obtain LDAP parameters
• Set up users and groups on LDAP
• Create groups on MMC
• Enable the LDAP Spring profile
• Enable LDAP on the console
• Place Jar file
• Restart MMC
3
4. www.sanjeetpandey.com
Obtain LDAP parameters - Step 1
To obtain LDAP Parameters, a request has to be sent to LDAP admin for the following details –
• The LDAP host and listening port
• The LDAP user account credentials which is used to connect the LDAP by the console
• Structure of the LDAP tree that stores user and group information for console users
4
5. www.sanjeetpandey.com
Set up users and groups on LDAP - Step 2
Create groups in the LDAP and add all the users based on their permission like Administrator,
System Administrator, Developer and Monitors
5
7. www.sanjeetpandey.com
Enable the LDAP Spring profile - Step 4
• Navigate to the following directory: $MULE_HOME/apps/mmc/webapps/mmc/WEB-INF
• Locate the file web.xml
• Find the below parameter - <param-name>spring.profiles.active</param-name>
• Modify by adding ldap as a string – <param-value>tracking-h2,env-derby,ldap</param-value>
7
8. www.sanjeetpandey.com
Enable LDAP on the console - Step 5
• Navigate to the following directory: $MULE_HOME/apps/mmc/webapps/mmc/WEB-
INF/classes
• Locate the file mmc-ldap.properties
• Modify following values
• Change providerURL, cn, ou and dc to match the ldap tree
• providerURL=ldap://LDAPHost:389/
• MMC user/password to use for MMC to authenticate users on login. These credentials can be
used to for MMC to connect to the LDAP server
• userDn=cn=mmc,dc=company,dc=com
password=mmcadmin
• activeDirectory integration, the attribute of uid, sAMAccountName can be set
• usernameAttribute=uid
• base context to search for users within the LDAP tree (search subtree is in true)
• userSearchBaseContext=ou=people,dc=company,dc=com
8
9. www.sanjeetpandey.com
Enable LDAP on the console (Cont.)
• filter expression used to find entries in the LDAP database that match a particular user
• userSearchFilterExpression=(uid={0})
• base context in the LDAP database in which the console will search for users to list in the
admin pages, change ou and dcto match the ldap tree. The LDAP tree structure needs to be
changed based on the requirement to view the list of users in Console
• userSearchBase=ou=people,dc=company,dc=com
• Users can be searched by determining the”key-value”. In the default scenario, it will look for
objectclass=person. The attribute used to search for users on the LDAP server
• userSearchAttributeKey=objectclass
• Value of the attribute is used to search for users on the LDAP server. In the LDAP tree all the
users should be of object type “person” which are being configured
• userSearchAttributeValue=person
• “Dn” is used to search for groups to which the user belongs ,ou and dc has to be changed to
match the ldap tree
• roleDn=ou=groups,dc=company,dc=com
groupSearchFilter=(member={0})
9
10. www.sanjeetpandey.com
Place Jar file - Step 6
• Navigate to the following directory: $MULE_HOME/apps/mmc/webapps/mmc/WEB-INF/lib
• Place the jar file called as "spring-ldap-1.3.1.RELEASE-all.jar".
Restart MMC
• Restart the Mule Management Console.
10
Follow Do's and Do Not'sCommon Profile PicFollow Company and Geography:HydAdd followers from peers and WW, MuleSoftHave a Note about yourselfAsk Questions in live BrightTalk Webinars using #tweetsTweet/Retweet Articles on Mule. WW blog, G+ and Forum Links
Follow WW and Mulesoft....