|
37 | 37 | ],
|
38 | 38 | "definitions": {
|
39 | 39 | "Capability": {
|
40 |
| - "description": "A grouping and boundary mechanism developers can use to isolate access to the IPC layer.\n\nIt controls application windows fine grained access to the Tauri core, application, or plugin commands. If a window is not matching any capability then it has no access to the IPC layer at all.\n\nThis can be done to create groups of windows, based on their required system access, which can reduce impact of frontend vulnerabilities in less privileged windows. Windows can be added to a capability by exact name (e.g. `main-window`) or glob patterns like `*` or `admin-*`. A Window can have none, one, or multiple associated capabilities.\n\n## Example\n\n```json { \"identifier\": \"main-user-files-write\", \"description\": \"This capability allows the `main` window on macOS and Windows access to `filesystem` write related commands and `dialog` commands to enable programatic access to files selected by the user.\", \"windows\": [ \"main\" ], \"permissions\": [ \"core:default\", \"dialog:open\", { \"identifier\": \"fs:allow-write-text-file\", \"allow\": [{ \"path\": \"$HOME/test.txt\" }] }, ], \"platforms\": [\"macOS\",\"windows\"] } ```", |
| 40 | + "description": "A grouping and boundary mechanism developers can use to isolate access to the IPC layer.\n\nIt controls application windows' and webviews' fine grained access to the Tauri core, application, or plugin commands. If a webview or its window is not matching any capability then it has no access to the IPC layer at all.\n\nThis can be done to create groups of windows, based on their required system access, which can reduce impact of frontend vulnerabilities in less privileged windows. Windows can be added to a capability by exact name (e.g. `main-window`) or glob patterns like `*` or `admin-*`. A Window can have none, one, or multiple associated capabilities.\n\n## Example\n\n```json { \"identifier\": \"main-user-files-write\", \"description\": \"This capability allows the `main` window on macOS and Windows access to `filesystem` write related commands and `dialog` commands to enable programatic access to files selected by the user.\", \"windows\": [ \"main\" ], \"permissions\": [ \"core:default\", \"dialog:open\", { \"identifier\": \"fs:allow-write-text-file\", \"allow\": [{ \"path\": \"$HOME/test.txt\" }] }, ], \"platforms\": [\"macOS\",\"windows\"] } ```", |
41 | 41 | "type": "object",
|
42 | 42 | "required": [
|
43 | 43 | "identifier",
|
|
70 | 70 | "type": "boolean"
|
71 | 71 | },
|
72 | 72 | "windows": {
|
73 |
| - "description": "List of windows that are affected by this capability. Can be a glob pattern.\n\nOn multiwebview windows, prefer [`Self::webviews`] for a fine grained access control.\n\n## Example\n\n`[\"main\"]`", |
| 73 | + "description": "List of windows that are affected by this capability. Can be a glob pattern.\n\nIf a window label matches any of the patterns in this list, the capability will be enabled on all the webviews of that window, regardless of the value of [`Self::webviews`].\n\nOn multiwebview windows, prefer specifying [`Self::webviews`] and omitting [`Self::windows`] for a fine grained access control.\n\n## Example\n\n`[\"main\"]`", |
74 | 74 | "type": "array",
|
75 | 75 | "items": {
|
76 | 76 | "type": "string"
|
77 | 77 | }
|
78 | 78 | },
|
79 | 79 | "webviews": {
|
80 |
| - "description": "List of webviews that are affected by this capability. Can be a glob pattern.\n\nThis is only required when using on multiwebview contexts, by default all child webviews of a window that matches [`Self::windows`] are linked.\n\n## Example\n\n`[\"sub-webview-one\", \"sub-webview-two\"]`", |
| 80 | + "description": "List of webviews that are affected by this capability. Can be a glob pattern.\n\nThe capability will be enabled on all the webviews whose label matches any of the patterns in this list, regardless of whether the webview's window label matches a pattern in [`Self::windows`].\n\n## Example\n\n`[\"sub-webview-one\", \"sub-webview-two\"]`", |
81 | 81 | "type": "array",
|
82 | 82 | "items": {
|
83 | 83 | "type": "string"
|
|
201 | 201 | "type": "string",
|
202 | 202 | "const": "core:app:allow-default-window-icon"
|
203 | 203 | },
|
| 204 | + { |
| 205 | + "description": "Enables the fetch_data_store_identifiers command without any pre-configured scope.", |
| 206 | + "type": "string", |
| 207 | + "const": "core:app:allow-fetch-data-store-identifiers" |
| 208 | + }, |
| 209 | + { |
| 210 | + "description": "Enables the identifier command without any pre-configured scope.", |
| 211 | + "type": "string", |
| 212 | + "const": "core:app:allow-identifier" |
| 213 | + }, |
204 | 214 | {
|
205 | 215 | "description": "Enables the name command without any pre-configured scope.",
|
206 | 216 | "type": "string",
|
207 | 217 | "const": "core:app:allow-name"
|
208 | 218 | },
|
| 219 | + { |
| 220 | + "description": "Enables the remove_data_store command without any pre-configured scope.", |
| 221 | + "type": "string", |
| 222 | + "const": "core:app:allow-remove-data-store" |
| 223 | + }, |
209 | 224 | {
|
210 | 225 | "description": "Enables the set_app_theme command without any pre-configured scope.",
|
211 | 226 | "type": "string",
|
|
236 | 251 | "type": "string",
|
237 | 252 | "const": "core:app:deny-default-window-icon"
|
238 | 253 | },
|
| 254 | + { |
| 255 | + "description": "Denies the fetch_data_store_identifiers command without any pre-configured scope.", |
| 256 | + "type": "string", |
| 257 | + "const": "core:app:deny-fetch-data-store-identifiers" |
| 258 | + }, |
| 259 | + { |
| 260 | + "description": "Denies the identifier command without any pre-configured scope.", |
| 261 | + "type": "string", |
| 262 | + "const": "core:app:deny-identifier" |
| 263 | + }, |
239 | 264 | {
|
240 | 265 | "description": "Denies the name command without any pre-configured scope.",
|
241 | 266 | "type": "string",
|
242 | 267 | "const": "core:app:deny-name"
|
243 | 268 | },
|
| 269 | + { |
| 270 | + "description": "Denies the remove_data_store command without any pre-configured scope.", |
| 271 | + "type": "string", |
| 272 | + "const": "core:app:deny-remove-data-store" |
| 273 | + }, |
244 | 274 | {
|
245 | 275 | "description": "Denies the set_app_theme command without any pre-configured scope.",
|
246 | 276 | "type": "string",
|
|
1036 | 1066 | "type": "string",
|
1037 | 1067 | "const": "core:window:allow-internal-toggle-maximize"
|
1038 | 1068 | },
|
| 1069 | + { |
| 1070 | + "description": "Enables the is_always_on_top command without any pre-configured scope.", |
| 1071 | + "type": "string", |
| 1072 | + "const": "core:window:allow-is-always-on-top" |
| 1073 | + }, |
1039 | 1074 | {
|
1040 | 1075 | "description": "Enables the is_closable command without any pre-configured scope.",
|
1041 | 1076 | "type": "string",
|
|
1401 | 1436 | "type": "string",
|
1402 | 1437 | "const": "core:window:deny-internal-toggle-maximize"
|
1403 | 1438 | },
|
| 1439 | + { |
| 1440 | + "description": "Denies the is_always_on_top command without any pre-configured scope.", |
| 1441 | + "type": "string", |
| 1442 | + "const": "core:window:deny-is-always-on-top" |
| 1443 | + }, |
1404 | 1444 | {
|
1405 | 1445 | "description": "Denies the is_closable command without any pre-configured scope.",
|
1406 | 1446 | "type": "string",
|
|
0 commit comments