Skip to content

Latest commit

 

History

History
30 lines (16 loc) · 2.38 KB

README.md

File metadata and controls

30 lines (16 loc) · 2.38 KB

Form Honeypot anti-bot plugin for OJS

This plugin verifies new user registrations by creating a honeypot on the User Registration form.

Requirements

  • OJS/OMP/OPS 3.4.x or later
  • PHP 8 or later

Installation

Install this as a "generic" plugin in OJS. The preferred installation method is through the Plugin Gallery.

To install manually via the filesystem, extract the contents of this archive to a "formHoneypot" directory under "plugins/generic" in your OJS root. To install via Git submodule, target that same directory path: git submodule add https://github.com/ulsdevteam/pkp-formHoneypot plugins/generic/formHoneypot and git submodule update --init --recursive plugins/generic/formHoneypot. Run the upgrade script to register this plugin, e.g.: php lib/pkp/tools/installPluginVersion.php plugins/generic/formHoneypot/version.xml

Configuration

The plugin has two main features. First, it can be used to block registrations that take suspiciously little time, or that take a very long time. The settings form takes two settings: minimum and maximum times. Users visiting the registration page must complete the registration form between the minimum and maximum time or the form will be rejected. Setting both values to zero deactivates this feature. The second feature is that it adds and hides a field with a randomly-generated name on the registration page. Scripts and bots that fill this field and submit the form will have their registration attempts rejected.

This plugin operates at the site level and requires Site Administrator privileges to configure. If you configured it under version 1.2.0.0 or earlier at the journal level in OJS, you will need to reconfigure the settings.

Usage

When a new user registers, a new field will be added to the page and hidden by javascript. A form submission which includes this field is assumed to be generated by a bot, and an error will be displayed. Additionally, submissions will be assumed to be a bot if they are quicker or slower than the values you specify. For example, if you set a minimum form submission of 10 seconds, but a bot (or user) completes the submission in 6 seconds, this submission will be rejected.

Author / License

Written by Clinton Graham, Alex Wreschnig and Tazio Polanco for the University of Pittsburgh. Copyright (c) University of Pittsburgh.

Released under a license of GPL v2 or later.