Contents x
    Filter by User Agent
    • 13 Nov 2023
    • Print
    • Dark
      Light
    Contents

    Filter by User Agent

    • Updated on 13 Nov 2023
    • Print
    • Dark
      Light
    Article Summary

    WARNING

    User agents can easily be spoofed by attackers. To prevent potential attacks, we recommend not to filter out traffic using user agents.

    If you'd still like to run a test based on a specific user agent, disable this feature after the test. 

    TO define a user agent you want to filter out:

    1. Open the PX_CUSTOM.vcl fie.
    2. Add the required IP as a regex expression using req.http.User-Agent.

    EXAMPLE

    sub px_custom_filter_by_user_agent {
if (req.http.User-Agent ~ {"<User_agents_to_filter>"}) {
set req.http.X-PX-filter-by:ua = "1";
    }
}

    To learn more about custom subroutines, see Customized subroutines.

    TO enable the feature:

    1. Open the PX_CONFIG.vcl file.
    2. Set the px_filter_by_user_agent_enabled value to "true" (enabled). The default is "false" (disabled).
    table px_configs {
  "px_filter_by_user_agent_enabled": "true",
}
    TEST
    1. Send a request that includes the filtered user agent.
    2. Openthe console and search for your request. If you can't find the request, the feature is configured correctly.



    Was this article helpful?
    What's Next