Skip to content

Commit 14a35bb

Browse files
Updated outdated links and made corrections to the setup app section
1 parent 96b1285 commit 14a35bb

1 file changed

Lines changed: 15 additions & 12 deletions

File tree

content/en/docs/workstation/wks-build-app.md

Lines changed: 15 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ weight: 30
88

99
## Introduction
1010

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

1313
### How the Connection Works
1414

@@ -33,8 +33,8 @@ To install and configure the Workstation Connector, perform the following steps:
3333

3434
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.
3535

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

3939
1. Navigate to the **Workspaces** page in the [Workstation Management](https://workstation.home.mendix.com/) (default home page).
4040
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:
4545
8. Click **Download** to navigate to the Workstation Client listing in the marketplace, download the Client installer for Windows, install, and launch it.
4646
9. Copy and paste the registration token into the [Workstation Client](/mendix-workstation/installation/) registration field.
4747

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

5861
## Managing Apps
5962

0 commit comments

Comments
 (0)