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: