Skip to content

Commit 7fc357d

Browse files
committed
docs(framework): add security motivation for ignoreUrlParams
1 parent 1f3d955 commit 7fc357d

1 file changed

Lines changed: 2 additions & 2 deletions

File tree

docs/2-advanced/01-configuration.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -310,9 +310,9 @@ Failing to do so will result in a warning in the console and the theme root will
310310

311311
This configuration option controls whether URL parameters (e.g. `sap-ui-theme`, `sap-ui-language`, `sap-ui-animationMode`) are processed during framework initialization.
312312

313-
By default, the framework reads `sap-*` and `sap-ui-*` URL parameters and uses them to override the configuration script settings. While useful during development and testing, this behavior can be a security concern in production environments since URL parameters are user-controlled input that can be manipulated through crafted links.
313+
By default, the framework reads `sap-*` and `sap-ui-*` URL parameters and uses them to override the configuration script settings. While useful during development and testing, this behavior can be a security concern in production environments since URL parameters are user-controlled input that can be manipulated through crafted links. For example, an attacker could construct a phishing URL like `?sap-ui-theme=custom@https://malicious.com/` to attempt loading theme assets from an external origin.
314314

315-
When set to `true`, all URL parameter processing is skipped and only the configuration script and module imports are used.
315+
Setting `ignoreUrlParams` to `true` eliminates this attack surface entirely by skipping all URL parameter processing. Only the configuration script and module imports will be used to determine the framework configuration.
316316

317317
Example:
318318
```html

0 commit comments

Comments
 (0)