Skip to content

Commit 6901484

Browse files
committed
Permissions review
1 parent 284527a commit 6901484

1 file changed

Lines changed: 12 additions & 11 deletions

File tree

  • content/en/docs/apidocs-mxsdk/apidocs/studio-pro-11/extensibility-api/web/web-extensions-howtos

content/en/docs/apidocs-mxsdk/apidocs/studio-pro-11/extensibility-api/web/web-extensions-howtos/permissions.md

Lines changed: 12 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "Extension Permissions in Overview Pane"
3-
linktitle: "Extension Permissions Guide"
3+
linktitle: "Extension Permissions"
44
url: /apidocs-mxsdk/apidocs/web-extensibility-api-11/extension-permissions/
55
---
66

@@ -10,13 +10,14 @@ This how-to describes how the permission system works for web extensions in Stud
1010

1111
## How Permissions Work
1212

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:
1414

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
1818

1919
## Requesting Permissions
20+
2021
To request a permission, declare it in your extension's `package.json` file under the `mendix.permissions` object:
2122

2223
```json
@@ -35,21 +36,21 @@ To request a permission, declare it in your extension's `package.json` file unde
3536
}
3637
```
3738

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.
3940

4041
## Granting Permissions (User Flow)
4142

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:
4344

4445
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.
4949

5050
## Available Permissions
5151

5252
Currently, the following permissions are available for web extensions:
53+
5354
| Permission | Description |
5455
|------------|-------------|
5556
| `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

Comments
 (0)