feedback

Author: patriciasantaana

src/content/docs/api-shield/management-and-monitoring/endpoint-labels.mdx

@@ -71,7 +71,7 @@ Cloudflare automatically runs risk scans every 24 hours on your saved endpoints.
 
 `cf-risk-bola-enumeration`: Automatically added when an endpoint experiences successful responses with drastic differences in the number of unique elements requested by different user sessions.
 
-`cf-risk-bola-pollution`: Automatically added when an endpoint experiences successful responses where parameters are found in multiple places in the request.
+`cf-risk-bola-pollution`: Automatically added when an endpoint experiences successful responses where parameters are found in multiple places in the request, as opposed to what is expected from the API's schema.
 
 :::note
 Cloudflare will only add authentication labels to endpoints with successful response codes. Refer to the below table for more details.

src/content/docs/api-shield/security/bola-attack-detection.mdx

@@ -13,7 +13,7 @@ import { Badge } from "~/components";
 
 A Broken Object Level Authorization (BOLA) attack is where an application or API fails to properly verify if a user has permission to access specific private data.
 
-Bugs in the application or API allow attackers to bypass authorization checks and access sensitive information by manipulating and iterating through object identifiers
+Bugs in the application or API allow attackers to bypass authorization checks and access sensitive information by manipulating and iterating through object identifiers.
 
 Vulnerabilities can occur at any time, including in the original application's deployment. However, changes or upgrades to authentication and authorization policies can also introduce these bugs.
 
@@ -25,10 +25,12 @@ Cloudflare labels endpoints with BOLA risk when we detect two distinct signals c
 
     This behavior may be indicative of attackers trying to confuse the API’s authorization system and bypass security controls.
 
-- **Enumeration**: Cloudflare detects anomalies where one or more sessions makes successful requests to any one API endpoint changing variable values out of the norm, trying to get information from the API. 
+- **Enumeration**: Cloudflare detects anomalies where one or more sessions makes successful requests to any one API endpoint that changes variable values trying to get information from the API. 
 
 :::note
 Sessions that have more random behavior or repetition have a higher chance of triggering an alert. 
+
+The BOLA enumeration label requires an endpoint to have seen at least 10,000 sessions before being eligible for outlier detection.
 :::
 
 ## Examples
@@ -49,18 +51,14 @@ Sessions that have more random behavior or repetition have a higher chance of tr
 
 ## Process
 
-For beta customers, API Shield searches for and highlights BOLA attacks on your APIs. Cloudflare learns visitor traffic patterns over time to know when API access to specific objects is likely a Broken Object Level Authorization enumeration attack. We inform you what API endpoints are being targeted by automatically labeling them using the following risk labels:
+For beta customers, API Shield searches for and highlights BOLA attacks on your APIs. Cloudflare learns visitor traffic patterns over time to know when API access to specific objects is likely a BOLA enumeration attack. We inform you what API endpoints are being targeted by automatically labeling them using the following risk labels:
 
 `cf-risk-bola-enumeration`: Automatically added when an endpoint experiences successful responses with drastic differences in the number of unique elements requested by different user sessions.
 
-`cf-risk-bola-pollution`: Automatically added when an endpoint experiences successful responses where parameters are found in multiple places in the request.
+`cf-risk-bola-pollution`: Automatically added when an endpoint experiences successful responses where parameters are found in multiple places in the request, as opposed to what is expected from the API's schema.
 
 If you see one of these labels on your API endpoints, check its authorization policy with your developer team to find any authorization bugs. Additionally, you can reach out to Cloudflare for a customized report about the behavior, including attacker identifiers that you can use to confirm attack reach and impact.
 
 ## Availability
 
-BOLA attack detection is available in a closed beta. Contact your account team if you are interested in BOLA attack detection for your API.
-
-## Limitations
-
-The BOLA enumeration label requires an endpoint to have seen at least 10,000 sessions before being eligible for outlier detection.
+BOLA attack detection is available in a closed beta. Contact your account team if you are interested in BOLA attack detection for your API.