Plugin name: Bouncer (local_bouncer)
Latest version: 4.1.0
Supports: Moodle Workplace 4.1, 4.2, 4.3, 4.4
Non-Core Dependencies: None
Introduction
Power Tools are plugins based on custom solutions for Moodle LMS and Workplace that are available in a subscription service that ensures regular maintenance and upgrade support. If you have any questions or would like to request a Power Tools subscription, please reach out in the Help Desk.
Usage
Bouncer (local_bouncer) is a custom local plugin that whitelists IP addresses based on tenants. The plugin allows you to upload IP addresses and tenants manually or via a .csv file. When IP addresses are added to the Bouncer whitelist report, only users logging in from the specified IP addresses will be able to gain access to the site. If the report does not contain any IP addresses users will be able to log in from anywhere using their login credentials.
Key concepts
Manually adding IP Addresses
Navigate to Site Admin > Plugins > Local > Bouncer whitelist report.
Manually add IP addresses by selecting the Add button.
In the Create whitelist entry modal form that appears, locate the desired tenant by typing the tenant name in the search drop-down menu then selecting it from the list.
Enter the whitelisted IP address. (Note: that fields with an exclamation mark inside a red circle are required and must be filled in.)
Bulk Upload of IP Addresses
Begin by creating the .csv file using ‘tenant site short name’ and ‘ip address’ as the column headings.
A sample file (whitelist.csv) file is available for download from your site by going to Site Admin > Plugins > Local > Bouncer whitelist settings>Bulk.
The tenant short name can be found or added by opening the Workplace launcher in the upper right corner of the window then selecting All tenants.
Select the tenant name from the list of tenants.
Select the Details tab. Enter or copy the site short name to use in the file.
In the file enter the IP addresses.
Save the file as .csv to upload.
After preparing the csv upload file, navigate to Site Admin > Plugins > Local > Bouncer whitelist settings.
Select the Bulk button.
Drag and drop the csv upload file you just created into the whitelist csv area then select the Save changes button.
Navigate to Site Admin > Plugins > Local > Bouncer whitelist report. The list of addresses with associated tenant name will display in the table.
Once it is listed in the table above, any user in that tenant will only have access if accessing from one of the IPs listed. If the user tries to access the site from an IP not specified, they will not gain access.
The IP addresses can be edited or deleted from this report using the buttons in the Actions column.