Cordova plugin for integrating the SafetyNet Recaptcha API in your Android and Browser platforms.
- Android
- Browser
- Supports legacy reCAPTCHA v2 site keys for Android and Web
| Plugin version | Cordova | Cordova Android | minSdkVersion | SafetyNet |
|---|---|---|---|---|
| 1.0.0 | >= 10.0.0 | >= 8.0.0 | >= 19 | 18.0.1 |
cordova plugin add cordova-plugin-recaptcha-v2Install latest version with custom Play Services SafetyNet version
cordova plugin add cordova-plugin-recaptcha-v2 --variable PLAY_SERVICES_SAFETYNET_VERSION=18.0.1 cordova plugin add https://github.com/andreszs/cordova-plugin-recaptcha-v2⚠ Note that using Play Services SafetyNet 18.1.0 or newer will enforce a minSdk level of 21, while 18.0.1 still works with minSdk 19.
To invoke the SafetyNet reCAPTCHA API, you call the verify() method. Usually, this method corresponds to the user's selecting a UI element, such as a button, in your activity.
cordova.plugins.Recaptcha.verify(onSuccess, onFailure, [args])| args | Object with siteKeyAndroid and optional siteKeyWeb strings |
|---|---|
| siteKeyAndroid | String: A v2 Android site key from the v3 Admin Console. Required for the Android platform. |
| siteKeyWeb | String: A v2 Invisible site key from the v3 Admin Console. Optional for the browser platform. |
⚠ As of 2024, you can no longer create new Android site keys from the legacy v3 Admin Console, but you can add your app's package name to existing v2 Android keys and reuse them in any app. This is because the SafetyNet Recaptcha API has been deprecated in favor of the Recaptcha Enterprise API. Note that Enterprise keys do not work with SafetyNet Recaptcha API.
- reCAPTCHA response token
When the reCAPTCHA API executes the onSuccess() method, the user has successfully completed the CAPTCHA challenge. However, this method only indicates that the user has solved the CAPTCHA correctly. You still need to validate the user's response token from your backend server.
To learn how to validate the user's response token, see Verifying the user's response.
var onSuccess = function (strToken) {
console.log(strToken);
};
var onFailure = function (strError) {
console.warn(strError);
};
var args = {};
args.siteKeyAndroid = YOUR_V2_ANDROID_SITE_KEY;
args.siteKeyWeb = YOUR_V2_INVISIBLE_SITE_KEY;
cordova.plugins.Recaptcha.verify(onSuccess, onFailure, args);
- First version
- Tested on Android 4.4 and up
- Tested on browser platform