TremoloSecurity / MyVirtualDirectory

Open Source LDAP Virtual Directory
Apache License 2.0
45 stars 18 forks source link

MyVirtualDirectory

Open Source LDAP Virtual Directory

CII Best Practices

Applications need to know who users are and what permissions they have. While most enterprises have some form of an LDAP directory and most applications support LDAP the gap between what an enterprise has and what an application can integrate with. Some common issues a virtual directory can solve:

Feedback and Bugs

All feedback, bugs and support requests must be submitted through this GitHub project's issues

Contributions

All contributions should be submitted as pull requests. All pull requests must include test cases that verify the functionality changes.

Submitting Vulnerabilities

Please send all vulnerabilities to security@tremolosecurity.com. Tremolo Security maintains an internal GitLab deployment where we will track vulnerabilities until a patch is released at which point the issue will be posted to the public GitHub repository with full credit given to the discoverer of the vulnerability. We will respond to any vulnerability reports within 14 days of receipt.

Building Without Unit Tests

To build MyVirtualDirectory without the unit tests, run mvn package -DskipTests=true

Building With Unit Tests

In order to run the unit tests OpenLDAP's slapd must be installed NOTE MacOS' OpenLDAP server will not work. If you're using MacOS use either brew or macports to run slapd. Once slapd is installed, create the following environment variabls:

Environment Variable Example Description
PROJ_DIR /path/to/MyVirtualDirectory The path to the MyVirtualDirectory project
SCHEMA_DIR /etc/openldap Path to OpenLDAP's pre-build schemas
SLAPD_PATH /usr/sbin Directory containing the slapd binary
TMP_DIR /tmp/ldap A temporary directory used for creating local ldap servers NOTE this directory must exist before running tests