Welcome to the Hydro Raindrop WordPress plugin repository on GitHub.
The WP Hydro Raindrop
plugin provides Hydro Raindrop Multi Factor Authentication to your WordPress site.
- Requires minimum hassle to setup
- Intercepts the Login automatically
- Allows users to set-up MFA with their HydroID
- Instant Authentication
Note: Free Hydro Mobile App is required to complete the MFA process. You can get iOS App here or the Android App here.
You can install the plugin using one of the methods outlined below:
- Visit 'Plugins > Add New'
- Search for 'Hydro MFA'
- Activate
WP Hydro Raindrop
plugin from your Plugins page. - Follow the 'After activation process' outlined below.
- Upload the
wp-hydro-raindrop
folder to the/wp-content/plugins/
directory. - Activate the
WP Hydro Raindrop
plugin through the 'Plugins' menu in WordPress. - Follow the 'After activation process' outlined below.
Download the plugin from WordPress.org: WP Hydro Raindrop, or install it directly from WordPress (Navigate to Plugins > Add new > Search for 'hydro')
- Make sure you have installed composer (https://getcomposer.org/)
cd wp-content/plugins
(from root of your WordPress installation)git clone [email protected]:adrenth/wp-hydro-raindrop.git
cd wp-hydro-raindrop
composer install
(This will install the required dependencies for the plugin.)
When the plugin is activated, three pages are automatically created:
- Hydro Raindrop MFA Page (
/hydro-raindrop/
) - Hydro Raindrop MFA Settings Page (
/hydro-raindrop/settings
) - Hydro Raindrop MFA Setup Page (
/hydro-raindrop/setup
)
Each page contains it's corresponding shortcode which will be responsible for the Hydro Raindrop MFA implementation to work. These pages are meant for customization and integration in your own custom theme.
By default the Hydro Raindrop integrated pages are enabled.
The following steps are necessary to enable Hydro Raindrop MFA on your site:
- Create an account over at Hydrogen Website.
- Apply for Production Access. Once approved, generate your
Client ID
,Client Secret
andApplication ID
. - In WordPress from the Main Menu navigate to Hydro Raindrop -> Settings -> API Settings and enter the above details, select Production Mode and the plugin is ready for use.
- Set-up the preferred MFA method (and other customization options) in the tab Customization
There are three MFA setup methods:
- Optional: User decides to enable MFA on their account.
- Prompted (default): MFA setup screen will be prompted after logging in. User can skip this step and setup MFA later.
- Enforced: MFA is forced site wide. Users will have to setup MFA after logging in.
That's it!
- SSL MUST be enabled for MFA to work.
- PHP 7.0 or higher is required.
- Login as an administrator
- Go to Hydro Raindrop -> Settings > Customization.
- At MFA Page select the Hydro Raindrop MFA Page or select Use default MFA Page to stick with the defaults.
- Make sure the shortcode
[hydro_raindrop_mfa]
is present on this page.
Use these shortcodes in your custom templates/pages:
[hydro_raindrop_mfa_flash]
: Renders flash messages.[hydro_raindrop_mfa_form_open]
: Renders opening<form>
tag.[hydro_raindrop_mfa_digits]
: Renders the MFA digits.[hydro_raindrop_mfa_button_authorize class="my-css-class" label="Authorize"]
: Renders the Authorize (submit) button.[hydro_raindrop_mfa_button_cancel class="my-css-class" label="Cancel"]
: Renders the Cancel button.[hydro_raindrop_mfa_form_close]<
: Renders the closing</form>
tag along with the nonce field.
Create a custom page template (e.g. /wp-content/themes/my-awesome-theme/hydro-raindrop-mfa.php
) for the Hydro Raindrop MFA.
Below is an example on how to use the shortcodes.
<?php
/**
* Template Name: Hydro Raindrop MFA
*/
get_header();
?>
<!-- HTML -->
<div class="row">
<div class="col-sm">
<div class="card w-75">
<div class="card-body">
<?php echo do_shortcode( '[hydro_raindrop_mfa_form_open]' ); ?>
<div class="text-center">
<img src="https://www.hydrogenplatform.com/docs/hydro/v1/images/logo.png">
</div>
<h2 class="card-text text-center">
<?php echo do_shortcode( '[hydro_raindrop_mfa_digits]' ); ?>
</h2>
<div class="row">
<div class="col-md-4">
<?php echo do_shortcode( '[hydro_raindrop_mfa_button_cancel class="btn btn-default"]' ); ?>
</div>
<div class="col-md-8 text-right">
<?php echo do_shortcode( '[hydro_raindrop_mfa_button_authorize class="btn btn-primary"]' ); ?>
</div>
</div>
<?php echo do_shortcode( '[hydro_raindrop_mfa_form_close]' ); ?>
</div>
</div>
</div>
</div>
<!-- HTML -->
<?php
get_footer();
- Login as an administrator
- Go to Hydro Raindrop -> Settings > Customization.
- At MFA Setup Page select the Hydro Raindrop Setup Page or select Use default MFA Setup Page to stick with the defaults.
- Make sure the shortcode
[hydro_raindrop_setup]
is present on this page.
Use these shortcodes in your custom templates/pages:
[hydro_raindrop_setup_flash]
: Renders flash messages.[hydro_raindrop_setup_form_open]
: Renders opening<form>
tag.[hydro_raindrop_setup_hydro_id]
: Renders the HydroID input form field.[hydro_raindrop_setup_button_submit class="my-css-class" label="Submit"]
: Renders the Submit button.[hydro_raindrop_setup_button_skip class="my-css-class" label="Skip"]
: Renders the Skip button (if applicable).[hydro_raindrop_setup_form_close]
: Renders the closing</form>
tag along with the nonce field.
- Login as an administrator
- Go to Hydro Raindrop -> Settings > Customization.
- At MFA Settings Page select the Hydro Raindrop Settings Page or select Use default MFA Settings Page to stick with the defaults.
- Make sure the shortcode
[hydro_raindrop_setup]
is present on this page.
Use these shortcodes in your custom templates/pages:
[hydro_raindrop_settings_flash]
: Renders flash messages.[hydro_raindrop_settings_form_open]
: Renders opening<form>
tag.[hydro_raindrop_settings_checkbox_mfa_enabled]
: Renders the checkbox form field.[hydro_raindrop_settings_button_submit class="my-css-class" label="Submit"]
: Renders the Submit button.[hydro_raindrop_settings_form_close]
: Renders the closing</form>
tag along with the nonce field.
When a user is blocked because of too many failed verification attempts. Executed after a user is blocked and before the user is being logged out.
Executed after a Multi Factor Authentication attempt failed.
Executed after a successful Multi Factor Authentication.
Executed when Hydro Raindrop Setup failed.
Executed when user has successfully completed the Hydro Raindrop Setup. The HydroID is confirmed and verified at this point.
Executed when user needs to set up their HydroID. The given user is authenticated. The WordPress auth cookie might not be set.
Executed when user needs to perform MFA. The given user is authenticated. The WordPress auth cookie might not be set.
- https://github.com/adrenth/wp-hydro-raindrop/issues
- https://wordpress.org/support/plugin/wp-hydro-raindrop
Please make sure to obey the WP code styling by using PHP Code Sniffer with WordPress rules loaded into your IDE. If you want to address an issue/bug, please create an issue first.
For more info on Hydro or MFA and how itβs changing the world, check out the following:
- Hydro's Official Site.
- ProjectHydro.
- Hydro's Medium Blog.
- Hydro MFA Client Side Raindrop API.
- Become a part of the fastest growing Community! Join Hydro Community.
- Are you a developer interested in expanding the Hydro ecosystem and earning bounties? Visit Hydro HCDP Github Page.
- Follow Hydro on Telegram, Facebook, Twitter or Instagram.