AWS workspaces medium security documentation change
Summary
Added network conflict warning for IP ranges, S3 access requirements for EC2 Image Builder components, network connectivity endpoints for proxy environments, and detailed Windows image preparation instructions including encryption limitations.
Security assessment
The changes add explicit security documentation about required S3 bucket access controls and network endpoint allowlists for environments using data perimeters or proxies. These configurations are critical to prevent service disruptions and potential security misconfigurations. The warning about IP range conflicts and encryption limitations helps avoid deployment failures that could indirectly impact security posture. The S3 bucket ARNs and HTTPS endpoints are security-relevant configurations for network filtering scenarios.
Diff
diff --git a/workspaces/latest/adminguide/byol-windows-images.md b/workspaces/latest/adminguide/byol-windows-images.md index 262ad564a..ac9143d5f 100644 --- a//workspaces/latest/adminguide/byol-windows-images.md +++ b//workspaces/latest/adminguide/byol-windows-images.md @@ -56 +56 @@ If you plan to use GPU-enabled (Graphics.g4dn, GraphicsPro.g4dn, Graphics, and G - * WorkSpaces can use a management interface in the /16 IP address range. The management interface is connected to a secure WorkSpaces management network used for interactive streaming. This allows WorkSpaces to manage your WorkSpaces. For more information, see [Network interfaces](./workspaces-port-requirements.html#network-interfaces). You must reserve a /16 netmask from at least one of the following IP address ranges for this purpose: + * WorkSpaces can use a management interface in the /16 IP address range. The management interface is connected to a secure WorkSpaces management network used for interactive streaming. This allows WorkSpaces to manage your WorkSpaces. For more information, see [Network interfaces](./workspaces-port-requirements.html#network-interfaces). You must reserve a /16 netmask from at least one of the following IP address ranges for this purpose and ensure that your chosen IP address range does not conflict in your network: @@ -74 +73,0 @@ If you plan to use GPU-enabled (Graphics.g4dn, GraphicsPro.g4dn, Graphics, and G - * Before importing a BYOL customized virtual machine image, validate your image. @@ -76 +74,0 @@ If you plan to use GPU-enabled (Graphics.g4dn, GraphicsPro.g4dn, Graphics, and G -WorkSpaces only supports images with UEFI boot mode enabled. For more information on how EC2 Image Builder detects the boot mode, see [Volume types and file systems supported by VM Import/Export ](https://docs.aws.amazon.com/vm-import/latest/userguide/prerequisites.html#vmimport-volume-types:~:text=Linux/Unix-,Windows,-GUID%20Partition%20Table) in the _VM Import/Export User Guide_. @@ -78,0 +77 @@ WorkSpaces only supports images with UEFI boot mode enabled. For more informatio +#### S3 Access @@ -79,0 +79,52 @@ WorkSpaces only supports images with UEFI boot mode enabled. For more informatio +If you use data perimeters to control access to Amazon S3 in your environment, you might need to explicitly allow access to Amazon S3 buckets that store components managed by EC2 Image Builder. You can use the bucket ARN or bucket URL to allowlist these buckets, depending on how you control access to Amazon S3. + +Required access for Amazon EC2 Image Builder Component management bootstrapping scripts: + + * **S3 bucket ARN:** `arn:`<AWS partition>`:s3:::ec2imagebuilder-managed-resources-`<AWS Region>`-prod` + + * **S3 bucket URL:** `https://ec2imagebuilder-managed-resources-`<AWS Region>`.s3.`<AWS Region>`.`<AWS partition-specific domain name>`` + + + + +Required access for Amazon EC2 Image Builder Managed components: + + * **S3 bucket ARN:** `arn:`<AWS partition>`:s3:::ec2imagebuilder-toe-`<AWS Region>`-prod` + + * **S3 bucket URL:** `https://ec2imagebuilder-toe-`<AWS Region>`.s3.`<AWS Region>`.`<AWS partition-specific domain name>`` + + + + +#### Network Connectivity + +If you use a proxy to filter outbound communication (such as AWS Network Firewall) from your AWS account that you are importing a BYOL image, ensure that the following HTTPS endpoints are accessible: + +Required access for Amazon EC2 Image Builder component: + + * `ssm.`<region>`.amazonaws.com` + + * `ssmmessages.`<region>`.amazonaws.com` + + * `ec2messages.`<region>`.amazonaws.com` + + * `imagebuilder.`<region>`.amazonaws.com` + + * `ec2.`<region>`.amazonaws.com` + + * `s3.`<region>`.amazonaws.com` + + * `s3.us-east-1.amazonaws.com` + + * `tools.amazonworkspaces.com` + + * `go.microsoft.com` + + * `definitionupdates.microsoft.com` + + * `time.windows.com` + + + + +The above list is not exhaustive, and it is recommended to use a VPC that has public internet access. The image import process does not support VPCs that use AWS PrivateLink. @@ -100 +151,16 @@ Your VM must run one of the following Windows versions: -All supported OS versions support all of the compute types available in the AWS Region where you're using WorkSpaces. Versions of Windows that are no longer supported by Microsoft are not guaranteed to work and are not supported by AWS Support. +You will need a Windows virtual machine image or Windows ISO image file that uses a supported Windows OS version: + + * Download an Enterprise edition ISO image by signing into the [ Microsoft 365 admin center](https://admin.microsoft.com/adminportal/home#/subscriptions/vlnew). Sign in to your subscription on the [ Visual Studio Subscriptions portal](https://my.visualstudio.com/downloads) for available downloads. Do not use an ISO file downloaded from the [ public Windows 11 download website](https://www.microsoft.com/en-us/software-download/windows11) which does not provide an Enterprise edition ISO. + + * To use a customized virtual machine image, validate your image before import. + + * Encrypted AMIs are not supported in the importing process. Encryption can be enabled after the final WorkSpaces is provisioned. + + * Default EBS encryption is not supported. Prior to importing an image, [ disable default encryption in EC2 console](https://docs.aws.amazon.com/ebs/latest/userguide/encryption-by-default.html). + + * For Windows 11 images, WorkSpaces requires UEFI boot mode be enabled. For more information on how EC2 Image Builder detects the boot mode, see [Volume types and file systems supported by VM Import/Export ](https://docs.aws.amazon.com/vm-import/latest/userguide/prerequisites.html#vmimport-volume-types:~:text=Linux/Unix-,Windows,-GUID%20Partition%20Table) in the _VM Import/Export User Guide_. + + * All supported OS versions support all of the compute types available in the AWS Region where you're using WorkSpaces. Versions of Windows that are no longer supported by Microsoft are not guaranteed to work and are not supported by AWS Support. + + +