Skip to content

Document the Under Attack Mode UI - #207

Open
DexterIA wants to merge 2 commits into
cloudlinux:masterfrom
DexterIA:DEF-51753-uam-ui-docs
Open

Document the Under Attack Mode UI#207
DexterIA wants to merge 2 commits into
cloudlinux:masterfrom
DexterIA:DEF-51753-uam-ui-docs

Conversation

@DexterIA

@DexterIA DexterIA commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

Summary
Documents the WebShield Under Attack Mode user interface. The feature already had a CLI-oriented page at /features/under_attack_mode/; this adds the UI half and links the two together instead of duplicating the description.

Admin Interface — a new ## WebShield section with an ### Under Attack Mode subsection: the service switches, the URL tester, the rules table, the rule dialog, path scoping with the full condition table, and how an administrator sees rules owned by end users. The WebShield → Under Attack Mode nesting leaves room for the further WebShield tabs that are coming.
User Interface — the same structure for site owners, shorter, pointing at the admin section and the feature page for the details.
Under Attack Mode (UAM) feature page — brought in line with WebShield 1.47, since the new UI sections link into it: site-owner support and the visibility switch, domain wildcards, the wildcard / query_contains / query_regex matchers, query-string matching semantics, and the whitelist bypass.
10 screenshots taken on a cPanel + AlmaLinux 10 test server (imunify360 8.14.0, imunify-ui 8.13.0, imunify360-webshield-bundle 1.47.0). The matching semantics documented here were verified on that server with imunify360-wsctl uam test.

DexterIA and others added 2 commits August 26, 2026 20:06
Add a WebShield section to the Admin Interface and to the User Interface,
covering the Under Attack Mode tab: the service switches, the URL tester,
the rules table, the rule dialog and its path scoping, and how an
administrator sees the rules that belong to end users.

The tab is gated on WebShield feature availability, so the section leads
with why it may be absent (LiteSpeed cPanel) and how to check with
imunify360-wsctl filters.

The WebShield subsection under Settings is renamed to "WebShield
settings": the new section owns the #webshield anchor, and a stable name
is preferable to the positional #webshield-2 VuePress would assign. It
also gains a note that those options do not control Under Attack Mode.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
The new UI sections link into this page, so the parts they rely on had
drifted from what the agent and wafd actually accept:

- site owners can manage rules for their own domains once the admin
  enables the visibility switch; document the switch, the OWNER column
  and the --owner filters
- domains accept a leading wildcard (*.example.com matches subdomains
  only, .example.com matches both)
- path matchers also support wildcard, query_contains and query_regex,
  and are applied to the whole URI including the query string
- whitelisted IP addresses are never challenged
- Enable WebShield in Settings does not control UAM

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@DexterIA
DexterIA marked this pull request as ready for review August 27, 2026 12:07
@DexterIA DexterIA changed the title DEF-51753: document the Under Attack Mode UI Document the Under Attack Mode UI Aug 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants