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/workstation/wks-build-app.md
+15-12Lines changed: 15 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,7 @@ weight: 30
8
8
9
9
## Introduction
10
10
11
-
After you have [installed the Workstation Client](/mendix-workstation/installation/), you must either build a Mendix application that will send data or commands to your devices, or extend an existing app accordingly. In order to do that, you must download, install, and configure the [Mendix Workstation Connector](https://marketplace.mendix.com/link/component/241058) from the Mendix Marketplace.
11
+
After you have [installed the Workstation Client](/mendix-workstation/installation/), you must either build a Mendix application that will send data or commands to your devices, or extend an existing app accordingly. In order to do that, you must download, install, and configure the [Mendix Workstation Connector](https://marketplace.mendix.com/link/component/247460) from the Mendix Marketplace.
12
12
13
13
### How the Connection Works
14
14
@@ -33,8 +33,8 @@ To install and configure the Workstation Connector, perform the following steps:
33
33
34
34
The starter template is suitable for new users who want a good starting point. Alternatively, you can also add the connector to an existing app.
35
35
36
-
2. If you did not use the starter template, download the [Mendix Workstation Connector](https://marketplace.mendix.com/link/component/241058).
37
-
3. Configure the application in Workstation Management by performing the following steps:
36
+
2. If you did not use the starter template, download the [Mendix Workstation Connector](https://marketplace.mendix.com/link/component/247460).
37
+
3. Configure the Station in Workstation Management by performing the following steps:
38
38
39
39
1. Navigate to the **Workspaces** page in the [Workstation Management](https://workstation.home.mendix.com/) (default home page).
40
40
2. Click **Create Workspace** or click on an existing Workspace in the overview.
@@ -45,15 +45,18 @@ To install and configure the Workstation Connector, perform the following steps:
45
45
8. Click **Download** to navigate to the Workstation Client listing in the marketplace, download the Client installer for Windows, install, and launch it.
46
46
9. Copy and paste the registration token into the [Workstation Client](/mendix-workstation/installation/) registration field.
47
47
48
-
4. Set up the private key by performing the following steps:
49
-
50
-
1. In your app add the microflow **ASU_AppKeyPair_Initialize** as an after startup microflow and add the page **AppKeyPair_ShowPublicKey** to your navigation or link to it from a button for an admin role.
51
-
2. Run the app.
52
-
3. Navigate to the page you added in step 1 and copy the shown public key. If there is no key shown click **Regenerate KeyPair**.
53
-
4. On the **Apps** page in your workspace in the Workstation Management, click **Create App**.
54
-
5. Paste the copied public key into the **Public Key** field.
55
-
6. In the station configuration, enable your newly created application (for example, `http://localhost:8080`, which is the default when running an app locally).
56
-
7. Refresh the Workstation Client.
48
+
4. Configure your app as an allowed app by performing the following steps:
49
+
50
+
1. In your app go to [App Security](https://docs.mendix.com/refguide/app-security/#user-roles) and assign the module role **StationConnector.Administrator** to the Administrator user role.
51
+
2. In your app add the page **StationConnector_Security** to your navigation or link to it from an 'Open page button'. Alternatively, place the snippet **SNIPPET_StationAdminPage** on a page available to the Adminstrator user role.
52
+
3. Run the app.
53
+
4. Login as an Administrator, navigate to the page you added in step 2 and copy the shown public key.
54
+
6. Go back to the [Workstation Management](https://workstation.home.mendix.com/) and navigate to the workspace you created in step 3.2.
55
+
7. Go to the **Apps** page in your workspace and click **Create App**.
56
+
8. Enter your apps URL (for example, `http://localhost:8080`, which is the default when running an app locally) and paste the copied public key into the **Public Key** field. Select **Enable in all stations** or follow step 9 if you only want to enable it for a specific station.
57
+
9. After creating the app, go to **Stations** and navigate to your station. You will find the created app under the **Apps** section. Here you can enable the application just for this station by pressing the toggle.
58
+
10. Refresh the Workstation Client.
59
+
11. Optional: To create the created key pair, additionally assign the module role **StationConnector.SecurityAdministrator** to your Administrator role. This will add a button **Regenerate KeyPair** to the **StationConnector_Security** page.
0 commit comments