Skip to main content

CAPTCHA guide

Aliyun Captcha

Alibaba Cloud's slider, rotate and click challenges, verified through a signed parameter.

Difficulty: Medium
Risk engineImage puzzle
Exploded concept drawing of how the Aliyun challenge is built

Aliyun Captcha 2.0 (阿里云验证码 2.0) is the CAPTCHA offered by Alibaba Cloud. Alibaba's own sites rely on it, as do many Chinese companies. The widget can show slide, rotate, image-click and word challenges. Instead of a plain token, the server verifies a signed CaptchaVerifyParam.

How to identifyLink to How to identify

  • A hidden CaptchaVerifyParam field
  • A SceneId value in the page source
  • Scripts loaded from o.alicdn.com/captcha-frontend/aliyunCaptcha/
  • Containers with classes like aliyun-captcha or aliyunCaptcha-*
  • Chinese prompts such as "请按住滑块,拖动到最右边" or "请完成以下验证"
  • Verification responses carrying codes like T001, F001 or F002

Common challenge typesLink to Common challenge types

  • Slide: drag the piece into the gap.
  • Rotate: turn the picture to its upright position.
  • Image click: tap the objects or characters requested.
  • Word: type the text shown.

How it worksLink to How it works

  1. The page starts the widget with a SceneId and loads the Aliyun Captcha script.
  2. Once the challenge is solved, the SDK produces CaptchaVerifyParam:
    • V2: a JSON string holding sceneId, certifyId, deviceToken and data.
    • V3: a Base64-encoded string.
  3. The site's backend passes it to Aliyun's verification API through the server SDK (VerifyIntelligentCaptcha or VerifyCaptcha).
  4. The API replies with a code. T001 generally means a pass, while F... codes signal a failure or a risk-based rejection.
  5. The parameter can be used once, expires quickly and is bound to its scene and session.

Free & open-source bypass methodsLink to Free & open-source bypass methods

Tool What it does Success Rate Link
OpenCV template matching Solves slide and rotate tasks from the challenge images 70–90% opencv/opencv-python
PuzzleSolver Locates the slider gap and drags like a person 70–90% vsmutok/Puzzle-Captcha-Solver
YOLOv8 Detects the targets in image-click tasks 80–95% (trained) ultralytics/ultralytics
ddddocr / PaddleOCR Reads word challenges 60–85% sml2h3/ddddocr · PaddlePaddle/PaddleOCR
DrissionPage / Playwright Drives the widget and extracts CaptchaVerifyParam 70–90% g1879/DrissionPage · microsoft/playwright-python

Practical approachLink to Practical approach

  1. Open the page and wait for the Aliyun widget to appear.
  2. Take the challenge images from the network responses rather than from a scaled screenshot.
  3. Solve slide or rotate tasks with OpenCV, and click tasks with an object detector.
  4. Perform the drag or the clicks along a natural path.
  5. Read CaptchaVerifyParam and pass it to the site without delay.
  6. Stay in the same browser session, since the parameter is linked to the device token.

Practical tipsLink to Practical tips

  • V2 and V3 produce different formats. Check which one your target uses first.
  • T001 is the usual pass code, but the full list varies with the API version.
  • A correct parameter can still be turned down when the risk score is high, so session quality counts.
  • certifyId and deviceToken have to come from the same widget instance.
  • Aliyun swaps challenge variants from time to time. Keep a second solver ready.

Skip the solver: let BrowserSolver handle Aliyun

Website AntiBot runs a real browser session with matching TLS, headers, cookies and IP, clears the challenge, and returns the page. You send a URL, you get HTML back.

For education and authorized testing only. Respect the law, privacy, and the terms of the sites you work with. Difficulty labels are editorial estimates. Adapted from the CC0 community field guide on GitHub.