Manual Chapter :
Configuring Bot Defense in Standard Service Level
Applies To:
Show VersionsBIG-IP Distributed Cloud Services
- 17.1.2, 17.1.1, 17.1.0
Configuring Bot Defense in Standard Service Level
Configuring Bot Defense in Standard service level for web
Before configuring Bot Defense you need to configure a Proxy pool or Protection pool, or select an existing pool during configuration. For more information, refer to BIG-IP Local Traffic Management: Basics - Introduction to pools.
Use this task to configure Bot Defense in Standard service level for protecting web pages.
The screen elements described here are for basic configuration. Refer to the help text available in the configuration utility for details about all the fields.
- On the Main tab, click.The BD Profiles screen displays the list of Bot Defense profiles on the system.
- Click theCreatebutton.The New BD Profile screen opens.
- In the General Properties section, enter the following details:
- In theProfile Namefield, enter a unique name for the Bot Defense profile.
- In theParent Profilefield, select the Bot Defense parent profile from which this profile will inherit settings.
- For theService Levelfield, selectStandard.
- For theApplication Typefield, checkWeb.
- In the API Request Settings section, in theImport API Settingsfield, checkUpload Fileand click theChoose Filebutton to import a JSON file with predefined values or checkPaste Textto enter the JSON file content. The contents of the file must be in a valid JSON format.
- In the JS Insertion Configuration section, theBIG-IP Handles JS Injectionsfield is checked by default, if you uncheck the field then follow theNotegiven in the Web UI.
- In the Protected Endpoint - Web section, in theProtected URIsfield, enter the following details and click theAddbutton:TheMitigation Handlerfield is available for update only in the Advanced service level.TheGET (Document)field is checked only when the Bot Defense is required for web scraping.
- In theHostfield, enter the hostname or IP address of the web page to be protected by the Bot Defense.
- In thePathfield, enter the path to the web page.
- Check theANY Methodfield to protect the path when it has any method.You must check (enable) at least one of the methods orANY Methodfield, else, the HTTP requests will not be routed.
- Check theGET (XHR/Fetch)field to protect the path when it has a GET method.
- Check thePOSTfield to protect the path when it has a POST method.
- Check thePUTfield to protect the path when it has a PUT method.
- In theMitigation Actionfield, choose the mitigation action you want the BIG-IP to take if a malicious HTTP request is detected on the path.
Click theAddbutton to add the URI. You can add multiple URIs, use theEditandDeletebuttons to update or delete a URI from the list. - In the Advanced Features section, selectAdvanced, enter the following details:
- Check theUse Proxyfield if you want the data to be routed through a proxy server, else uncheck this field to send data directly from the BIG-IP to the Bot Defense backend server.
- In theProxy Poolfield, select an existing pool or click the+button to add a new pool.TheProxy Poolfield is displayed when theUse Proxyfield is checked.
- In theProxy Bot Protection Endpoint URLfield, enter the web URL that is used to redirect HTTP requests to the Bot Defense backend server.TheProxy Bot Protection Endpoint URLfield is displayed when theUse Proxyfield is checked.
- In theProtection Poolfield, select an existing pool or click the+button to create a new pool. If you click the+button, the pool configuration screen appears. In the pool configuration screen, create a new pool using the IP or domain of the bot server. When you clickFinishin the pool configuration screen, you return to the BD Profile screen.TheProtection Poolfield is displayed when theUse Proxyfield is unchecked.While creating a pool, ensure to manually select an applicable FQDN based on location, following are a few examples:
- Selectibd-webemea2.fastcache.netfor EMEA.
- Selectibd-webus.fastcache.netfor US.
- Selectibd-webapcj.fastcache.netfor APCJ.
- In theSSL Profilefield, select the server-side SSL profile.
- Check theCORS Supportfield to let the Cross-Origin Resource Sharing (CORS) protocol to allow the restricted resources on a web page to be requested from another domain outside the domain from which the first resource was served.
- Check theReport Transaction Resultfield to enable reporting the transaction results to improve bot defense.
- Click theFinishedbutton.The Bot Defense profile is created.
Assign the Bot Defense profile to Virtual Server, refer to Assigning a Bot Defense profile to Virtual Server.
Configuring Bot Defense in Standard service level for web scraping
Before configuring the Bot Defense for web scraping (interstitial), configure the Bot Defense profile in Standard service level for web and update the
Protected URIs
field, refer to Configuring Bot Defense in Standard service level for web.Use this task to configure the Bot Defense in Standard service level for protecting traffic from web scraping.
- On the Main tab, click.The BD Profiles screen displays the list of Bot Defense profiles on the system.
- Click the Bot Defense profile for which web scraping is configured.
- In the Protected Endpoint - Web section, in theProtected URIsfield, enter the following details and click theAddbutton:TheMitigation Handlerfield is available for update only in the Advanced service level.
- In theHostfield, enter the hostname or IP address of the web page to be protected by the Bot Defense.
- In thePathfield, enter the path to the web page.
- Check theGET (Document)field to protect the path from web scrapping.When you check (enable) GET (Document) no other method can be enabled.
- In theMitigation Actionfield, choose the mitigation action you want the BIG-IP to take if a malicious HTTP request is detected on the path.
Click theAddbutton to add URI. You can add multiple URIs, use theEditandDeletebuttons to update or delete a URI from the list. - Click theUpdatebutton.
Configuring Bot Defense in Standard service level for mobile
Before configuring Bot Defense you need to configure a Proxy pool or Protection pool, or select an existing pool during configuration. For more information, refer to BIG-IP Local Traffic Management: Basics - Introduction to pools.
Use this task to configure the Bot Defense in Standard service level for mobile applications. If you want to configure the Bot Defense for both mobile and web in the same profile, then in
Application Type
field, check Web
and Mobile
and configure respective screen elements. Use Configuring Bot Defense in Standard service level for web task for reference.The screen elements described here are for basic configuration. Refer to the help text available in the configuration utility for details about all the fields.
- On the Main tab, click.The BD Profiles screen displays the list of Bot Defense profiles on the system.
- Click theCreatebutton.The New BD Profile screen opens.
- In the General Properties section, enter the following details:
- In theProfile Namefield, enter a unique name for the Bot Defense profile.
- In theParent Profilefield, select the Bot Defense parent profile from which this profile will inherit settings.
- For theService Levelfield, selectStandard.
- For theApplication Typefield, checkMobile. TheWebis checked by default, you can uncheckWebif the Bot Defense profile is only used to protect mobile application. You can leave theWebas checked, if the Bot Defense profile is used to protect both web page and mobile application.
- In the API Request Settings section, in theImport API Settingsfield, checkUpload Fileand click theChoose Filebutton to import a JSON file with predefined values or checkPaste Textto enter the JSON file content. The contents of the file must be in a valid JSON format.
- In the Protected Endpoint - Mobile section, enter the following details:TheMitigation Handlerfield is available for update only in the Advanced service level.
- In theProtected URIsfield, enter the following details and click theAddbutton:
- In theHostfield, enter the hostname or IP address of the mobile application to be protected by the Bot Defense.
- In thePathfield, enter the path to the mobile application.
- Check theANY Methodfield to protect the path when it has any method.You must check (enable) at least one of the methods orANY Methodfield, else, the HTTP requests will not be routed.
- Check theGETfield to protect the path when it has a GET method.
- Check thePOSTfield to protect the path when it has a POST method.
- Check thePUTfield to protect the path when it has a PUT method.
- Use theCheck Mobile Identifierfield if the URL is same for web and mobile, selectHeaderto request the information, or selectSkipto ignore.
- In theMitigation Actionfield, choose the mitigation action you want the BIG-IP to take if a malicious HTTP request is detected on the endpoint.
Click theAddbutton to add the URI. You can add multiple URIs, use theEditandDeletebuttons to update or delete a URI from the list. - In theSDK Reload Headernamefiled, enter the reload header prefix.
- In theSDK Config Fetch URL - Androidfield, enter the URL to fetch SDK configuration for Android.
- In theSDK Config Fetch URL - iOSfield, enter the URL to fetch SDK configuration for iOS.
- In the Advanced Features section, selectAdvanced, enter the following details:
- Check theUse Proxyfield if you want the data to be routed through a proxy server, else uncheck this field to send data directly from the BIG-IP to the Bot Defense backend server.
- In theProxy Poolfield, select an existing pool or click the+button to add a new pool.TheProxy Poolfield is displayed when theUse Proxyfield is checked.
- In theProxy Bot Protection Endpoint URL - Mobilefield, enter the application URL that is used to redirect HTTP requests to the Bot Defense backend server.TheProxy Bot Protection Endpoint URL - Mobilefield is displayed when theUse Proxyfield is checked.
- In theProtection Pool - Mobilefield, select an existing pool or click the+button to add a new pool. If you click the+button, the pool configuration screen appears. In the pool configuration screen, create a new pool using the IP or domain of the bot server. When you clickFinishin the pool configuration screen, you return to the BD Profile screen.TheProtection Pool - Mobilefield is displayed when theUse Proxyfield is unchecked.While creating a pool, ensure to manually select an applicable FQDN based on location, following are a few examples:
- Selectibd-webemea2.fastcache.netfor EMEA.
- Selectibd-webus.fastcache.netfor US.
- Selectibd-webapcj.fastcache.netfor APCJ.
- In theSSL Profilefield, select the server-side SSL profile.
- Check theCORS Supportfield to let the Cross-Origin Resource Sharing (CORS) protocol to allow the restricted resources on a web page to be requested from another domain outside the domain from which the first resource was served.
- Check theReport Transaction Resultfield to enable reporting the transaction results to improve bot defense.
Assign the Bot Defense profile to Virtual Server, refer to Assigning a Bot Defense profile to Virtual Server.