You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/en/docs/apidocs-mxsdk/apidocs/studio-pro-11/extensibility-api/web/web-extensions-howtos/permissions.md
@@ -10,13 +10,14 @@ This how-to describes how the permission system works for web extensions in Stud
10
10
11
11
## How Permissions Work
12
12
13
-
Web extensions can request permissions to access sensitive functionality. The permission system follows these principles:
13
+
Web extensions can request permissions to access sensitive functionalities. The permission system follows these principles:
14
14
15
-
***Opt-in by default** — Extensions cannot access protected APIs unless they explicitly request the permission and the user grants it.
16
-
***User control** — Users decide which permissions to grant through the Extensions Overview pane in Studio Pro.
17
-
***Per-project settings** — Permission grants are stored per project, so users can have different permission settings for the same extension across different projects.
15
+
***Opt-in by default** — Extensions cannot access protected APIs unless they explicitly request the permission and the user grants it
16
+
***User control** — Users decide which permissions to grant through the Extensions Overview pane in Studio Pro
17
+
***Per-project settings** — Permission grants are stored per project so users can have different permission settings for the same extension across different projects
18
18
19
19
## Requesting Permissions
20
+
20
21
To request a permission, declare it in your extension's `package.json` file under the `mendix.permissions` object:
21
22
22
23
```json
@@ -35,21 +36,21 @@ To request a permission, declare it in your extension's `package.json` file unde
35
36
}
36
37
```
37
38
38
-
Setting a permission to true indicates that your extension requests this permission. The user must grant it before your extension can use the protected functionality.
39
+
Setting a permission to **true** indicates that your extension requests this permission. The user must grant it before your extension can use the protected functionality.
39
40
40
41
## Granting Permissions (User Flow)
41
42
42
-
When a user installs an extension that requests permissions, they can manage those permissions through the Extensions Overview pane:
43
+
When a user installs an extension that requests permissions, they can manage those permissions through the Extensions Overview pane. Follow the steps below:
43
44
44
45
1. Open Studio Pro and load a project with the extension installed.
45
-
2. Go to View > Extensions Overview to open the Extensions Overview pane.
46
-
3. Find the extension in the list.
47
-
4. Under the extension details, a Permissions section displays the requested permissions.
48
-
5. Check or uncheck the checkbox next to each permission to grant or revoke access.
46
+
2. Go to **View** > **Extensions Overview** to open the Extensions Overview pane.
47
+
3. Find the extension in the list. Under the extension details, the **Permissions** section displays the requested permissions.
48
+
4. Check or uncheck the checkbox next to each permission to grant or revoke access.
49
49
50
50
## Available Permissions
51
51
52
52
Currently, the following permissions are available for web extensions:
53
+
53
54
| Permission | Description |
54
55
|------------|-------------|
55
56
|`runtime-configuration-private`| Allows the extension to access the values of private constants from the active runtime configuration. Without this permission, private constants are returned with `isPrivate: true` and no value. |
0 commit comments