mreynolds / 389-ds-portal

Forked from 389-ds-portal 4 years ago
Clone
README.md

389 Directory Server - Self Service Portal

This is a small, self contained web portal to allow users to perform some limited self service steps such as changing their name, password or other details.

It is not inteded to replace the cockpit administration console or lib389 cli tools. It is only for limited self-service actions.

WARNING:

This project is NOT COMPLETE and NOT PRODUCTION READY yet. Please contact the 389 team if you are interested in this and testing it. Be ware that there are current possible security issues in the code base that make it not-feasible for production deployment.

More information and Code of Conduct

Please see our contributing guide online:

http://www.port389.org/docs/389ds/contributing.html

We believe that all people should be respected and welcome in our communities. As such we follow the Fedora Code of Conduct:

https://docs.fedoraproject.org/en-US/project/code-of-conduct/

License

The 389 Directory Server Self Service Portal is subject to the terms detailed in the license agreement file called LICENSE.

Late-breaking news and information on the 389 Directory Server and related projects are available on our wiki page:

http://www.port389.org/

Developing

You will need a working 389 instance. For the moment this must expose ldapi at:

/data/run/slapi-localhost.socket.

The easiest way to setup a 389 server to test with this is in a docker container:

docker run -v 389data:/data -i -t 389ds/dirsrv:latest

You can then run this project in a container such as:

docker run -v 389data:/data -i -t opensuse/tumbleweed:latest /bin/sh

To run this you will require python3, python3-Flask and temporarily python3-cryptography.

Once installed, in the 389-ds-portal directory run:

./devel.sh

Obviously there is some work to be done around configuring this project!!!

Testing

py.test ./test.py