bonitasoft / bonita-connector-ldap

Bonita connector used for connecting to an LDAP server and retrieve external organization information to be used in a process.

LDAP Connector

Build

Clone or fork this repository, then at the root of the project run:

./mvnw

Test

In order to use this connector, you need to have an LDAP server configured. You can find instructions to deploy an LDAP server with Docker here.
(Adapt dc=xl,dc=com and -e LDAP_ORGANISATION="XL" -e LDAP_DOMAIN="xl.com" to use dc=bonita,dc=org and -e LDAP_ORGANISATION="bonita" -e LDAP_DOMAIN="bonita.org" instead if you want to use the ldif file bellow)

To initialize your LDAP server with test data, you can find an example ldif file to import on bonita-ldap-synchronizer.

To help you fill the LDAP search wizard in Bonita Studio, you can use the "search" page of phpLDAPadmin which perform similar requests.

Troubleshooting

If you get an error such as [LDAP: error code 34 - invalid DN]
Make sure you use the full username such as cn=admin,dc=bonita,dc=org

I you get an exception java.lang.ClassCastException: class java.util.ArrayList cannot be cast to class java.lang.String (java.util.ArrayList and java.lang.String are in module java.base of loader 'bootstrap')
Your affected variable must be of type Java Object with class java.util.List

Release

In order to create a new release:

• On the release branch, make sure to update the pom version (remove the -SNAPSHOT)
• Run the action 'Create release', set the version to release as parameter
• When the action is completed, do not forget to manage the release on the nexus (close and release)
• Update the master with the next SNAPSHOT version.

Contributing

We would love you to contribute, pull requests are welcome! Please see the CONTRIBUTING.md for more information.

License

The sources and documentation in this project are released under the GPLv2 License

bonita-connector-ldap's Issues

Apply this connector on my bonita-community-server

Hello, can you please help me with this?

How do I apply this connector to my bonita server? I use CentOS7 and version 7.12 of the bonita community.
I need my users to be able to authenticate to LDAP.

Thank you for your help.

Add support for paging

Active Directory, by default, has a search limit of 1000 (I assume that other LDAP-compatible directories would have something similar). It would be good to add paging support that will iterate through a number of search result pages.