reCAPTCHA Bypass

Overview

reCAPTCHA is Google’s bot detection system that presents challenges to verify human users. When Stably encounters reCAPTCHA during automated testing, it can block test execution. This often happens during the login or signup flow.

Solutions

There are a number of solutions to work around this that might fit your needs.

Solution 1: Disable for testing

If you have non-production deployments, such as staging or preview deployments, these are ideal for testing. The easiest solution in these cases is to simply have your dev team disable reCAPTCHA for these environments

Solution 2: IP Allowlisting

If you need to test against production or cannot disable reCAPTCHA in your staging/development environment, you can allowlist Stably’s IP addresses. For the list of IPs, see our Stably IP Allowlist documentation. There are two main ways to implement this:

IP Allowlisting: reCAPTCHA Enterprise

If you are on reCAPTCHA’s enterprise plan, you can follow their instructions using our Stably IP Allowlist

IP Allowlisting: Self-managed allowlisting

If you do not have reCAPTCHA Enterprise then you can instead implement allowlisting yourself in code. The implementation will of course differ, but it will look something like:

const allowlistedIPs = ['44.227.156.59', '44.226.77.61'];
const clientIP = (req.headers['x-forwarded-for'] || req.connection.remoteAddress || '').split(',')[0].trim();

if (allowlistedIPs.includes(clientIP)) {
  // Skip reCAPTCHA validation
} else {
  // Proceed with reCAPTCHA validation
}

For the latest allowlist, please see our Stably IP Allowlist.

Getting started

Stably Web Editor

Stably CLI

Stably Cloud Runner

Stably SDK

Stably Test Reporter

Configuration

Troubleshooting

Migration Guides

Resources

Overview

Solutions

Solution 1: Disable for testing

Solution 2: IP Allowlisting

IP Allowlisting: reCAPTCHA Enterprise

IP Allowlisting: Self-managed allowlisting

​Overview

​Solutions

​Solution 1: Disable for testing

​Solution 2: IP Allowlisting

​IP Allowlisting: reCAPTCHA Enterprise

​IP Allowlisting: Self-managed allowlisting

Overview

Solutions

Solution 1: Disable for testing

Solution 2: IP Allowlisting

IP Allowlisting: reCAPTCHA Enterprise

IP Allowlisting: Self-managed allowlisting