velyks/acserver

A RESTful server for the ACnodes

Access Control Server

A RESTful server that works with the Access Control Nodes (https://github.com/solexious/ACNode) Protocol loosely based on http://wiki.london.hackspace.org.uk/view/Project:Tool_Access_Control/Solexious_Proposal

Status: Done, in production

Progress:

• Sync with membership json file
• Get Card Permission
• Add Card
• Check DB Sync
• Report Tool Status
• Check Tool Status
• Tool Usage (live)
• Tool Usage (usage time)
• Case Alter
• Look up the state of the tools and if they are currently in use
• show maintainers per tool: web gui to show maintainers per tool
• Maintainers: Review the log of people who have used the machine
• Maintainers: Mark the equipment out of order
• Maintainers: Assign new maintainers
• Temporarily suspend users from access to tools
• Admins: All access that maintainer permissions grant
• Admins: Add new tools
• Admins: Assign maintainers to tools

Instructions (vagrant):

• Install vagrant (https://www.vagrantup.com/)
• check out this repository and change the working directory to the local copy
• run vagrant up

The VM forwards the acserver HTTP server on port 1234 and mysql (3306), for use with acnode python tests.

Install manually:

• Requires nginx, php5, php5-mysql, php5-fpm, mysqld
• Copy acserver.nginx to /etc/nginx/sites-available/acserver
• Run ln -s /etc/nginx/sites-enabled/acserver /etc/nginx/sites-available/acserver
• Create MySQL database, and create tables with mysql -uuser -p tablename < blank.sql
• Move application/config/database.php.blank to application/config/database.php and modify with your mysql config
• Start php5-fpm and nginx

Usage:

• See the comments in application/controllers/api.php for usage examples.