Adding a CAPTCHA Challenge to an Edge Policy

• Console
• CLI
• API

• 1. Open the navigation menu and click Identity & Security. Under Web Application Firewall, click Policies.

     Alternatively, open the Web Application Firewall page and click Policies under Resources.

     The WAF Policies page appears.

  2. Select the Compartment from the list.

     All the WAF policies in that compartment are listed in tabular form.

  3. (Optional) Apply one or more of the following Filters to limit the edge policies displayed:

     • State

     • Name

     • Policy Type: Select Edge Policy.

  4. Click the name of the edge policy for which you want to edit and enable the CAPTCHA challenge. 

     The Details page of the edge policy you selected appears.

  5. Click Bot Management under WAF Policy.

     The Bot Management list appears.

  6. Select the CAPTCHA Challenge tab.
  7. Click Add CAPTCHA Challenge.

     The Add CAPTCHA Challenge dialog box appears.

  8. Complete the following:

     • Title: Enter the text for the CAPTCHA page title.

     • URL Path: Enter the URL path challenged by CAPTCHA.

     • Session Duration (seconds): Enter the number of seconds after which the CAPTCHA challenge cannot be resubmitted to the same user.

     • Header: Enter the text that appears before the CAPTCHA image (for example, "I am not a robot").

     • Footer: Enter the text that will be shown after the CAPTCHA input box and before the submit button.

     • Incorrect CAPTCHA Text: Enter the text that appears when incorrect text is entered (for example, "The CAPTCHA was incorrect. Please try again.").

     • Submit button: Enter the text for the Submit button (for example, "Yes, I am human.").

     • Preview CAPTCHA: Click to view the CAPTCHA as users would see it. Click Edit CAPTCHA to return.

  9. Click Add.

     The CAPTCHA challenge is added to the list.

  Publish your changes for them to take effect. See Publishing Changes.

• Use the oci waas captcha update command and required parameters to add a CAPTCHA challenge to an edge policy:

  Command

  CopyTry It

  oci waas captcha update  --captchas captchas --waas-policy-id waas_policy_ocid [OPTIONS]

  The captchas value is a list of CAPTCHA details. This is a complex type whose value must be valid JSON. The value can be provided as a string on the command line or passed in as a file using the file://path/to/file syntax.

  For a complete list of flags and variable options for CLI commands, see the Command Line Reference.

• Use the UpdateCaptchas operation to add a CAPTCHA challenge.