AWS workspaces documentation change
Summary
Added documentation for installing WorkSpaces Web Access as a Progressive Web Application (PWA) including installation/uninstallation steps for various platforms and browsers, along with usage notes.
Security assessment
The change introduces PWA functionality documentation without addressing security vulnerabilities or weaknesses. It focuses on usability improvements and installation procedures. No security implications are mentioned.
Diff
diff --git a/workspaces/latest/userguide/amazon-workspaces-web-access.md b/workspaces/latest/userguide/amazon-workspaces-web-access.md index c3b3bc70c..e2e2b5aa5 100644 --- a//workspaces/latest/userguide/amazon-workspaces-web-access.md +++ b//workspaces/latest/userguide/amazon-workspaces-web-access.md @@ -7 +7 @@ -Display supportProxy serversSupported features for DCV-based WorkSpacesSupported features and gestures on Android tablets and iPadsEnabling diagnostic log uploads +Display supportProxy serversSupported features for DCV-based WorkSpacesSupported features and gestures on Android tablets and iPadsInstalling WorkSpaces Web Access as a Progressive Web ApplicationEnabling diagnostic log uploads @@ -59,0 +60,2 @@ YUV444 encoding is not supported with WorkSpaces web access. If your administrat + * Installing WorkSpaces Web Access as a Progressive Web Application + @@ -167,0 +170,89 @@ Android tablets are supported on Google Chrome, and iPads are supported on Apple +## Installing WorkSpaces Web Access as a Progressive Web Application + +You can install WorkSpaces Web Access as a Progressive Web Application (PWA) on your device. A PWA lets you access your WorkSpace in a dedicated, full-screen window without browser UI elements such as the toolbar or address bar. After you install it, you can launch WorkSpaces Web Access directly from your device home screen or taskbar. The PWA uses the same connection and authentication method as WorkSpaces Web Access. The PWA automatically stays current without requiring updates. When a web client update is released, it is applied the next time you fully close and reopen the PWA. + +###### Requirements + + * Your administrator must enable web access on your WorkSpace. + + * PWA is supported with Amazon DCV-based WorkSpaces on the following platforms and browsers: + + * Windows – Chrome and Edge + + * macOS – Chrome and Safari + + * Android and Chromebook – Chrome + + * iPad and iOS – Chrome and Safari + + + + +###### To install on Windows, macOS, or Android/Chromebook devices using Chrome or Edge + + 1. Navigate to your organization's WorkSpaces Web Access sign-in page URL in a supported browser. + + 2. In the browser address bar, choose the **Install** icon (usually a monitor with a down arrow) to the right of the URL. Alternatively, choose the browser menu (three vertical dots), choose **Cast, Save, and Share** , and then choose **Install page as app**. + + 3. In the dialog box, confirm or edit the website details, and then choose **Install**. + + + + +###### To install on macOS devices using Safari + + 1. Navigate to your organization's WorkSpaces Web Access sign-in page URL in a supported browser. + + 2. On the top toolbar, choose **File** , then **Add to dock**. + + 3. In the dialog box, confirm or edit the website details, and then choose **Add**. + + + + +###### To install on iOS or iPadOS devices using Safari or Chrome + + 1. Navigate to your organization's WorkSpaces Web Access sign-in page URL in a supported browser. + + 2. To the right of the address bar, choose **Share** , and then choose **Add to Home Screen**. + + 3. Confirm or edit the website details, and then choose **Add**. + + + + +###### To uninstall on Windows, macOS, or Android/Chromebook devices using Chrome or Edge + + 1. Open the app, and then choose the three-dot menu in the title bar. + + 2. Choose **Uninstall**. + + + + +###### To uninstall on macOS devices using Safari + + 1. Open the context (right-click) menu on the app icon in the Dock. + + 2. Choose **Options** , and then choose **Remove from Dock**. + + + + +###### To uninstall on Android, iOS, or iPadOS devices using Safari or Chrome + + 1. Press and hold the app icon on your home screen. + + 2. Choose **Remove** or **Uninstall**. + + + + +###### Note + +You must install the PWA from the same Regional endpoint as the WorkSpaces Region. You can't install the PWA from one Region (for example, `us-east-1`) and use it to access a WorkSpace in a different Region (for example, `us-west-2`). To make sure that you are on the correct Regional endpoint, enter the registration code on the WorkSpaces sign-in page in a regular browser tab and allow the browser to redirect you to the correct Regional endpoint. Then, install the PWA from that page. + +###### Note + +On Android, iOS, and iPadOS devices, minimizing the PWA window might temporarily disconnect your session because mobile browsers restrict network connections for background applications. When you return to the PWA window, wait a few seconds for the connection to re-establish. If the disconnection exceeds the timeout period set by your administrator, you must sign in again. +