LAMa (Ldap Account Manager)

LAMa was developed for the student representation of the University of Bamberg in order to guarantee a simple account administration of the StuVe accounts. It should offer a simpler alternative to the Keycloak account management tool. The tool is based on the Python framework django and uses the packages django-auth-ldap, django-ldapdb to connect to ldap.

Developer Setup

1. clone or unzip repo
2. docker-compose build
3. docker-compose run ldap sh
4. chown ldap:ldap -R /var/lib/openldap/
5. docker-compose up -d
6. docker-compose exec lama sh
   1. python3 manage.py makemigrations account_helper
   2. python3 manage.py migrate
   3. python3 manage.py createsuperuser
7. docker-compose logs -f lama (Display server logs)

phpldapadmin was started to manage LDAP. This is available under localhost:8080. The default password is secret.

LAMa can be reached under localhost:8888.

After the initial setup only steps 3, 5 are necessary.

Production Setup

Important! first start without volumes line
- ./mail_templates:/lama/templates/mails

• copy docker-compose.prod.yml to your favorite directory
• comment line - ./mail_templates:/lama/templates/mails
• docker-compose up -d
• docker cp <dir>_lama_1:/lama/templates/mails ./mail_templates
• docker-compose down and uncumment line - ./mail_templates:/lama/templates/mails
• docker-compose up -d
• Jump into the running container: docker-compse exec lama sh
  • Make migrations: python3 manage.py makemigrations account_helper
  • Make migrations: python3 manage.py migrate account_helper
  • Create superuser: python3 manage.py createsuperuser
• Update copied templates (files or in gui under Einstellungen with the super admin account)

Used Libraries

Frontend

• Bootstrap4 (MIT)
• jquery (MIT)
• dataTables (MIT)

Backend

• Django (BSD)
• django-auth-ldap (BSD 2 Clause)
• django-ldapdb (BSD 2 Clause)
• jinja2 (BSD 3 Clause)