AWS appstream2 documentation change
Summary
Updated service name references from 'Amazon AppStream 2.0' to 'Amazon WorkSpaces Applications' throughout the document, including titles, links, and configuration references.
Security assessment
The changes are purely branding/terminology updates without addressing vulnerabilities, security controls, or security features. No security-related configuration changes or vulnerability mitigations were introduced.
Diff
diff --git a/appstream2/latest/developerguide/getting-started.md b/appstream2/latest/developerguide/getting-started.md index 2071b0ecc..7e6cdb2ca 100644 --- a//appstream2/latest/developerguide/getting-started.md +++ b//appstream2/latest/developerguide/getting-started.md @@ -3 +3 @@ -[Documentation](/index.html)[Amazon AppStream 2.0](/appstream2/index.html)[Administration Guide](what-is-appstream.html) +[Documentation](/index.html)[Amazon WorkSpaces Applications](/appstream2/index.html)[Administration Guide](what-is-appstream.html) @@ -7 +7 @@ Step 1: Set Up a Sample Stack, Choose an Image, and Configure a FleetStep 2: Pro -# Get Started with Amazon AppStream 2.0: Set Up With Sample Applications +# Get Started with Amazon WorkSpaces Applications: Set Up With Sample Applications @@ -9 +9 @@ Step 1: Set Up a Sample Stack, Choose an Image, and Configure a FleetStep 2: Pro -To stream your applications, Amazon AppStream 2.0 requires an environment that includes a fleet that is associated with a stack, and at least one application image. This tutorial describes how to configure a sample AppStream 2.0 environment for application streaming and give users access to that stream. +To stream your applications, Amazon WorkSpaces Applications requires an environment that includes a fleet that is associated with a stack, and at least one application image. This tutorial describes how to configure a sample WorkSpaces Applications environment for application streaming and give users access to that stream. @@ -13 +13 @@ To stream your applications, Amazon AppStream 2.0 requires an environment that i -For additional guidance in learning how to get started with AppStream 2.0, see the [Amazon AppStream 2.0 Getting Started Guide](https://aws.amazon.com/appstream2/stream-desktop-applications/). This guide describes how to install and configure two applications, perform foundational administrative tasks using the AppStream 2.0 console, and provision an Amazon Virtual Private Cloud by using a provided AWS CloudFormation template. +For additional guidance in learning how to get started with WorkSpaces Applications, see the [Amazon WorkSpaces Applications Getting Started Guide](https://aws.amazon.com/appstream2/stream-desktop-applications/). This guide describes how to install and configure two applications, perform foundational administrative tasks using the WorkSpaces Applications console, and provision an Amazon Virtual Private Cloud by using a provided AWS CloudFormation template. @@ -32 +32 @@ Before you can stream your applications, you need to set up a stack, choose an i - 1. Open the AppStream 2.0 console at [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2). + 1. Open the WorkSpaces Applications console at [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2). @@ -46 +46 @@ Before you can stream your applications, you need to set up a stack, choose an i - * **Streaming Protocol Preference** — Specify the streaming protocol you’d like your stack to prefer, UDP or TCP. UDP is currently only supported in the Windows native client. For more information, see [System Requirements and Feature Support (AppStream 2.0 Client)](./client-system-requirements-feature-support.html). + * **Streaming Protocol Preference** — Specify the streaming protocol you’d like your stack to prefer, UDP or TCP. UDP is currently only supported in the Windows native client. For more information, see [System Requirements and Feature Support (WorkSpaces Applications Client)](./client-system-requirements-feature-support.html). @@ -48 +48 @@ Before you can stream your applications, you need to set up a stack, choose an i - * **Tags** — Choose **Add Tag** , and type the key and value for the tag. To add more tags, repeat this step as needed. For more information, see [Tagging Your Amazon AppStream 2.0 Resources](./tagging-basic.html). + * **Tags** — Choose **Add Tag** , and type the key and value for the tag. To add more tags, repeat this step as needed. For more information, see [Tagging Your Amazon WorkSpaces Applications Resources](./tagging-basic.html). @@ -54 +54 @@ After you create the interface endpoint, you can use it to keep streaming traffi - * **Embed AppStream 2.0 (Optional)** — To embed an AppStream 2.0 streaming session in a webpage, specify the domain to host the embedded streaming session. Embedded streaming sessions are only supported over HTTPS [TCP port 443]. + * **Embed WorkSpaces Applications (Optional)** — To embed an WorkSpaces Applications streaming session in a webpage, specify the domain to host the embedded streaming session. Embedded streaming sessions are only supported over HTTPS [TCP port 443]. @@ -58 +58 @@ After you create the interface endpoint, you can use it to keep streaming traffi -You must meet prerequisites and perform additional steps to configure embedded AppStream 2.0 streaming sessions. For more information, see [Embed Amazon AppStream 2.0 Streaming Sessions](./embed-streaming-sessions.html). +You must meet prerequisites and perform additional steps to configure embedded WorkSpaces Applications streaming sessions. For more information, see [Embed Amazon WorkSpaces Applications Streaming Sessions](./embed-streaming-sessions.html). @@ -66 +66 @@ You must meet prerequisites and perform additional steps to configure embedded A - * **Choose instance type** — Choose the instance type that matches the performance requirements of your applications. All streaming instances in your fleet launch with the instance type that you select. For more information, see [AppStream 2.0 Instance Families](./instance-types.html). + * **Choose instance type** — Choose the instance type that matches the performance requirements of your applications. All streaming instances in your fleet launch with the instance type that you select. For more information, see [WorkSpaces Applications Instance Families](./instance-types.html). @@ -88 +88 @@ Multi-session is available only on Always-on and On-demand fleets powered by a W -Make sure you are using latest AppStream 2.0 images for multi-session fleets. To keep your images are up-to-date, see [Keep Your Amazon AppStream 2.0 Image Up-to-Date](./keep-image-updated.html). For details on supported images and AppStream 2.0 agent versions for multi-session, see [AppStream 2.0 Base Image and Managed Image Update Release Notes](./base-image-version-history.html). +Make sure you are using latest WorkSpaces Applications images for multi-session fleets. To keep your images are up-to-date, see [Keep Your Amazon WorkSpaces Applications Image Up-to-Date](./keep-image-updated.html). For details on supported images and WorkSpaces Applications agent versions for multi-session, see [WorkSpaces Applications Base Image and Managed Image Update Release Notes](./base-image-version-history.html). @@ -104 +104 @@ For a single-session fleet, one instance will be launched of every user session. - * **Scaling details** — Specify the scaling policies that AppStream 2.0 uses to increase and decrease the capacity of your fleet. Note that the size of your fleet is limited by the minimum and maximum capacity that you specified. For more information, see [Fleet Auto Scaling for Amazon AppStream 2.0](./autoscaling.html). + * **Scaling details** — Specify the scaling policies that WorkSpaces Applications uses to increase and decrease the capacity of your fleet. Note that the size of your fleet is limited by the minimum and maximum capacity that you specified. For more information, see [Fleet Auto Scaling for Amazon WorkSpaces Applications](./autoscaling.html). @@ -106 +106 @@ For a single-session fleet, one instance will be launched of every user session. - * **IAM role (Advanced)** — When you apply an IAM role from your account to an AppStream 2.0 fleet instance, you can make AWS API requests from the fleet instance without manually managing AWS credentials. To apply an IAM role, do either of the following: + * **IAM role (Advanced)** — When you apply an IAM role from your account to an WorkSpaces Applications fleet instance, you can make AWS API requests from the fleet instance without manually managing AWS credentials. To apply an IAM role, do either of the following: @@ -108 +108 @@ For a single-session fleet, one instance will be launched of every user session. - * To use an existing IAM role in your Amazon Web Services account, choose the role that you want to use from the **IAM role** list. The role must must be accessible from the fleet instance. For more information, see [Configuring an Existing IAM Role to Use With AppStream 2.0 Streaming Instances](./configuring-existing-iam-role-to-use-with-streaming-instances.html). + * To use an existing IAM role in your Amazon Web Services account, choose the role that you want to use from the **IAM role** list. The role must must be accessible from the fleet instance. For more information, see [Configuring an Existing IAM Role to Use With WorkSpaces Applications Streaming Instances](./configuring-existing-iam-role-to-use-with-streaming-instances.html). @@ -110 +110 @@ For a single-session fleet, one instance will be launched of every user session. - * To create a new IAM role, choose **Create new IAM role** and follow the steps in [How to Create an IAM Role to Use With AppStream 2.0 Streaming Instances](./how-to-create-iam-role-to-use-with-streaming-instances.html). + * To create a new IAM role, choose **Create new IAM role** and follow the steps in [How to Create an IAM Role to Use With WorkSpaces Applications Streaming Instances](./how-to-create-iam-role-to-use-with-streaming-instances.html). @@ -138 +138 @@ Google Drive and OneDrive options are currently not available for multi-session - * **Enable Home Folders** — By default, this setting is enabled. Keep the default setting. For information about requirements for enabling home folders, see [Enable Home Folders for Your AppStream 2.0 Users](./enable-home-folders.html). + * **Enable Home Folders** — By default, this setting is enabled. Keep the default setting. For information about requirements for enabling home folders, see [Enable Home Folders for Your WorkSpaces Applications Users](./enable-home-folders.html). @@ -140 +140 @@ Google Drive and OneDrive options are currently not available for multi-session - * **Enable Google Drive** — Optionally, you can enable users to link their Google Drive for G Suite account to AppStream 2.0. You can enable Google Drive for accounts in G Suite domains only, not for personal Gmail accounts. For information about requirements for enabling Google Drive, see [Enable Google Drive for Your AppStream 2.0 Users](./enable-google-drive.html). + * **Enable Google Drive** — Optionally, you can enable users to link their Google Drive for G Suite account to WorkSpaces Applications. You can enable Google Drive for accounts in G Suite domains only, not for personal Gmail accounts. For information about requirements for enabling Google Drive, see [Enable Google Drive for Your WorkSpaces Applications Users](./enable-google-drive.html). @@ -142 +142 @@ Google Drive and OneDrive options are currently not available for multi-session - * **Enable OneDrive** — Optionally, you can enable users to link their OneDrive for Business account to AppStream 2.0. You can enable OneDrive for accounts in OneDrive domains only, not for personal accounts. For information about requirements for enabling OneDrive, see [Enable OneDrive for Your AppStream 2.0 Users](./enable-onedrive.html). + * **Enable OneDrive** — Optionally, you can enable users to link their OneDrive for Business account to WorkSpaces Applications. You can enable OneDrive for accounts in OneDrive domains only, not for personal accounts. For information about requirements for enabling OneDrive, see [Enable OneDrive for Your WorkSpaces Applications Users](./enable-onedrive.html). @@ -152 +152 @@ Google Drive and OneDrive options are currently not available for multi-session - * **Clipboard** — By default, users can copy and paste data between their local device and streaming applications. You can limit Clipboard options so that users can paste data to their remote streaming session only or copy data to their local device only. You can also disable Clipboard options entirely. Users can still copy and paste between applications in their streaming session. You can choose **Copy to local device character limit** or **Paste to remote session character limit** or both to limit the amount of data that users can copy or paste when using the clipboard, either in or out of their AppStream 2.0 streaming session. The value can be between 1 and 20,971,520 (20 MB), and defaults to the maximum value when unspecified. + * **Clipboard** — By default, users can copy and paste data between their local device and streaming applications. You can limit Clipboard options so that users can paste data to their remote streaming session only or copy data to their local device only. You can also disable Clipboard options entirely. Users can still copy and paste between applications in their streaming session. You can choose **Copy to local device character limit** or **Paste to remote session character limit** or both to limit the amount of data that users can copy or paste when using the clipboard, either in or out of their WorkSpaces Applications streaming session. The value can be between 1 and 20,971,520 (20 MB), and defaults to the maximum value when unspecified. @@ -158 +158 @@ Google Drive and OneDrive options are currently not available for multi-session -If your users require AppStream 2.0 file system redirection to access local drives and folders during their streaming sessions, you must enable both file upload and download. To use file system redirection, your users must have AppStream 2.0 client version 1.0.480 or later installed. For more information, see [Enable File System Redirection for Your AppStream 2.0 Users](./enable-file-system-redirection.html). +If your users require WorkSpaces Applications file system redirection to access local drives and folders during their streaming sessions, you must enable both file upload and download. To use file system redirection, your users must have WorkSpaces Applications client version 1.0.480 or later installed. For more information, see [Enable File System Redirection for Your WorkSpaces Applications Users](./enable-file-system-redirection.html). @@ -162 +162 @@ If your users require AppStream 2.0 file system redirection to access local driv - * **Password sign in for Active Directory** — Users can enter their Active Directory domain password to sign in to an AppStream 2.0 streaming instance that is joined to an Active Directory domain. + * **Password sign in for Active Directory** — Users can enter their Active Directory domain password to sign in to an WorkSpaces Applications streaming instance that is joined to an Active Directory domain. @@ -166 +166 @@ You can also enable **Smart card sign in for Active Directory**. At least one au - * **Smart card sign in for Active Directory** — Users can use a smart card reader and smart card connected to their local computer to sign in to an AppStream 2.0 streaming instance that is joined to an Active Directory domain. + * **Smart card sign in for Active Directory** — Users can use a smart card reader and smart card connected to their local computer to sign in to an WorkSpaces Applications streaming instance that is joined to an Active Directory domain. @@ -172 +172 @@ You can also enable **Password sign in for Active Directory**. At least one auth -**Clipboard, file transfer, and print to local device settings** — These settings control only whether users can use AppStream 2.0 data transfer features. If your image provides access to a browser, network printer, or other remote resource, your users might be able to transfer data to or from their streaming session in other ways. +**Clipboard, file transfer, and print to local device settings** — These settings control only whether users can use WorkSpaces Applications data transfer features. If your image provides access to a browser, network printer, or other remote resource, your users might be able to transfer data to or from their streaming session in other ways. @@ -174 +174 @@ You can also enable **Password sign in for Active Directory**. At least one auth -**Authentication settings** — These settings control only the authentication method that can be used for Windows sign in to an AppStream 2.0 streaming instance (fleet or image builder). They do not control the authentication method that can be used for in-session authentication, after a user signs in to a streaming instance. For information about configuration requirements for using smart cards for Windows sign in and in-session authentication, see [Smart Cards](./feature-support-USB-devices-qualified.html#feature-support-USB-devices-qualified-smart-cards). +**Authentication settings** — These settings control only the authentication method that can be used for Windows sign in to an WorkSpaces Applications streaming instance (fleet or image builder). They do not control the authentication method that can be used for in-session authentication, after a user signs in to a streaming instance. For information about configuration requirements for using smart cards for Windows sign in and in-session authentication, see [Smart Cards](./feature-support-USB-devices-qualified.html#feature-support-USB-devices-qualified-smart-cards). @@ -184 +184 @@ You can also enable **Password sign in for Active Directory**. At least one auth -For information about requirements for enabling and administering application settings persistence, see [Enable Application Settings Persistence for Your AppStream 2.0 Users](./app-settings-persistence.html). +For information about requirements for enabling and administering application settings persistence, see [Enable Application Settings Persistence for Your WorkSpaces Applications Users](./app-settings-persistence.html). @@ -197 +197 @@ For information about requirements for enabling and administering application se -After you create a stack with an associated fleet, you can provide access to users through the AppStream 2.0 user pool, SAML 2.0 [single sign-on (SSO)], or the AppStream 2.0 API. For more information, see [User Pool Administration in Amazon AppStream 2.0](./user-pool-admin.html) and [Amazon AppStream 2.0 Integration with SAML 2.0](./external-identity-providers.html). +After you create a stack with an associated fleet, you can provide access to users through the WorkSpaces Applications user pool, SAML 2.0 [single sign-on (SSO)], or the WorkSpaces Applications API. For more information, see [User Pool Administration in Amazon WorkSpaces Applications](./user-pool-admin.html) and [Amazon WorkSpaces Applications Integration with SAML 2.0](./external-identity-providers.html). @@ -201 +201 @@ After you create a stack with an associated fleet, you can provide access to use -Users in the AppStream 2.0 user pool can't be assigned to stacks with fleets that are joined to an Active Directory domain. +Users in the WorkSpaces Applications user pool can't be assigned to stacks with fleets that are joined to an Active Directory domain. @@ -203 +203 @@ Users in the AppStream 2.0 user pool can't be assigned to stacks with fleets tha -For this getting started exercise, you can use the AppStream 2.0 user pool. This access method enables you to create and manage users by using a permanent login portal URL. To quickly test application streaming without setting up users, complete the following steps to create a temporary URL, also known as a streaming URL. +For this getting started exercise, you can use the WorkSpaces Applications user pool. This access method enables you to create and manage users by using a permanent login portal URL. To quickly test application streaming without setting up users, complete the following steps to create a temporary URL, also known as a streaming URL. @@ -222 +222 @@ For this getting started exercise, you can use the AppStream 2.0 user pool. This -After you provide your users with access to AppStream 2.0, they can start AppStream 2.0 streaming sessions. If you provide access through the AppStream 2.0 user pool, they must use a web browser for streaming sessions. +After you provide your users with access to WorkSpaces Applications, they can start WorkSpaces Applications streaming sessions. If you provide access through the WorkSpaces Applications user pool, they must use a web browser for streaming sessions. @@ -224 +224 @@ After you provide your users with access to AppStream 2.0, they can start AppStr -If you plan to use SAML 2.0 [single sign-on (SSO)] or the AppStream 2.0 API to provide access to your users, you can make the AppStream 2.0 client available to them. The AppStream 2.0 client is a native application that is designed for users who require additional functionality during their AppStream 2.0 streaming sessions. For more information, see [Provide Access Through the AppStream 2.0 Client](./client-application.html). +If you plan to use SAML 2.0 [single sign-on (SSO)] or the WorkSpaces Applications API to provide access to your users, you can make the WorkSpaces Applications client available to them. The WorkSpaces Applications client is a native application that is designed for users who require additional functionality during their WorkSpaces Applications streaming sessions. For more information, see [Provide Access Through the WorkSpaces Applications Client](./client-application.html). @@ -230 +230 @@ For more information, see the following: - * Learn how to use the AppStream 2.0 image builder to add your own applications and create images that you can stream to your users. For more information, see [Tutorial: Create a Custom AppStream 2.0 Image by Using the AppStream 2.0 Console](./tutorial-image-builder.html). + * Learn how to use the WorkSpaces Applications image builder to add your own applications and create images that you can stream to your users. For more information, see [Tutorial: Create a Custom WorkSpaces Applications Image by Using the WorkSpaces Applications Console](./tutorial-image-builder.html). @@ -232 +232 @@ For more information, see the following: - * Provide persistent storage for your session users by using AppStream 2.0 home folders, Google Drive, and OneDrive. For more information, see [Enable and Administer Persistent Storage for Your AppStream 2.0 Users](./persistent-storage.html). + * Provide persistent storage for your session users by using WorkSpaces Applications home folders, Google Drive, and OneDrive. For more information, see [Enable and Administer Persistent Storage for Your WorkSpaces Applications Users](./persistent-storage.html). @@ -234 +234 @@ For more information, see the following: - * Integrate your AppStream 2.0 streaming resources with your Microsoft Active Directory environment. For more information, see [Using Active Directory with AppStream 2.0](./active-directory.html). + * Integrate your WorkSpaces Applications streaming resources with your Microsoft Active Directory environment. For more information, see [Using Active Directory with WorkSpaces Applications](./active-directory.html). @@ -236 +236 @@ For more information, see the following: - * Control who has access to your AppStream 2.0 streaming instances. For more information, see [Identity and Access Management for Amazon AppStream 2.0](./controlling-access.html), [Amazon AppStream 2.0 User Pools](./user-pool.html) and [Amazon AppStream 2.0 Integration with SAML 2.0](./external-identity-providers.html). + * Control who has access to your WorkSpaces Applications streaming instances. For more information, see [Identity and Access Management for Amazon WorkSpaces Applications](./controlling-access.html), [Amazon WorkSpaces Applications User Pools](./user-pool.html) and [Amazon WorkSpaces Applications Integration with SAML 2.0](./external-identity-providers.html). @@ -238 +238 @@ For more information, see the following: - * Monitor your AppStream 2.0 resources by using Amazon CloudWatch. For more information, see [AppStream 2.0 Metrics and Dimensions ](./monitoring-with-cloudwatch.html). + * Monitor your WorkSpaces Applications resources by using Amazon CloudWatch. For more information, see [WorkSpaces Applications Metrics and Dimensions ](./monitoring-with-cloudwatch.html). @@ -240 +240 @@ For more information, see the following: - * Troubleshoot your AppStream 2.0 streaming experience. For more information, see [Troubleshooting](./troubleshooting.html). + * Troubleshoot your WorkSpaces Applications streaming experience. For more information, see [Troubleshooting](./troubleshooting.html).