setUserAgentAction

Description

Change the User-AgentThis action is used to change the User-Agent header of the request from a list of built-in user-agent values.

Evaluation scope

Evaluation scope defines the timing where this filter will be applied.

{.alert .alert-info} ::: requestHeaderReceivedFromClient This scope occurs the moment fluxzy parsed the request header receiveid from client :::

YAML configuration name

setUserAgentAction

Settings

The following table describes the customizable properties available for this action:

{.property-table .property-table-action} ::: | Property | Type | Description | DefaultValue | | :------- | :------- | :------- | -------- | | name | string | | |

:::

Example of usage

The following examples apply this action to any exchanges

Change User-Agent to Android_Chrome (Mozilla/5.0 (Linux; Android 14; RMX3999 Build/UP1A.231005.007; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/124.0.6367.152 Mobile Safari/537.36).

rules:
- filter:
    typeKind: AnyFilter
  actions:
  - typeKind: SetUserAgentAction
    name: Android_Chrome

Change User-Agent to iOS_Safari (Mozilla/5.0 (iPhone; CPU iPhone OS 16_4 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Mobile/15E148 Safari/604.1).

rules:
- filter:
    typeKind: AnyFilter
  actions:
  - typeKind: SetUserAgentAction
    name: iOS_Safari

Change User-Agent to Linux_Chrome (Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36).

rules:
- filter:
    typeKind: AnyFilter
  actions:
  - typeKind: SetUserAgentAction
    name: Linux_Chrome

Change User-Agent to Linux_Edge (Mozilla/5.0 (Wayland; Linux x86_64; System76 Galago Pro (galp2)) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36 Ubuntu/24.04 Edg/122.0.2365.92).

rules:
- filter:
    typeKind: AnyFilter
  actions:
  - typeKind: SetUserAgentAction
    name: Linux_Edge

Change User-Agent to Linux_Firefox (Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:122.0) Gecko/20100101 Firefox/122.0).

rules:
- filter:
    typeKind: AnyFilter
  actions:
  - typeKind: SetUserAgentAction
    name: Linux_Firefox

Change User-Agent to macOS_Chrome (Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36).

rules:
- filter:
    typeKind: AnyFilter
  actions:
  - typeKind: SetUserAgentAction
    name: macOS_Chrome

Change User-Agent to macOS_Edge (Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36 Edg/124.0.0.11.3).

rules:
- filter:
    typeKind: AnyFilter
  actions:
  - typeKind: SetUserAgentAction
    name: macOS_Edge

Change User-Agent to macOS_Firefox (Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:125.0) Gecko/20100101 Firefox/125.0).

rules:
- filter:
    typeKind: AnyFilter
  actions:
  - typeKind: SetUserAgentAction
    name: macOS_Firefox

Change User-Agent to macOS_Safari (Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.1.2 Safari/605.1.15).

rules:
- filter:
    typeKind: AnyFilter
  actions:
  - typeKind: SetUserAgentAction
    name: macOS_Safari

Change User-Agent to Windows_Chrome (Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36).

rules:
- filter:
    typeKind: AnyFilter
  actions:
  - typeKind: SetUserAgentAction
    name: Windows_Chrome

Change User-Agent to Windows_Edge (Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36 Edg/124.0.0.11.3).

rules:
- filter:
    typeKind: AnyFilter
  actions:
  - typeKind: SetUserAgentAction
    name: Windows_Edge

Change User-Agent to Windows_Firefox (Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:125.0) Gecko/20100101 Firefox/125.0).

rules:
- filter:
    typeKind: AnyFilter
  actions:
  - typeKind: SetUserAgentAction
    name: Windows_Firefox

.NET reference

View definition of SetUserAgentAction for .NET integration.

See also

The following actions are related to this action: