Human Challenge - Integration Testing Process

Introduction

In order to ensure that Human Challenge was integrated correctly, it is recommended that the following test scenarios be executed. While the amount of test scenarios is small, there are some caveats to note in each one to ensure that it is indeed repeatable and possible to automate as well.

Test Scenarios

In each case mentioned below, the following scenarios should be tested:

Successful Attempt:

  1. Create a Captcha Bypass Token (this only needs to happen once and can be reused across multiple executions).
  2. To ensure the challenge is presented, add a User-Agent: HeadlessChrome header to the request.
  3. Render the page which has the challenge embedded (e.g. the built-in block page, a customized block page or a challenge rendered via Advanced Blocking Response (ABR).
  4. After the challenge is rendered, add an x-px-captcha-testing: <captcha-bypass-token> header to the request with the bypass token generated in step (a).
  5. Solve the challenge by clicking / tapping on it until the bar is full and then release it.
  6. Observe that you can continue with the process the challenge was displayed for (e.g. login).

Failed Attempt:

  1. To ensure the challenge is presented, add a User-Agent: HeadlessChrome header to the request.
  2. Render the page which has the challenge embedded (e.g. the built-in block page, a customized block page or a challenge rendered via Advanced Blocking Response (ABR).
  3. Solve the challenge by clicking / tapping on it until the bar is full and then release it.
  4. Observe that you got another challenge.

We recommend that, at a minimum, the following setups be tested in this manner to ensure that the integration was done correctly:

  • Web - browser based.
  • Mobile - browser based.
  • Mobile SDK - iOS (if relevant).
  • Mobile SDK - Android (if relevant).

Q&A and Troubleshooting

My development and testing process does not allow me to manipulate headers, how can I test this flow?

If you are unable to use the header manipulation flow mentioned above, we recommend you use the mobile verification flow and our VID extraction tool. Keep in mind that this flow can not be automated and is only applicable for manual testing.

I waited for the bar to fill, released the press and the challenge UI is now stuck, not continuing with the process or showing an animation endlessly. What is blocking it from moving forward?

In the case of ABR, you will need to override the window._pxOnCaptchaSuccess function and handle both the successful and failed results to trigger the correct step in your code.

I waited for the bar to fill, released the press and got another challenge to solve, what am I doing wrong?

Make sure that you added the Captcha Bypass Token before solving the challenge. This will ensure that our system ignores all detections and allows the challenge to be solved.

I managed to get the integration to work via web and browser, but the mobile integration keeps showing me challenges, what could be the cause?

In the case of the mobile SDK, the correct function to override in customized pages is _pxOnMobileCaptchaSuccess, as can be seen in the documentation here. Make sure that you properly implement this function and retest.

I keep getting challenges when testing through a mobile emulator as a part of my development process, how can I bypass this?

Some of our detections block emulator based solves. To make sure these pass successfully, x-px-captcha-testing header to the request.

While using Chrome’s DevTool emulator I am forced to solve the challenge repeatedly?

Unfortunately, Chrome’s DevTool emulator does not behave 100% like a mobile device and is not recommended for testing of Human Challenge.

No matter what I do I pass the challenge, is it not working as expected?

Make sure that the User-Agent: HeadlessChrome header is a part of the request, and that the x-px-captcha-testing is not. If you solved the challenge in the last few minutes, be sure to clear your cookies and add a random string to the User-Agent header (e.g. User-Agent: HeadlessChrome-1) or wait 5-10 minutes for the challenge solve to expire.

If none of the answers above helps solve the issue you are experiencing, please contact us on our shared slack channel and our team will be happy to provide additional assistance.


Did this page help you?