Junket

Open Source Web App Directory Manager

Junket is an open source web application for managing LDAP/Active Directory. This repository uses Node.js to deploy a web application.

This documentation is available on junket.site

Table of Contents

• Requirements
• Installation
  • Using Docker
  • Using npm
• License

Requirements

• Docker (Optional);
• npm (Optional);
• A running LDAP/AD server;
• User with bind privilegies;

Installation

Install and run junket locally (Using Docker):

1. Create env file according to your LDAP/AD server:

# vim env.list

with content (example):

LDAP_PORT=389
LDAP_SERVER=ldap://www.zflexldap.com
SUFFIX=dc=zflexsoftware,dc=com
READER_DN=cn=ro_admin,ou=sysadmins,dc=zflexsoftware,dc=com
READER_MAIL=ro_admin@zflexsoftware.com
READER_PWD=zflexpass

2. Run docker run command:

# docker run --name junket -p 8080:8080 --env-file ./env.list -d ricardob/junket

3. On your browser navigate to localhost:8080

• The username for login in the example LDAP server is: guest3

• Password: guest3password

• If you want to access the admin page, you can login with the user: guest1

• Password: guest1password

Install and run junket locally (Using npm):

1. Clone Junket repository:

# git clone https://github.com/ricardobf/junket.git

2. Navigate to junket package folder:

# cd junket/junket

3. Create env file according to your LDAP/AD server:

# vim env.list

with content (example):

LDAP_PORT=389
LDAP_SERVER="ldap://www.zflexldap.com"
SUFFIX="dc=zflexsoftware,dc=com"
READER_DN="cn=ro_admin,ou=sysadmins,dc=zflexsoftware,dc=com"
READER_MAIL="ro_admin@zflexsoftware.com"
READER_PWD="zflexpass"

4. Export env variables to local shell:

# export $(xargs < env.list)

5. Run npm install command:

# npm install

6. Run npm start command:

# npm start

7. On your browser navigate to localhost:8080

• The username for login in the example LDAP server is: guest3

• Password: guest3password

• If you want to access the admin page, you can login with the user: guest1

• Password: guest1password

License

See LICENSE.