Citrix Application Delivery Management service


A bot is a software program that automatically performs certain actions over and over at a much faster rate than a human. Over 35 percent of your web traffic comprises bots and 80 percent of organizations suffer from bot attacks. They can interact with a webpage, submit forms, click links, scan text, or download content. Bots can even access videos, post comments, and tweet on social media platforms. Some bots can even hold basic conversations with human users. These bots are known as chatbots.

A bot that performs a needful or helpful service such as customer service, chatbots, search engine crawlers are known as good bots. Some malicious bots can scrape or download content from a website, steal user credentials, spread spam content, and perform various other kinds of cyberattacks. These malicious bots are known as bad bots. It is essential to identify bad bots and protect your appliance from advanced security attacks. You can achieve this using a bot management system.

For more information on Bot, see Bot Management.

Configure Bot detection techniques in Citrix ADC

In Citrix ADC, you can configure bot detection techniques to detect the incoming bot traffic. The following are the bot techniques that you configure in Citrix ADC instance:

  • Allow List. This rule has a list of URLs and policy expressions to evaluate if a specific set of good bots that can access to your web resource.

  • Block List. This rule has a list of URLs and policy expressions to evaluate if a specific set of bad bots can access your website.

  • IP reputation. This rule detects if the incoming bot traffic is a malicious IP address.

  • Device fingerprinting. This rule detects if the incoming bot traffic has device fingerprint ID in the incoming request header and browser attributes of an incoming client bot traffic.

  • Rate limiting. This rule rate limits multiple requests coming from the same client.

  • Signatures. This rule detects and blocks bots based on signature detection. It also prevents unauthorized URLs that scrape websites, brute forcing logins, and bots that probe for vulnerabilities.

  • Bot traps. This rule detects bots accessing the script that is enabled on the webpage.

  • TPS. This rule detects the incoming traffic as bots if the maximum requests and the percentage increase in requests exceed the configured time interval.

For more information on configuring Bot management, see Configure Bot management.

Use Bot Insight in Citrix ADM

After you configure the bot management in Citrix ADC, you must enable Bot Insight on virtual servers to view insights in Citrix ADM.

To enable Bot Insight:

  1. Navigate to Networks > Instances > Citrix ADC and select the instance type. For example, VPX.

  2. Select the instance and from the Select Action list, select Configure Analytics.

  3. Select the virtual server and click Enable Analytics.

  4. On the Enable Analytics window:

    1. Select Bot Insight

    2. Under Advanced Option, select Logstream.


    3. Click OK.

After enabling Bot Insight, navigate to Analytics > Security > Bot Insight.


1 - Time list to view bot details

2 – Drag the slider to select a specific time range and click Go to display the customized results

3 – Total instances affected from bots

4 – Virtual server for the selected instance with total bot attacks

  • Total Bots – Indicates the total bot attacks (inclusive of all bot categories) found for the virtual server.

  • Total Human Browsers – Indicates the total human users accessing the virtual server.

  • Bot Human Ratio – Indicates the ratio between human users and bots accessing the virtual server.

  • Signature Bots, Fingerprinted Bot, Rate Based Bots, IP Reputation Bots, allow list Bots, and block list Bots – Indicates the total bot attacks occurred based on the configured bot category. For more information about bot category, see Configure Bot detection techniques in Citrix ADC.

5 - Click > to view bot details in a graph format.


View events history

You can view the bot signature updates in the Events History, when:

  • New bot signatures are added in Citrix ADC instances.

  • Existing bot signatures are updated in Citrix ADC instances.

You can select the time duration in bot insight page to view the events history.

Events history

The following diagram shows how the bot signatures are retrieved from AWS cloud, updated on Citrix ADC and view signature update summary on Citrix ADM.

Events scheduler

  1. The bot signature auto update scheduler retrieves the mapping file from the AWS URI.

  2. Checks the latest signatures in the mapping file with the existing signatures in ADC appliance.

  3. Downloads the new signatures from AWS and verifies the signature integrity.

  4. Updates the existing bot signatures with the new signatures in the bot signature file.

  5. Generates an SNMP alert and sends the signature update summary to Citrix ADM.

View bots

Click the virtual server to view the Application Summary


1 – Provides the Application Summary details such as:

  • Average RPS – Indicates the average bot transaction requests per second (RPS) received on virtual servers.

  • Bots by Severity – Indicates the highest bot transactions occurred based on the severity. The severity is categorized based on Critical, High, Medium, and Low.

    For example, if the virtual servers have 11770 high severity bots and 1550 critical severity bots, then Citrix ADM displays Critical 1.55 K under Bots by Severity.

  • Largest Bot Category – Indicates the highest bot attacks occurred based on the bot category.

    For example, if the virtual servers have 8000 block listed bots, 5000 allow listed bots, and 10000 Rate Limit Exceeded bots, then Citrix ADM displays Rate Limit Exceeded 10 K under Largest Bot Category.

  • Largest Geo Source – Indicates the highest bot attacks occurred based on a region.

    For example, if the virtual servers have 5000 bot attacks in Santa Clara, 7000 bot attacks in London, and 9000 bot attacks in Bangalore, then Citrix ADM displays Bangalore 9 K under Largest Geo Source.

  • Average % Bot Traffic – Indicates the human bot ratio.

2 – Displays severity of the bot attacks based on locations in map view

3 – Displays the types of bot attacks (Good, Bad, and All)

4 – Displays the total bot attacks along with the corresponding configured actions. For example, if you have configured:

  • IP address range ( to as block list bots and selected Drop as an action for these IP address ranges

  • IP range ( to as block list bots and selected to create Log message as an action for these IP ranges

    In this scenario, Citrix ADM displays:

    • Total block listed bots

    • Total bots under Dropped

    • Total bots under Log

View CAPTCHA bots

In webpages, CAPTCHAs are designed to identify if the incoming traffic is from a human or an automated bot. To view the CAPTCHA activities in Citrix ADM, you must configure CAPTCHA as a bot action for IP reputation and device fingerprint detection techniques in a Citrix ADC instance. For more information, see Configure Bot management.

The following are the CAPTCHA activities that Citrix ADM display in Bot insight:

  • Captcha attempts exceeded – Denotes the maximum number of CAPTCHA attempts made after login failures

  • Captcha client muted – Denotes the number of client requests are dropped or redirected because these requests were detected as bad bots earlier with the CAPTCHA challenge

  • Human – Denotes the captcha entries performed from the human users

  • Invalid captcha response – Denotes the number of incorrect CAPTCHA responses received from the bot or human, when Citrix ADC sends a CAPTCHA challenge

    Bot captcha

View bot traps

To view bot traps in Citrix ADM, you must configure the bot trap in Citrix ADC instance. For more information, see Configure Bot management.

Bot traps

To identify the bot trap, a script is enabled in webpage and this script is hidden from human, but not to bots. Citrix ADM identifies and reports the bot traps, when this script is accessed by bots.

Click the virtual server and select Zero Pixel Request

Bot trap

View TPS bots

The following are the TPS bot categories that you can view in Citrix ADM:

  • Source IP

  • Geo location

  • Host

  • URL

Click the virtual server to view the TPS bots.

TPS bots

Click the TPS bot category to view the bot details.

TPS bot category

The details page is displayed.

TPS bot details

View bot categories for mobile (Android) applications

To view the bots for mobile (Android) applications, you must configure the fingerprint detection technique in Citrix ADC. For more information, see Configure device fingerprint technique for mobile applications.

After you configure the settings in Citrix ADC, you can view the following bot categories in Citrix ADM:

  • Web Client Rate Limit

  • Android Rate Limit

  • Web Client Device

  • Android Device

Click the virtual server to view the bot categories applicable for mobile application.

Android bots

View bot details

For further details, click the bot attack type under Bot Category.

The details such as attack time and total number of bot attacks for the selected captcha category are displayed.

Bot drill-down

You can also drag the bar graph to select the specific time range to be displayed with bot attacks.


To get additional information of the bot attack, click to expand.


  • Instance IP – Indicates the Citrix ADC instance IP address

  • Total Bots – Indicates the total bot attacks occurred for that particular time

  • HTTP Request URL – Indicates the URL that is configured for captcha reporting

  • Country Code – Indicates the country where the bot attack occurred

  • Region – Indicates the region where the bot attack occurred

  • Profile Name – Indicates the profile name that you provided during the configuration

You can also use the search text box and time duration list, where you can view bot details as per your requirement. When you click the search box, the search box gives you the following list of search suggestions.

  • Instance-IP – Citrix ADC instance IP address

  • Client-IP – Client IP address

  • Bot-Type – Bot type such as Good or Bad

  • Severity – Severity of the bot attack

  • Action-Taken – Action taken after the bot attack such as Drop, No action, Redirect

  • Bot-Category – Category of the bot attack such as block list, allow list, fingerprint, and so on. Based on a category, you can associate a bot action to it

  • Bot-Detection – Bot detection types (block list, allow list, and so on) that you have configured on Citrix ADC instance

  • Location – Region/country where the bot attack has occurred

  • Request-URL – URL that has the possible bot attacks

You can also use operators in your search queries to narrow the focus of your search. For example, if you want to view all bad bots:

  1. Click the search box and select Bot-Type

  2. Click the search box again and select the operator =

  3. Click the search box again and select Bad

  4. Click Search to display the results