/ldapass

Simple web application for managing LDAP based user account passwords

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

ldapass

Web application for setting/changing LDAP user passwords.

LDAPass is a Python/Flask simple web application that aims to make Unix/Linux LDAP user account passwords manageable by their users without involvement of DevOps/SysAdmin resources in a simple, non complicated application not requiring extensive setup nor maintenance.

Requirements

To host LDAPass on a Unix/Linux system you need the following software installed:

  • Python 2.7.x with following modules installed:
    • Flask
    • python-ldap
    • WTForms
  • A web server (Nginx, Apache etc., example Nginx configuration is provided)
  • UWSGI 2.x

Installation

The following examples are assuming you are deploying LDAPass on a FreeBSD system, you should adjust your paths accordingly to your OS.

Clone the repository into proper location:

$ git clone git@github.com:bartekrutkowski/ldapass.git /var/www/ldapass

Copy the config ldapass.conf configuration file and edit it with appropriate values:

$ cp /var/www/ldapass/examples/ldapass.conf /var/www/ldapass/ldapass/
$ vi /var/www/ldapass/ldapass/ldapass.conf

Copy the Nginx nginx_ldapass.example.com.conf configuration file into your OS Nginx config directory and edit it with appropriate values:

$ cp /var/www/ldapass/examples/nginx_ldapass.example.com.conf /usr/local/etc/nginx/conf.d/ldapass.example.com.conf
$ vi /usr/local/etc/nginx/conf.d/ldapass.example.com.conf

Copy the UWSGI uwsgi_ldapass.ini configuration file into your OR UWSGI config directory and edit it with appropriate values:

$ cp /var/www/ldapass/examples/uwsgi_ldapass.ini /usr/local/etc/uwsgi_ldapass.ini
$ vi /usr/local/etc/uwsgi_ldapass.ini

Start the UWSGI and Nginx services:

$ service uwsgi start
$ service nginx start

You're done!