From 96b128557b3570b82df03c79eecd11c31f66e2a3 Mon Sep 17 00:00:00 2001 From: mendix-nleimer <93211773+mendix-nleimer@users.noreply.github.com> Date: Wed, 1 Oct 2025 16:44:18 +0200 Subject: [PATCH 1/4] Updated outdated link to linux --- content/en/docs/workstation/wks-installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/workstation/wks-installation.md b/content/en/docs/workstation/wks-installation.md index 918a2a6db24..1b4d2ca9d9f 100644 --- a/content/en/docs/workstation/wks-installation.md +++ b/content/en/docs/workstation/wks-installation.md @@ -61,7 +61,7 @@ The Workstation Client is a connector between the devices and your local PC. You * If you do not have administrator rights for your computer, download the [Workstation Client Portable](https://marketplace.mendix.com/link/component/247456) instead. As a best practice, put the portable client in a new folder in your Documents folders, and then click the .exe file to run the client. * For Linux: - * Download the [Linux](https://marketplace.mendix.com/link/component/245641) version of the Client + * Download the [Linux](https://marketplace.mendix.com/link/component/247459) version of the Client * Install: `sudo apt install ./workstation_X.X.X_arm64.deb` * Install card reader dependencies: `sudo apt install pcscd libcap2-bin` * Enable card reader dependencies: `sudo systemctl enable pcscd --now` From 14a35bb1e591074c80b9fd90aab12bdd2fc3a79b Mon Sep 17 00:00:00 2001 From: mendix-nleimer <93211773+mendix-nleimer@users.noreply.github.com> Date: Wed, 1 Oct 2025 17:32:56 +0200 Subject: [PATCH 2/4] Updated outdated links and made corrections to the setup app section --- content/en/docs/workstation/wks-build-app.md | 27 +++++++++++--------- 1 file changed, 15 insertions(+), 12 deletions(-) diff --git a/content/en/docs/workstation/wks-build-app.md b/content/en/docs/workstation/wks-build-app.md index a12f3acd237..d45ba3d976a 100644 --- a/content/en/docs/workstation/wks-build-app.md +++ b/content/en/docs/workstation/wks-build-app.md @@ -8,7 +8,7 @@ weight: 30 ## Introduction -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. +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. ### How the Connection Works @@ -33,8 +33,8 @@ To install and configure the Workstation Connector, perform the following steps: 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. -2. If you did not use the starter template, download the [Mendix Workstation Connector](https://marketplace.mendix.com/link/component/241058). -3. Configure the application in Workstation Management by performing the following steps: +2. If you did not use the starter template, download the [Mendix Workstation Connector](https://marketplace.mendix.com/link/component/247460). +3. Configure the Station in Workstation Management by performing the following steps: 1. Navigate to the **Workspaces** page in the [Workstation Management](https://workstation.home.mendix.com/) (default home page). 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: 8. Click **Download** to navigate to the Workstation Client listing in the marketplace, download the Client installer for Windows, install, and launch it. 9. Copy and paste the registration token into the [Workstation Client](/mendix-workstation/installation/) registration field. -4. Set up the private key by performing the following steps: - - 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. - 2. Run the app. - 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**. - 4. On the **Apps** page in your workspace in the Workstation Management, click **Create App**. - 5. Paste the copied public key into the **Public Key** field. - 6. In the station configuration, enable your newly created application (for example, `http://localhost:8080`, which is the default when running an app locally). - 7. Refresh the Workstation Client. +4. Configure your app as an allowed app by performing the following steps: + + 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. + 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. + 3. Run the app. + 4. Login as an Administrator, navigate to the page you added in step 2 and copy the shown public key. + 6. Go back to the [Workstation Management](https://workstation.home.mendix.com/) and navigate to the workspace you created in step 3.2. + 7. Go to the **Apps** page in your workspace and click **Create App**. + 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. + 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. + 10. Refresh the Workstation Client. + 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. ## Managing Apps From 300f1e8b09ae16871637bbd50d18e863d09e4921 Mon Sep 17 00:00:00 2001 From: mendix-nleimer <93211773+mendix-nleimer@users.noreply.github.com> Date: Wed, 1 Oct 2025 17:36:06 +0200 Subject: [PATCH 3/4] Added warning about key rotation --- content/en/docs/workstation/wks-build-app.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/workstation/wks-build-app.md b/content/en/docs/workstation/wks-build-app.md index d45ba3d976a..a1e9c6c5924 100644 --- a/content/en/docs/workstation/wks-build-app.md +++ b/content/en/docs/workstation/wks-build-app.md @@ -56,7 +56,7 @@ To install and configure the Workstation Connector, perform the following steps: 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. 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. 10. Refresh the Workstation Client. - 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. + 11. Optional: To recreate the 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. Be mindful when using this button in a production scenario to avoid the need to reconfigure the App in the Management and refresh all Workstation Clients. ## Managing Apps From 617dfe39ef53a3c2bfaccd957bd9494c2f152690 Mon Sep 17 00:00:00 2001 From: katarzyna-koltun-mx <108737161+katarzyna-koltun-mx@users.noreply.github.com> Date: Thu, 2 Oct 2025 14:17:28 +0200 Subject: [PATCH 4/4] Update wks-build-app.md --- content/en/docs/workstation/wks-build-app.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/content/en/docs/workstation/wks-build-app.md b/content/en/docs/workstation/wks-build-app.md index a1e9c6c5924..fecfe247904 100644 --- a/content/en/docs/workstation/wks-build-app.md +++ b/content/en/docs/workstation/wks-build-app.md @@ -53,10 +53,12 @@ To install and configure the Workstation Connector, perform the following steps: 4. Login as an Administrator, navigate to the page you added in step 2 and copy the shown public key. 6. Go back to the [Workstation Management](https://workstation.home.mendix.com/) and navigate to the workspace you created in step 3.2. 7. Go to the **Apps** page in your workspace and click **Create App**. - 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. - 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. + 8. Enter your app's 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. + 9. Perform one of the following actions: + * To enable the app for all stations, select **Enable in all stations** + * To enable it for a specific station, 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. 10. Refresh the Workstation Client. - 11. Optional: To recreate the 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. Be mindful when using this button in a production scenario to avoid the need to reconfigure the App in the Management and refresh all Workstation Clients. + 11. Optional: To recreate the key pair, additionally assign the module role **StationConnector.SecurityAdministrator** to your Administrator role. This adds a **Regenerate KeyPair** button to the **StationConnector_Security** page. Be mindful when using this button in a production scenario to avoid the need to reconfigure the app in the Management, and refresh all Workstation Clients. ## Managing Apps