AWS workspaces documentation change
Summary
Updated macOS client documentation with supported OS versions, simplified installation/update instructions, and added automatic update functionality details
Security assessment
The change introduces documentation about automatic client updates, which helps maintain security by ensuring users run updated software. However, there is no explicit reference to addressing a specific security vulnerability. The regional update restrictions note helps users understand update availability but doesn't directly mitigate a security risk.
Diff
diff --git a/workspaces/latest/userguide/amazon-workspaces-osx-client.md b/workspaces/latest/userguide/amazon-workspaces-osx-client.md index 33add4ecd..6b228514d 100644 --- a//workspaces/latest/userguide/amazon-workspaces-osx-client.md +++ b//workspaces/latest/userguide/amazon-workspaces-osx-client.md @@ -47,0 +48,4 @@ The following information helps you get started with the WorkSpaces macOS client +The Amazon WorkSpaces client for macOS requires an Apple supported version of macOS. For more details, please refer to the [macOS Release Notes](https://developer.apple.com/documentation/macos-release-notes) on the _Apple Developer Documentation_ site. + +The versions that are currently supported are listed in the following table: + @@ -51,2 +55,2 @@ macOS version | PCoIP | DCV -13 (Ventura) | 4.0 or higher | 5.5.0 or later -14 (Sonoma) | 4.0 or higher | 5.5.0 or later +13 (Ventura) | Supported | Supported +14 (Sonoma) | Supported | Supported @@ -55,4 +58,0 @@ macOS version | PCoIP | DCV -###### Note - -If your WorkSpace is located in the Asia Pacific (Mumbai) Region, you must use version 3.1.3 or later of the Amazon WorkSpaces macOS client application. - @@ -61,18 +61 @@ If your WorkSpace is located in the Asia Pacific (Mumbai) Region, you must use v -To download and install the client application, complete the following procedure. - -###### To download and install the client application - - 1. On your macOS device, open [Amazon WorkSpaces Client Downloads](https://clients.amazonworkspaces.com/) and choose the **MacOS X** link. - - 2. Download and install the application. - - 3. Verify that the Amazon WorkSpaces client application icon appears on the desktop. - - - - -If you're having trouble updating your WorkSpaces macOS client application to a newer version, use the following procedure to update your client application. - -###### - -To update the WorkSpaces macOS client application to a newer version +Download and install the latest version of the Amazon WorkSpaces client application from the [Amazon WorkSpaces Client Download](https://clients.amazonworkspaces.com/) website. @@ -80 +63 @@ To update the WorkSpaces macOS client application to a newer version - 1. In the **Finder** , open your **Applications** folder, then open **Utilities** , and choose **Terminal**. +### Updating the client application @@ -82,9 +65 @@ To update the WorkSpaces macOS client application to a newer version - 2. In the Terminal window, enter the following command, and then press the Return key. - - defaults delete com.amazon.workspaces SUSkippedVersion - - 3. In the Terminal app, choose **Terminal** , **Quit Terminal**. - - 4. If you have not already entered a registration code in the WorkSpaces macOS client application, do so, and then choose **Amazon WorkSpaces** , **Quit Amazon WorkSpaces** to close the client application. - - 5. Restart the WorkSpaces macOS client application. You should be prompted to update the client. Accept the update. +The Amazon WorkSpaces client application on macOS will automatically check for available updates, and when new versions become available, will install them in the background when you’re not using it. Once the installation is complete, you simply need to open the client to begin using the latest version. This will provide you with faster access to the latest features, enhancements, and bug fixes without interrupting your productivity. @@ -91,0 +67 @@ To update the WorkSpaces macOS client application to a newer version +###### Note @@ -92,0 +69 @@ To update the WorkSpaces macOS client application to a newer version +Automatic client updates are only applied when your client application is used to connect to WorkSpaces in the below regions. @@ -93,0 +71,19 @@ To update the WorkSpaces macOS client application to a newer version +Region | Address +---|--- +US East (N. Virginia) | us-east-1 +US West (Oregon) | us-west-2 +Africa (Cape Town) | af-south-1 +Asia Pacific (Mumbai) | ap-south-1 +Asia Pacific (Seoul) | ap-northeast-2 +Asia Pacific (Singapore) | ap-southeast-1 +Asia Pacific (Sydney) | ap-southeast-2 +Asia Pacific (Tokyo) | ap-northeast-1 +Canada (Central) | ca-central-1 +Europe (Frankfurt) | eu-central-1 +Europe (Ireland) | eu-west-1 +Europe (London) | eu-west-2 +Europe (Paris) | eu-west-3 +Israel (Tel Aviv) | il-central-1 +South America (São Paulo) | sa-east-1 + +In any other regions not listed above, the Amazon WorkSpaces client application on macOS will not update automatically; you will instead see a message when a new version is available, and will have the option to install it. @@ -333,0 +330,11 @@ Release | Date | Changes +5.29.0 | July 31, 2025 | + + * Added a new automatic client update feature that will automatically check for available updates and install them when you're not using the client, helping you to get the latest features and bug fixes. + * Bug fixes and enhancements. + + +5.28.1 | July 2, 2025 | + + * Bug fixes and enhancements. + +