Skip to content

Connecting to Amazon WorkSpaces Desktops

Amazon WorkSpaces is a fully managed cloud-based desktop service that enables end users to access their documents, applications, and resources. Tera2 PCoIP Zero Clients together with Amazon WorkSpaces provide a secure, easy to manage solution for delivering users with a rich desktop experience.

This topic includes information on the following sections:

Prerequisites

For the best user experience, we recommend using firmware version 6.0 or later with Amazon WorkSpaces (hourly pricing).

Before connecting a Tera2 PCoIP Zero Client to an Amazon WorkSpaces desktop, ensure that the following prerequisites are in place:

  • You are using a Tera2 PCoIP Zero Client (TERA2321 or TERA2140 processor) to connect.

    Firmware Versions

    • PCoIP Zero Clients on firmware 6.0+ can connect directly to Amazon WorkSpaces using Multifactor Authentication.

    • Firmware 21.10+ can cache up to 50 registration codes

    • Firmware up to 20.07 can cache up to 10 registration codes

  • You have an AWS account with Amazon WorkSpaces up and running. For information, see AWS documentation.

  • Your network has full connectivity to your Amazon WorkSpaces. For information, see AWS documentation.

Configuration Options

The following session connection types are available for Tera2 PCoIP Zero Client-to-Amazon WorkSpaces connections:

Connection Instructions

Connecting to Amazon WorkSpaces Directly

Multi-factor Authentication (MFA)

When connecting directly, Amazon WorkSpaces may require multi-factor authentication in order to connect. This may be regardless of how you have set up your Amazon WorkSpaces. You are also required to use firmware 6.0 or newer on your PCoIP Zero Client when connecting directly.

To connect using Amazon WorkSpaces session connection type:

  1. From the Options > Configuration > Session menu on the Tera2 PCoIP Zero Client’s OSD, select the OSD: Amazon WorkSpaces Session Settings connection type.

  2. Enter the registration code from the invitation email sent after creating your Amazon WorkSpace.

  3. Enter a name for this registered Amazon WorkSpace instance.

  4. Click the Connect button.

Connecting to Amazon WorkSpaces using the PCoIP Connection Manager for Amazon WorkSpaces

PCoIP Connection Manager for Amazon WorkSpaces is required to connect to Amazon WorkSpaces when using PCoIP Zero Clients with firmware releases older than 6.0. You will need to know the IP address of your PCoIP Connection Manager for Amazon WorkSpaces appliance when using this connection type.

Using the correct firmware

we recommend directly connecting to Amazon WorkSpaces when using PCoIP Zero Clients with firmware 6.0 or newer.

Type 'https://' before the IP address or fully qualified computer name

The syntax of the Server URI (uniform resource identifier) field on the Session page requires https:// before the IP address or FQDN. If you do not enter it, https:// will automatically be inserted when you click OK.

Connecting Using Auto Detect

This connection type automatically detects which broker protocol a connection server is using so users in a mixed environment (for example, one that uses View Connection Servers and PCoIP Connection Managers) do not have to manually reconfigure the session type each time they switch brokers.

To connect using the Auto Detect connection type:

  1. From the Options > Configuration > Session menu on the Tera2 PCoIP Zero Client’s OSD, select the Auto Detect connection type.
  2. In the Server URI field, enter the IP address of your PCoIP Connection Manager for Amazon WorkSpaces, and click OK.
  3. Click the Connect button.
  4. When prompted, enter your login credentials.

After connecting using Auto Detect, the system saves your host's IP address or fully qualified computer name

After you make a successful connection using Auto Detect, the IP address or FQDN of your host is automatically saved in the Server drop-down list on the OSD Connect dialog, along with the IP address or FQDN of any other hosts to which you have connected.

Connecting Using PCoIP Connection Manager

To connect using the PCoIP Connection Manager connection type:

  1. From the Options > Configuration > Session menu on the Tera2 PCoIP Zero Client’s OSD, select the PCoIP Connection Manager connection type.
  2. In the Server URI field, enter the IP address of your PCoIP Connection Manager for Amazon WorkSpaces, and click OK.
  3. Click the Connect button.
  4. When prompted, enter your login credentials.

Advanced settings

For details about advanced settings, see OSD: PCoIP Connection Manager Session Settings.

Connecting Using PCoIP Connection Manager + Auto-Logon

To connect using the PCoIP Connection Manager and Auto-Logon connection type:

  1. From the Options > Configuration > Session menu on the Tera2 PCoIP Zero Client’s OSD, select the PCoIP Connection Manager + Auto-Logon connection type.
  2. In the Server URI field, enter the IP address of your PCoIP Connection Manager for Amazon WorkSpaces, and click OK.
  3. Enter the user name, password, and domain name for the user to be automatically logged in.
  4. Click the Connect button.

Advanced settings

For details about advanced settings, see OSD: PCoIP Connection Manager + Auto-Logon Session Settings.