AWS workspaces documentation change
Summary
Restructured documentation to clarify web access requirements, updated supported features for DCV/PCoIP protocols, added details about Android/iPad gestures, expanded proxy server guidance, and revised diagnostic logging steps.
Security assessment
Changes focus on feature support clarifications, platform compatibility, and user experience improvements. No explicit references to security vulnerabilities, patches, or new security controls. Proxy authentication limitation is noted but represents a functional constraint rather than a disclosed vulnerability.
Diff
diff --git a/workspaces/latest/userguide/amazon-workspaces-web-access.md b/workspaces/latest/userguide/amazon-workspaces-web-access.md index 0d510c41c..c094f1d4d 100644 --- a//workspaces/latest/userguide/amazon-workspaces-web-access.md +++ b//workspaces/latest/userguide/amazon-workspaces-web-access.md @@ -5 +5 @@ -WebsiteRequirementsClient viewsProxy serversFeatures for WorkSpaces configured for DCVEnabling diagnostic log uploads +Display supportProxy serversSupported features for DCV-based WorkSpacesSupported features and gestures on Android tablets and iPadsEnabling diagnostic log uploads @@ -9 +9 @@ WebsiteRequirementsClient viewsProxy serversFeatures for WorkSpaces configured f -Users can access their Windows WorkSpaces and DCV Linux WorkSpaces from any location using a web browser. This is ideal for users who access WorkSpaces from a personally-owned or locked-down device, because installing and maintaining a client application can be challenging. Instead of using a traditional remote access solution and installing the appropriate client application, users can visit the website to access their work resources. +You can access your DCV-based Windows and Linux-based WorkSpaces from the convenience of your web browser. You may choose this option if you prefer not to install one of the Amazon WorkSpaces client applications, or if you are accessing your WorkSpace from a personal device. @@ -11 +11 @@ Users can access their Windows WorkSpaces and DCV Linux WorkSpaces from any loca -###### Limits +The following information will help you get started with WorkSpaces web access. @@ -13 +13 @@ Users can access their Windows WorkSpaces and DCV Linux WorkSpaces from any loca - * We strongly recommend using Web Access with DCV WorkSpaces for best streaming quality and user experience. The following are limitations when using Web Access with PCoIP WorkSpaces: +###### Requirements @@ -15 +15 @@ Users can access their Windows WorkSpaces and DCV Linux WorkSpaces from any loca - * Web Access with PCoIP is not supported in the AWS GovCloud (US) Regions, Asia Pacific (Mumbai), Africa (Cape Town), and Israel (Tel Aviv) + * Your administrator must enable web access on your WorkSpace. For more information, check with your administrator or see [Enable and Configure WorkSpaces Web Access](https://docs.aws.amazon.com/workspaces/latest/adminguide/web-access.html) in the Amazon WorkSpaces Administration Guide. @@ -17 +17 @@ Users can access their Windows WorkSpaces and DCV Linux WorkSpaces from any loca - * Web Access with PCoIP is only supported for Windows WorkSpaces, not with Amazon Linux WorkSpaces. + * Web access is supported with DCV-based WorkSpaces where the WorkSpace is running Windows or Linux. @@ -19 +19 @@ Users can access their Windows WorkSpaces and DCV Linux WorkSpaces from any loca - * Web Access is not available for some Windows 10 WorkSpaces that are using the PCoIP protocol. If your PCoIP WorkSpaces are powered by Windows Server 2019 or 2022, Web Access is not available. + * On Windows, macOS, and Linux devices: Web access for Amazon DCV is supported on Google Chrome, Microsoft Edge, Apple Safari and Mozilla Firefox browsers when running on the latest three browser versions. @@ -21 +21 @@ Users can access their Windows WorkSpaces and DCV Linux WorkSpaces from any loca - * You can't use a web browser to connect to GPU-enabled WorkSpaces. + * On Android tablets, Chromebooks, and iPads: Web access for Amazon DCV is supported on Google Chrome and Apple Safari browsers when running on the latest three browser versions. @@ -23 +23 @@ Users can access their Windows WorkSpaces and DCV Linux WorkSpaces from any loca - * If you are using macOS on VPN and using the Firefox web browser, the web browser will not support streaming PCoIP workspaces using WorkSpaces Web Access. This is due to a limitation in Firefox implementation of the WebRTC protocol. + * Web access for PCoIP-based WorkSpaces has reduced support, with the following limitations: @@ -25 +25 @@ Users can access their Windows WorkSpaces and DCV Linux WorkSpaces from any loca - * As of October 1, 2020, you can't use the Amazon WorkSpaces Web Access client to connect to Windows 7 custom WorkSpaces or to Windows 7 Bring Your Own License (BYOL) WorkSpaces. + * Web access for PCoIP is not supported in the AWS GovCloud (US), Asia Pacific (Mumbai), Africa (Cape Town), Israel (Tel Aviv), or Europe (Paris) regions. @@ -26,0 +27 @@ Users can access their Windows WorkSpaces and DCV Linux WorkSpaces from any loca + * Web access for PCoIP is only supported for Windows-based WorkSpaces, not Linux-based WorkSpaces. @@ -27,0 +29 @@ Users can access their Windows WorkSpaces and DCV Linux WorkSpaces from any loca + * Web access for PCoIP is only supported on Google Chrome and Mozilla Firefox browsers on Windows, macOS and Linux devices when running on the latest three browser versions. @@ -28,0 +31 @@ Users can access their Windows WorkSpaces and DCV Linux WorkSpaces from any loca + * Web access for PCoIP does not support multiple monitors. @@ -30,15 +33 @@ Users can access their Windows WorkSpaces and DCV Linux WorkSpaces from any loca -###### Contents - - * Website - - * Requirements - - * Client views - - * Proxy servers - - * Features for WorkSpaces configured for DCV - - * Enabling diagnostic log uploads - - + * Web access for PCoIP does not support connecting to GPU-enabled WorkSpaces. @@ -47 +35,0 @@ Users can access their Windows WorkSpaces and DCV Linux WorkSpaces from any loca -## Website @@ -49 +36,0 @@ Users can access their Windows WorkSpaces and DCV Linux WorkSpaces from any loca -Open [WorkSpaces Web Access](https://clients.amazonworkspaces.com/webclient) to log on to your Windows WorkSpace through your web browser. If your WorkSpaces are in the AWS GovCloud (US) Regions, open [WorkSpaces Web Access](https://clients.amazonworkspaces.com/webclient) to connect to your WorkSpaces. @@ -51,5 +38 @@ Open [WorkSpaces Web Access](https://clients.amazonworkspaces.com/webclient) to -## Requirements - -You can access a WorkSpace by running the Windows 10 desktop experience and one of the following bundles: - - * Value +###### Note @@ -57 +40 @@ You can access a WorkSpace by running the Windows 10 desktop experience and one - * Standard +YUV444 encoding is not supported with WorkSpaces web access. If your administrator uses a Group Policy setting to enable YUV444 encoding, this may cause issues during login or rendering issues during your session. @@ -59 +42 @@ You can access a WorkSpace by running the Windows 10 desktop experience and one - * Performance +###### Contents @@ -61 +44 @@ You can access a WorkSpace by running the Windows 10 desktop experience and one - * Power + * Display support @@ -63 +46 @@ You can access a WorkSpace by running the Windows 10 desktop experience and one - * PowerPro + * Proxy servers @@ -64,0 +48 @@ You can access a WorkSpace by running the Windows 10 desktop experience and one + * Supported features for DCV-based WorkSpaces @@ -65,0 +50 @@ You can access a WorkSpace by running the Windows 10 desktop experience and one + * Supported features and gestures on Android tablets and iPads @@ -66,0 +52 @@ You can access a WorkSpace by running the Windows 10 desktop experience and one + * Enabling diagnostic log uploads @@ -68 +53,0 @@ You can access a WorkSpace by running the Windows 10 desktop experience and one -You must have web connectivity. @@ -70 +54,0 @@ You must have web connectivity. -###### Note @@ -72 +55,0 @@ You must have web connectivity. -You can connect to your DCV WorkSpaces using Web Access in the AWS GovCloud (US) Regions. Connecting to PCoIP WorkSpaces via Web Access is not supported in the AWS GovCloud (US) Regions. @@ -74 +57 @@ You can connect to your DCV WorkSpaces using Web Access in the AWS GovCloud (US) -Your administrator must enable WorkSpaces Web Access. For more information, see [Enable and Configure Amazon WorkSpaces Web Access](https://docs.aws.amazon.com/workspaces/latest/adminguide/web-access.html) in the _Amazon WorkSpaces Administration Guide_. +## Display support @@ -76 +59 @@ Your administrator must enable WorkSpaces Web Access. For more information, see -### WorkSpaces configured for PCoIP +WorkSpaces Web Access supports up to two monitors when connecting to DCV-based WorkSpaces. @@ -78 +61 @@ Your administrator must enable WorkSpaces Web Access. For more information, see -You must run one of the following web browsers on your Windows, macOS, or Linux computer: +## Proxy servers @@ -80 +63 @@ You must run one of the following web browsers on your Windows, macOS, or Linux - * Google Chrome 55 and later +If you are required to use a proxy server to access the internet, you can configure your browser to use the proxy server. @@ -82 +65 @@ You must run one of the following web browsers on your Windows, macOS, or Linux - * Firefox 52 and later +###### Requirements @@ -83,0 +67 @@ You must run one of the following web browsers on your Windows, macOS, or Linux + * Proxy with authentication is not currently supported. @@ -84,0 +69 @@ You must run one of the following web browsers on your Windows, macOS, or Linux + * Proxy server support for Web Access may vary by browser. Refer to your browser’s proxy settings for more information. @@ -87 +71,0 @@ You must run one of the following web browsers on your Windows, macOS, or Linux -### WorkSpaces configured for DCV @@ -89 +72,0 @@ You must run one of the following web browsers on your Windows, macOS, or Linux -You must run one of the following web browsers on your Windows, macOS, or Linux computer: @@ -91 +74 @@ You must run one of the following web browsers on your Windows, macOS, or Linux - * Microsoft Edge (latest three major versions) +## Supported features for DCV-based WorkSpaces @@ -93 +76 @@ You must run one of the following web browsers on your Windows, macOS, or Linux - * Google Chrome (latest three major versions) +The following features are supported for DCV-based WorkSpaces. @@ -95 +78 @@ You must run one of the following web browsers on your Windows, macOS, or Linux - * Mozilla Firefox (latest three major versions) +### Copying and pasting @@ -97 +80 @@ You must run one of the following web browsers on your Windows, macOS, or Linux - * Apple Safari for macOS (latest three major versions) +You can use the web client to copy and paste plain text and PNG images between your local device and the WorkSpaces session. On Google Chrome and Microsoft Edge, you can use keyboard shortcuts and context (right-click) menu to copy and paste text and images. On Mozilla Firefox and Apple Safari you can use the clipboard dialog to copy and paste plain text; images are not supported. @@ -98,0 +82 @@ You must run one of the following web browsers on your Windows, macOS, or Linux +### Using a webcam @@ -99,0 +84 @@ You must run one of the following web browsers on your Windows, macOS, or Linux +Webcam functionality is supported on Google Chrome and Microsoft Edge. On Mozilla Firefox, webcams are supported with Windows-based WorkSpaces only. Webcams are not supported on Apple Safari. @@ -100,0 +86 @@ You must run one of the following web browsers on your Windows, macOS, or Linux +###### Selecting the webcam you want to use @@ -102 +88 @@ You must run one of the following web browsers on your Windows, macOS, or Linux -## Client views + 1. Choose the drop-down with your **Workspaces Name** on the top right of your WorkSpaces session, and then choose **Preferences**. @@ -104 +90 @@ You must run one of the following web browsers on your Windows, macOS, or Linux -WorkSpaces Web Access supports multiple screen resolutions. The minimum supported resolution is 960x720 pixels, and the maximum supported resolution is 2560x1600 pixels. + 2. Choose the **Audio and Video** tab, scroll down to **Camera** , and then select the camera to use. @@ -106 +92 @@ WorkSpaces Web Access supports multiple screen resolutions. The minimum supporte -Only WorkSpaces configured for DCV supports multiple monitors. For more information, see Using multiple screens. + 3. Select **Save**. @@ -108 +93,0 @@ Only WorkSpaces configured for DCV supports multiple monitors. For more informat -## Proxy servers @@ -110 +94,0 @@ Only WorkSpaces configured for DCV supports multiple monitors. For more informat -If you are required to use a proxy server to access the internet, you can configure your browser to use the proxy server. @@ -112 +95,0 @@ If you are required to use a proxy server to access the internet, you can config -###### Limits @@ -114 +97 @@ If you are required to use a proxy server to access the internet, you can config - * Proxy with authentication is not currently supported. +###### Note @@ -116 +99 @@ If you are required to use a proxy server to access the internet, you can config - * Proxy server support for Web Access can vary by browser. Chrome (versions 55 and later) supports Web Access traffic routed through a web proxy, while the current Firefox does not. +Cameras will appear only if your administrator has enabled webcam support for your WorkSpace. You can't change the webcam selection while the webcam is in use. @@ -118 +101 @@ If you are required to use a proxy server to access the internet, you can config - * WorkSpaces configured for DCV use the web browser's proxy configuration. +**Using a webcam during your session** @@ -119,0 +103 @@ If you are required to use a proxy server to access the internet, you can config +Toggle the webcam button in the client toolbar as shown below to enable or disable your webcam during your session. The webcam button appears on the toolbar only if webcam support is enabled and at least one webcam is connected to your local device. @@ -120,0 +105 @@ If you are required to use a proxy server to access the internet, you can config + @@ -121,0 +107 @@ If you are required to use a proxy server to access the internet, you can config +The following table shows different webcam states: @@ -123 +109,5 @@ If you are required to use a proxy server to access the internet, you can config -## Features for WorkSpaces configured for DCV +Icon | Description +---|--- + | The webcam is disabled. Toggle the button to enable the webcam. If you didn't previously select the webcam to use, the default webcam is used. + | The webcam is enabled, but it's not in use. Toggle the button to disable the webcam. + | The webcam is in use by a remote application in the WorkSpaces session. Toggle the button to disable the webcam. @@ -125 +115 @@ If you are required to use a proxy server to access the internet, you can config -The following features apply only to WorkSpaces configured for DCV. +### Using multiple screens @@ -127 +117 @@ The following features apply only to WorkSpaces configured for DCV. -### Copying and pasting +To use multiple screens, choose the multiscreen button in the client as shown in the following example. Multiple screens are supported with up to two monitors. @@ -129 +119 @@ The following features apply only to WorkSpaces configured for DCV. -You can use the web browser client to copy and paste text and images between your local computer and the WorkSpaces session. Use keyboard shortcuts and context (right-click) menu to copy and paste text and images on Google Chrome and Microsoft Edge. Mozilla Firefox and Apple Safari does not support copying and pasting images, and require using the clipboard dialog to copy and paste text. + @@ -131 +121 @@ You can use the web browser client to copy and paste text and images between you -### Using a webcam +## Supported features and gestures on Android tablets and iPads @@ -133 +123 @@ You can use the web browser client to copy and paste text and images between you -Webcam functionality is supported only on Chromium-based browsers, such as Google Chrome and Microsoft Edge. It isn't supported on Mozilla Firefox. +Android tablets are supported on Google Chrome, and iPads are supported on Apple Safari. Touch input is supported for both device types. @@ -135 +125 @@ Webcam functionality is supported only on Chromium-based browsers, such as Googl -The steps for selecting the camera to use are the same across all supported web browsers. +###### Gestures @@ -137 +127 @@ The steps for selecting the camera to use are the same across all supported web -###### To select the webcam to use + * Use a two-finger single tap gesture or use the client toolbar button to toggle the on-screen keyboard. @@ -139 +129 @@ The steps for selecting the camera to use are the same across all supported web - 1. In the client, choose the **Workspaces Name** menu, and then choose **Preferences**. + * Use a pinch gesture to zoom in our out on the screen. When zoomed in, use a two-finger slide gesture to pan the screen horizontally or vertically. @@ -141 +131 @@ The steps for selecting the camera to use are the same across all supported web - 2. Choose the **Camera** tab, and then select the camera to use. + * Use a three-finger single tap gesture to show the client toolbar when it has been hidden by auto-hide. @@ -143 +132,0 @@ The steps for selecting the camera to use are the same across all supported web - 3. Close the **Preferences** modal. @@ -146,0 +136 @@ The steps for selecting the camera to use are the same across all supported web