This project aims to create middleware for BigBlueButton to allow for user and group management for scheduling conferences. It can use federated identities (simpleSAMLphp) and use OpenSocial (osapi) to retrieve group information.
BBBmw is the middleware that links user/group authentication (federated groups and identities) to BigBlueButton. It interacts with (an unmodified) BigBlueButton using the API provided by the BigBlueButton service.
BBBmw is needed (right now) because BigBlueButton does not have any notion of users/groups only conferences, moderators and attendees.
Ideally the BigBlueButton project would support something like OAuth in the future so for instance OpenSocial containers can directly interact with it rendering this project redundant.
BBBmw uses the API for BigBlueButton 0.7x. However, as long as the API does not change it should keep working without changing bbbmw.
For simpleSAMLphp a system wide installation of simpleSAMLphp is recommended.
See docs/SURFconext.txt for more information on configuring simpleSAMLphp
for use with SURFconext, other identity federations will differ somewhat in
configuration.
$ git clone https://github.com/fkooman/bbbmw.git
$ sh docs/configure.sh
$ sh docs/install_dependencies.sh
If you want to use ConextGroupsOAuth2 run the following to initialize the
database:
$ php docs/init_oauth_db.php
Copy config.php.default to config.php:
$ cp config.php.default config.php
Now you can modify it to match your configuration. Set at least the URL to the BigBlueButton API and the salt as configured in BBB.
If you want to use a simple test configuration with plain username and password
authentication use SimpleAuth and SimpleGroups and configure them in
config.php.
Set the correct SELinux labels (only for Fedora/Red Hat systems?)
$ chcon -R -t httpd_sys_rw_content_t data/ tpl_c/
Allow HTTP to access the network (to contact BBB)
$ su -c 'setsebool -P httpd_can_network_connect on'
(The -P flag makes the setting persistent across reboots)