You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
3.3 KiB
3.3 KiB
|
-+-
|
|
/^\
/ \
/ \
_/ \_
// \\
/- -\
/ \
/| [cathedral] |\
/ | | \
| | | |
| | | |
| | __ | |
| | | | | |
| | | .| | |
|_|______|__|_____|_|
the core of a plugin-based usergroup system.
establishes a central auth for users, and loads plugins to carry out various functions based on events.
requires aiohttp ~= 3.7.4, acl, git, useradd
the technically correct mode of installation is running `tools/init.py` as root, /not/ cloning the repo yourself
a good install should go something like the following:
ensure you meet the requirements above ->
read `tools/init.py` & run it as root ->
navigate to the newly-created `/var/cathedral` directory and edit `config.json` to match your host ->
add or edit the files in `tools/skel/` to reflect you/your system (these get copied to new user's home directories) ->
generate a .json list of initial user e-mails (see `tools/test_mail_list.json for an example`) ->
read `tools/add_users.py` & run it as root ->
save the generated user:pass json from STDout, use it to give users their temp passwords ->
start the service using systemd: `systemctl start cathedral` ->
point a reverse proxy at your server, passing in HTTP traffic (optional, recommended) ->
ensure SSH traffic reaches the box one way or another
added users should at this point be able to remote into the box using standard ssh procedures.
included plugins:
* users.py
- displays all users registered on the system @ users.host/*
* fiefdom.py
- userpage system, serves the user's ~/.web directory @ host/~user