Menu
Amazon AppStream 2.0
Developer Guide

Enable and Administer Google Drive for Your AppStream 2.0 Users

Amazon AppStream 2.0 supports the following persistent storage options for users in your organization:

  • Google Drive for G Suite

  • OneDrive for Business

  • Home folders

You can enable one or more options for your organization. When you enable Google Drive for G Suite for an AppStream 2.0 stack, users of the stack can link their Google Drive for G Suite account to AppStream 2.0. Then they can sign into their Google Drive for G Suite account and access their Google Drive folder during application streaming sessions. Any changes that they make to files or folders in Google Drive during those sessions are automatically backed up and synchronized, so that they are available to users outside of their streaming sessions.

Important

You can enable Google Drive for G Suite for accounts in your G Suite domains only, but not for personal Gmail accounts.

Enable Google Drive for Your AppStream 2.0 Users

Before enabling Google Drive, you must do the following:

  • Have an active G Suite account with a valid organizational domain and user accounts in the domain to use with AppStream 2.0.

  • Configure an AppStream 2.0 stack with an associated fleet.

    The fleet must use an image that uses a version of the AppStream 2.0 agent released on or after May 31, 2018. For more information, see Amazon AppStream 2.0 Agent Version History. The fleet must also have access to the internet.

  • Add Amazon AppStream 2.0 as a trusted app in one or more domains associated with your G Suite account. You can enable Google Drive for up to 10 domains.

Follow these steps to add Amazon AppStream 2.0 as a trusted app in your G Suite domains.

To add Amazon AppStream 2.0 as a trusted app in your G Suite domains

  1. Sign in to the G Suite Admin console at https://admin.google.com/.

  2. Choose Dashboard.

  3. Choose the main menu in the upper left of the window (to the left of the Google Admin title), then choose Security, Settings.

  4. Choose API Permissions.

  5. At the bottom of the API Access list, choose the Trusted Apps link.

  6. Choose the Whitelist an App [plus sign (+) icon] in the bottom right of the window.

  7. In the Add APP to Trusted List dialog box, do the following. When you're done, choose Add:

    • For Select App Type, choose Web Application.

    • For OAuth2 Client ID, type the Amazon AppStream 2.0 OAuth client ID for your AWS Region. For a list of client IDs, see the table that follows this procedure.

  8. Confirm that Amazon AppStream 2.0 appears in the list of trusted apps.

Amazon AppStream 2.0 OAuth2 client IDs

Region Amazon AppStream 2.0 OAuth client ID
us-east-1 (N.Virginia) 266080779488-15n5q5nkiclp6m524qibnmhmbsg0hk92.apps.googleusercontent.com
us-west-2 (Oregon) 1026466167591-i4jmemrggsjomp9tnkkcs5tniggfiujb.apps.googleusercontent.com
ap-northeast-1 (Tokyo) 922579247628-qpl9kpihg3hu5dul2lphbjs4qbg6mjm2.apps.googleusercontent.com
ap-southeast-1 (Singapore) 856871139998-4eia2n1db5j6gtv4c1rdte1fh1gec8vs.apps.googleusercontent.com
ap-southeast-2 (Sydney) 151535156524-b889372osskprm4dt1clpm53mo3m9omp.apps.googleusercontent.com
eu-central-1 (Frankfurt) 643727794574-1se5360a77i84je9j3ap12obov1ib76q.apps.googleusercontent.com
eu-west-1 (Ireland) 599492309098-098muc7ofjfo9vua5rm5u9q2k3mlok3j.apps.googleusercontent.com

Follow these steps to enable Google Drive for your AppStream 2.0 users.

To enable Google Drive while creating a stack

  • Follow the steps in Create a Stack, make sure that Enable Google Drive is selected, and that you have specified at least one organizational domain associated with your G Suite account.

To enable Google Drive for an existing stack

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

  2. In the left navigation pane, choose Stacks, and select the stack for which to enable Google Drive.

  3. Below the stacks list, choose Storage and select Enable Google Drive for G Suite.

  4. In the Enable Google Drive for G Suite dialog box, in G Suite domain name, type the name of at least one organizational domain that is associated with your G Suite account. To specify another domain, choose Add another domain, and type the name of the domain.

  5. After you add domain names, choose Enable.

Disable Google Drive for Your AppStream 2.0 Users

You can disable Google Drive for a stack without losing user content that is already stored on Google Drive. Disabling Google Drive for a stack has the following effects:

  • Users who are connected to active streaming sessions for the stack receive an error message. They are informed that they do not have permissions to access their Google Drive.

  • Any new sessions that use the stack with Google Drive disabled do not display Google Drive.

  • Only the specific stack for which Google Drive is disabled is affected.

  • Even if Google Drive is disabled for all stacks, AppStream 2.0 does not delete the user content stored in their Google Drive.

Follow these steps to disable Google Drive for an existing stack.

To disable Google Drive for an existing stack

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

  2. In the left navigation pane, choose Stacks, and select the stack for which to disable Google Drive.

  3. Below the stacks list, choose Storage, and clear the Enable Google Drive for G Suite option.

  4. In the Disable Google Drive for G Suite dialog box, type CONFIRM (case-sensitive) to confirm your choice, then choose Disable.

    When users of the stack start their next AppStream 2.0 streaming session, they can no longer access their Google Drive folder from within that session and future sessions.

Provide Your AppStream 2.0 Users with Guidance for Working with Google Drive

To help your users understand how to work with Google Drive, you can provide them with the information described in this section.

Guidance for Users

When you add your Google Drive account to AppStream 2.0 and you are signed in to an AppStream 2.0 streaming session, you can do the following in Google Drive:

  • Open and edit files and folders that you store in Google Drive. Content that is stored in your Google Drive is specific to you. Other users cannot access your content unless you choose to share it.

  • Upload and download files between your local computer and Google Drive. Any changes that you make to your files and folders in Google Drive during a streaming session are automatically backed up and synchronized. They are available to you when you sign in to your Google Drive account and access Google Drive outside of your streaming session.

  • When you are working in an application, you can access your files and folders that are stored in Google Drive. Choose File, Open from the application interface and browse to the file or folder that you want to open. To save your changes in a file to your Google Drive, choose File, Save from the application and browse to the location in Google Drive where you want to save the file.

  • You can also access Google Drive by choosing My Files from the web view session toolbar.

To add your Google Drive account to AppStream 2.0

To access your Google Drive during AppStream 2.0 streaming sessions, you must first add your Google Drive account to AppStream 2.0.

  1. In the AppStream 2.0 web view session, choose the My Files icon at the top left of your browser.

  2. In the My Files dialog box, choose Add Storage.

  3. Choose Google Drive.

  4. Choose the domain for your Google Drive account.

  5. The Sign in with Google dialog box displays. Type the user name and password for your Google Drive account when prompted.

  6. After your Google Drive account is added to AppStream 2.0, your Google Drive folder displays in My Files.

  7. To work with your files and folders in Google Drive, choose the Google Drive folder and browse to the file or folder you want. If you do not want to work with files in Google Drive during this streaming session, close the My Files dialog box.

To upload and download files between your local computer and your Google Drive

  1. In the AppStream 2.0 web view session, choose the My Files icon at the top left of your browser.

  2. In the My Files dialog box, choose Google Drive.

  3. Navigate to an existing folder, or choose Add Folder to create a new folder.

  4. When the folder that you want displays, do one of the following:

    • To upload a file to the folder, select the file that you want to upload, and choose Upload.

    • To download a file from the folder, select the file that you want to download, choose the down arrow to the right of the file name, and choose Download.