File Dialogs

The security.dialogs node describes how WebStream intercepts native open/save dialogs and replaces them with browser-native pickers — the timeout, whether to fall back to the native dialog, and how long a download toast is shown.

Editor Advanced → Security JSON · JSON security.dialogs

Properties

Property	Type	Default	Min / max	Notes
`headlessEnabled`	boolean	true	—	Enable headless file-dialog interception (browser-native picker).
`browserTimeoutSeconds`	integer	120	10 – 300	Timeout for the browser-based file picker, in seconds.
`fallbackToNative`	boolean	true	—	Show the native dialog on timeout or error.
`downloadToastDurationSeconds`	integer	5	0 – 10	Download-notification duration; `0` disables the toast.

New custom policies are created with a tighter set of defaults (browserTimeoutSeconds: 60, fallbackToNative: false, downloadToastDurationSeconds: 3); the values above are the schema defaults.

Sample

"dialogs": {
  "headlessEnabled": true,
  "browserTimeoutSeconds": 60,
  "fallbackToNative": false,
  "downloadToastDurationSeconds": 3
}

app.config.xml override

Important: although these properties are part of the policy schema and editable in the Advanced JSON, the headless dialog server currently reads its behaviour from the app.config.xml <headlessDialogs> section. The policy dialogs values are logged only at session start and are not yet applied. To change headless dialog behaviour, edit <headlessDialogs> on the relevant gateway/backend.