Menu
Amazon AppStream 2.0
Developer Guide

User Pool Administration

To perform administrator actions, log in to the AppStream 2.0 console in the AWS Management Console for the desired region and select User Pool in the left navigation pane. The User Pool dashboard supports bulk operations on a list of users for some actions. An administrator can select multiple users on which to perform the same action from the Actions list. Bulk user creation or disable is not supported. User pool users are created and managed on a per-region basis.

Note

AppStream 2.0 sends email to users on your behalf, such as when a new user is created or a user is assigned to a stack. To ensure that email is delivered, add no-reply@accounts.aws-region-code.amazonappstream.com to your whitelist, where aws-region-code is a valid AWS region code in which you are working. If users are having difficulty finding the emails, ask them to check their "spam" email folder.

Choose a User Pool administration task from the following list:

Creating a User

Users are managed on a per region basis. You must use a valid and unique email address for each new user within a region. However, you can re-use an email address for a new user in another region.

When you create a new user, be aware of the following:

  • There is no limit on the number of users in the user pool.

  • Once created, the user's email, first name, and last name cannot be edited.

  • A user can be enabled and disabled by the administrator, but not deleted.

  • You can assign one or more stacks to the user after the user is created.

To create a new user

  1. Open the AppStream 2.0 console at https://console.aws.amazon.com/appstream2.

  2. On the left navigation pane, choose User Pool, Create User.

  3. For Email, enter the unique email address for this user.

  4. For First name and Last name, enter values. These fields do not have to be unique.

  5. Choose Create User.

Once the user is created, AppStream 2.0 sends a welcome email to the user. This email has the login portal link, the login email address to be used, and a temporary password. By browsing to the login portal and using the temporary password, the user can set a permanent password to access their applications.

By default, the new user's status is Enabled, meaning you can assign one or more stacks to the user, and perform other actions as described in the following sections.

Assigning Stacks to Users

An AppStream 2.0 administrator can assign one or more stacks to one or more user pool users. After being assigned at least one stack, the user can log in and launch applications. If users are assigned more than one stack, they are presented with a list of stacks as catalogs to choose from before launching applications.

To assign a stack to users

  1. Open the AppStream 2.0 console at https://console.aws.amazon.com/appstream2.

  2. On the left navigation pane, choose User Pool and select the users with which to assign a stack.

  3. Choose Actions, Assign stack.

  4. Confirm the list of users in the resulting dialog box. For Stack, select the desired stack.

  5. By default, Send email notification to user is enabled. Unselect this option if you do not want to send the notification email to the user at this time.

  6. Choose Assign stack.

Unassigning Stacks from Users

An AppStream 2.0 administrator can unassign stacks from one or more user pool users. After being unassigned a stack, the user can no longer launch applications from that stack.

To unassign a stack from users

  1. Open the AppStream 2.0 console at https://console.aws.amazon.com/appstream2.

  2. On the left navigation pane, choose User Pool and select the users from which to unassign a stack.

  3. Choose Actions, Unassign stack.

  4. Confirm the list of users in the resulting dialog box. For Stack, select the desired stack. This list includes all stacks, assigned or unassigned.

  5. Choose Unassign stack.

Disabling Users

An AppStream 2.0 administrator can disable one or more user pool users, one at a time. After being disabled, the user can no longer log in until they are re-enabled. This action does not delete the user. If the user is currently connected when an administrator disables them, their session remains active until the session cookie expires (about one hour). Stack assignments for the user are retained. If the user is re-enabled, the stack assignment becomes active again.

To disable a user

  1. Open the AppStream 2.0 console at https://console.aws.amazon.com/appstream2.

  2. On the left navigation pane, choose User Pool and select the user to disable.

  3. Choose Actions, Disable user.

  4. Confirm the user in the resulting dialog box and choose Disable User.

Enabling Users

An AppStream 2.0 administrator can enable one or more user pool users, one at a time. After being enabled, the user can log in and launch applications from the stacks to which they are assigned. If the user was disabled, these assignments are retained.

To enable users

  1. Open the AppStream 2.0 console at https://console.aws.amazon.com/appstream2.

  2. On the left navigation pane, choose User Pool and select the user to enable.

  3. Choose Actions, Enable user.

  4. Confirm the user in the resulting dialog box and choose Enable User.

Re-Sending Welcome Email

An AppStream 2.0 administrator can re-send the welcome email with connection instructions to user pool users. Unused passwords expire after 90 days. To provide a new temporary password, the administrator must re-send the welcome email. This option is only available until the user sets their permanent password. If they've already set a password and have forgotten it, they can set a new one. For more information, see Resetting a Forgotten Password.

To resend the welcome email for a user

  1. Open the AppStream 2.0 console at https://console.aws.amazon.com/appstream2.

  2. On the left navigation pane, choose User Pool and select a user.

  3. In User Details, choose Resend welcome email.

  4. Confirm the success message at the top of the dashboard.