Skip to main content

AI-Driven BOLA Scenario Discovery


Open the application​

Open your browser and visit: https://<your-tenant>.apisecapps.com


  • Create a new application or open an existing application

  • Click Configure BOLA in the App Model or select BOLA from the sidebar.

    Configure BOLA option in the App Model

  • Click Discovered Flows

    Discovered Flows tab on the BOLA page

  • Click Start AI Analysis

    Start AI Analysis button

  • Wait for the platform to analyze your API and discover endpoint relationships.

  • Review the automatically identified API flows based on your application's endpoints. These flows represent real user interactions and are used to generate BOLA scenarios for testing object-level authorization. Click the BOLA tab to view the generated BOLA scenarios.

    BOLA tab showing generated BOLA scenarios

  • In the Needs Your Attention section, you will see the identified BOLA scenarios that require additional configuration. These scenarios are not yet ready to run in scans because required setup is incomplete. To enable them for scanning, complete the necessary configuration for each scenario.

    Needs Your Attention section listing BOLA scenarios

  • To complete the necessary configuration for the selected scenario, click Select Users

    Select Users button on a BOLA scenario

  • The BOLA Configuration window opens.

    BOLA Configuration window

  • Add Owner and Attacker users and click Save users

    • Adding Owner:
      • In the Owner section, click the Add new user dropdown and select Add new user Add new user dropdown in the Owner section
      • Fill the details and click Save Authentication Save Authentication button for the Owner user
    • Adding Attacker:
      • In the Attacker section, click the Add new user dropdown and select Add new user Add new user dropdown in the Attacker section
      • Fill the details and click Save Authentication Save Authentication button for the Attacker user
      • Click Save Users Save Users button in the BOLA Configuration window
  • Once the scenario is properly configured, it appears in the Active in your scans section, indicating that it is validated, enabled, and actively running in your security tests.

    Configured scenario in the Active in your scans section

  • If a scenario is not properly configured, the Reason column displays details about what is missing or incorrectly configured.

    Reason column showing missing configuration details

  • To view or change the configuration, click Resolve

    Resolve button on a scenario

  • In the BOLA configuration window, click the Configure tab to review missing or incorrectly configured settings.

    Configure tab in the BOLA configuration window

  • In the configuration window, provide the required details to complete the setup, and click Update scenario to save your changes.

    Configuration window with required details and the Update scenario button

  • Once the scenario is validated and properly configured, it appears in the Active in your scans section, indicating that it is enabled and actively running in your security tests.

    Validated scenario in the Active in your scans section

  • To exclude a scenario from scans, turn off the Enable for scan toggle.

    Enable for scan toggle turned off

  • The scenario moves to the Not in scans section.

    Scenario listed in the Not in scans section

  • To delete a scenario, click the Delete icon for the corresponding scenario

    Delete icon for a BOLA scenario

  • Click Confirm to delete the scenario.

    Confirmation dialog for deleting a scenario

  • Verify that the deleted scenario no longer appears in the list.

    Scenario list after deletion

note

If an instance doesn't need BOLA, select Skip on the Configure BOLA step. To configure it later, select Unskip, or configure BOLA from the BOLA menu in the sidebar — configuring it unskips the step automatically and updates the App Model percentage.