Fortinet white logo
Fortinet white logo

CLI Reference

system captcha-puzzle

system captcha-puzzle

Use this command to configure the difficulty level of Puzzle CAPTCHA challenges used in bot confirmation workflows. Puzzle CAPTCHA presents an image-based challenge that requires human interaction and helps prevent access by bots and headless browsers.

This command controls the system-wide difficulty setting for all Puzzle CAPTCHA challenges. Higher difficulty levels reduce the visual contrast between the puzzle piece and the background image, making the challenge harder for bots. The image content itself is not customizable.

To use this command, your administrator account’s access control profile must have both r and w permissions to items in the admingrp category.

Syntax

config system captcha-puzzle

set captcha-puzzle-difficulty-level {easy | medium | hard}

end

Variable Description Default
captcha-puzzle-difficulty-level {easy | medium | hard}

Specifies the visual complexity of the Puzzle CAPTCHA challenge:

  • easy: The puzzle piece contains clearly identifiable elements (e.g., bright colors or unique shapes), making alignment intuitive.

  • medium: The puzzle piece contains more ambiguous color gradients and less distinct borders, requiring more attention to context. This is the default difficulty.

  • hard: The puzzle piece includes subtle visual textures (e.g., blur, shadow, or partial occlusion) with few obvious visual anchors, increasing difficulty for bots and humans alike.

medium

system captcha-puzzle

system captcha-puzzle

Use this command to configure the difficulty level of Puzzle CAPTCHA challenges used in bot confirmation workflows. Puzzle CAPTCHA presents an image-based challenge that requires human interaction and helps prevent access by bots and headless browsers.

This command controls the system-wide difficulty setting for all Puzzle CAPTCHA challenges. Higher difficulty levels reduce the visual contrast between the puzzle piece and the background image, making the challenge harder for bots. The image content itself is not customizable.

To use this command, your administrator account’s access control profile must have both r and w permissions to items in the admingrp category.

Syntax

config system captcha-puzzle

set captcha-puzzle-difficulty-level {easy | medium | hard}

end

Variable Description Default
captcha-puzzle-difficulty-level {easy | medium | hard}

Specifies the visual complexity of the Puzzle CAPTCHA challenge:

  • easy: The puzzle piece contains clearly identifiable elements (e.g., bright colors or unique shapes), making alignment intuitive.

  • medium: The puzzle piece contains more ambiguous color gradients and less distinct borders, requiring more attention to context. This is the default difficulty.

  • hard: The puzzle piece includes subtle visual textures (e.g., blur, shadow, or partial occlusion) with few obvious visual anchors, increasing difficulty for bots and humans alike.

medium