Skip to content

Commit d20b177

Browse files
updates
1 parent b42ff5d commit d20b177

1 file changed

Lines changed: 18 additions & 25 deletions

File tree

content/en/docs/workstation/wks-security.md

Lines changed: 18 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -16,43 +16,36 @@ This document describes the common aspects you should consider when deploying th
1616

1717
Workspace roles should be assigned following the principle of least privilege. Always grant users the minimum permissions necessary for them to successfully complete their tasks. You can reassign the roles at any time if responsibilities change. To help maintain a secure deployment, consider the following guidelines:
1818

19-
* Assign the View Only role to untrusted users
20-
* Use caution when granting the Workspace Admin role
21-
* Workspace Admins can unintentionally disrupt production, for example by deleting an app or modifying its public key
22-
* Workspace Admins can allow Workstation Clients to access malicious apps
23-
* Conduct regular permissions audits to make sure that temporary privilege elevations are reverted once they are no longer necessary
19+
* Assign the View Only role to untrusted users.
20+
* Use caution when granting the Workspace Admin role.
21+
* Workspace Admins can unintentionally disrupt production, for example by deleting an app or modifying its public key.
22+
* Workspace Admins can allow Workstation Clients to access malicious apps.
23+
* Conduct regular permissions audits to make sure that temporary privilege elevations are reverted once they are no longer necessary.
2424

25-
## Setting up Stations {#setup-stations}
25+
## Station Set Up {#setup-stations}
2626

2727
Setting up stations involves a variety of options, some of which have important security implications. To help ensure a secure deployment, follow these best practices:
2828

29-
* Keep stations lean by disabling unused apps and deleting unused devices
30-
* Any unused device represents a potential attack surface (e.g., a forgotten card reader that leaks a token, or a tcp device that exposes a device on the network)
31-
* Any unused but enabled app may gain unintended access to devices that were not meant to be exposed to it
32-
* Verify that all devices configured on a station are safe for all enabled applications
29+
* Keep stations lean by disabling unused apps and deleting unused devices.
30+
* Any unused device represents a potential attack surface (for example, a forgotten card reader that leaks a token, or a TCP device that exposes a device on the network).
31+
* Any unused but enabled app may gain unintended access to devices that were not meant to be exposed to it.
32+
* Verify that all devices configured on a station are safe for all enabled applications.
3333
* Devices are shared across all applications in a station. If a device should not be accessible by a particular app, it should not be present on that station.
34-
* Configure File devices carefully
35-
* File devices are powerful and can pose security risks if misconfigured
34+
* Configure File devices carefully.
35+
* File devices are powerful and can pose security risks if misconfigured.
3636
* Restrict the allowed folder and permissions as much as possible. The Workstation Client enforces these restrictions within the allowed folder and its subfolders.
3737

38-
## Restricting Configuration Folder Access {#config-access}
38+
## Access Restrictions for the Configuration Folder on Microsoft Windows {#config-access}
3939

40-
By default, the Windows global installer for the Workstation Client grants the BUILTIN\Users group read and write access to the ProgramData/Mendix Workstation folder. This configuration is safe in most cases. However, for highly sensitive environments, you may want to restrict write access for the built-in Users group and instead delegate permissions to a different group.
40+
By default, the Windows global installer for the Workstation Client grants the **BUILTIN\Users** Windows user group read and write access to the *ProgramData/Mendix Workstation* folder. This configuration is safe in most cases. However, for highly sensitive environments, you may want to restrict write access for the built-in Users group, and instead delegate permissions to a different group.
4141

4242
### Why Restrict the Users Group?
4343

44-
The BUILTIN\Users group includes all standard user accounts on the system. Restricting its write access helps prevent the following:
44+
The **BUILTIN\Users** group includes all standard user accounts on the system. Restricting its write access helps prevent the following:
4545

46-
* Compromised accounts from modifying configuration files
47-
* Unauthorized users from deregistering the station, temporary halting production
46+
* Compromised accounts modifying configuration files
47+
* Unauthorized users deregistering the station, temporarily halting production
4848

4949
By delegating permissions to a more tightly controlled group, you ensure that only authorized accounts have the ability to modify the configuration and to use the Workstation Client.
5050

51-
### Configuring Permissions
52-
53-
1. Open C:\ProgramData\Mendix Workstation\ in Windows Explorer
54-
2. Right-click the folder, select Properties, and navigate to the Security tab
55-
3. Click Edit → Add…
56-
4. Enter the name of your custom group and select Check Names
57-
5. Assign this group the same permissions currently held by the Users group
58-
6. Remove the Users group or adjust its permissions as needed
51+
To delegate permissions to a custom group, create a new Windows user group and grant it the same permissions to the *C:\ProgramData\Mendix Workstation* folder as are currently held by the Users group. After that, you can remove the Users group or adjust its permissions as needed. For more information about managing groups and permissions, refer to Microsoft Windows documentation.

0 commit comments

Comments
 (0)