Ericom



Ericom Connect® 7 Client
Ericom PowerTerm WebConnect Client 7
Ericom Blaze Client 7
Ericom AccessToGo 7


Download pdfDownload pdf

User Manual

Notice: this manual covers Ericom Mobile apps for Apple iOS and Android. The release schedules on the respective app stores are managed by the vendor, thus the Ericom Mobile apps may not update simultaneously on all stores on the same date. If your Ericom mobile app does not match the version above, please be patient as it will be updated in the upcoming days

Table of Contents

LEGAL NOTICE

ABOUT THIS DOCUMENT

OVERVIEW
    Architecture
    Blaze RDP Compression and Acceleration
    What's New

GETTING STARTED
    Pre-requisites
    Device Requirements
    Downloading AccessToGo
    Connection List
    Connection Options
    Online Help
    Creating a New Connection
    Connection Parameters
    Disconnecting and Exiting
    Configuring Ericom Secure Gateway

USING ACCESSTOGO
    AccessToGo Toolbar
    Using the Finger as Mouse
    Using the On-screen Mouse
    Using the On-screen Trackpad Mouse
    Using the Keyboard Toolbar
    Using the On-screen Keyboard
    Using the On-screen Function Keyboard
    Using Remote Session PPI Resolution
    Copy and Paste of text between device and host
    Using Physical Keyboards and Mice
    Using the Tablet Function Bar
    Using the Extended Menu
    Using the Tablet Split Keyboard
    Auto-display Keyboard and Position on Text

CONNECT TO DESKTOP
    Auto Rotate Resize

CONNECT TO AN APPLICATION

CONFIGURE REMOTE ACCESS

CONFIGURE MANAGED BROKER ACCESS
    Using the User Interface
    Support for Two-Factor Authentication

CONFIGURE VMWARE VIEW ACCESS

SETTINGS
    Appearance
    Language and keyboard
    Connection
    About
    Gestures
    Remote Desktop Session PPI (Pixel's Per Inch)

URL SCHEMES
    Creating .rdp or .blaze files
    Add MIME Type to Web Server
    Configuration File Parameter Definitions
    Launching Applications using AccessToGo URL Scheme
    Passing Encrypted Passwords using XTEA

TECHNICAL SUPPORT
    Verify Connectivity
    URL Scheme is not working
    Disable RDP SSL
    SSL Certificate Error with PTWC and ESG
    Requesting Technical Support

ABOUT ERICOM


LEGAL NOTICE

This manual is subject to the following conditions and restrictions:

  • This Manual provides documentation for Ericom Connect Client, Ericom (PowerTerm) WebConnect Client, Ericom Blaze Client and Ericom AccessToGo.
  • The proprietary information belonging to Ericom® Software is supplied solely for the purpose of assisting explicitly and property authorized users of Ericom AccessToGo.
  • No part of its contents may be used for any purpose, disclosed to any person or firm, or reproduced by any means, electronic and mechanical, without the prior expressed written permission of Ericom® Software.
  • The text and graphics are for the purpose of illustration and reference only. The specifications on which they are based are subject to change without notice.
  • The software described in this document is furnished under a license agreement. The software may be used or copied only in accordance with the terms of that agreement.
  • Information in this document is subject to change without notice. Corporate and individual names, and data used in examples herein are fictitious unless otherwise noted.

AccessToGoUG20150329

Copyright © 1999-2015 Ericom® Software.
Ericom, PowerTerm and Ericom Connect are registered trademarks, and Ericom AccessToGo is a trademark of Ericom® Software. Other company brands, products and service names, are trademarks or registered trademarks of their respective holders.

» BACK to Table of Contents

ABOUT THIS DOCUMENT

This manual provides instructions on how to use Ericom Connect Client, Ericom WebConnect Client, Ericom Blaze Client and Ericom AccessToGo to connect to virtual desktops and Terminal Servers from compatible phone and tablet devices browsers.

This manual includes the following information:

  • Overview of Ericom AccessToGo
  • Usage instructions
  • Known issues and limitations
This manual assumes that the reader has knowledge of the following:
  • Enabling RDP on Windows operating systems
  • Firewall configuration
  • Familiarity of the device where AccessToGo will be installed
Important terminology used in this document:
  • RDP - Remote Desktop Protocol. A remote display protocol developed by Microsoft. RDP is a standard component of Microsoft Windows.
  • RDP Host - a system that can be remotely accessed using Microsoft RDP, such as a Terminal Server (RDS Session Host) or Windows workstation with remote access enabled.
  • SSL - Secure Sockets Layer is a cryptographic protocol that provides communications security over the Internet.
For more information about this product and other Ericom products, please visit the Ericom website (www.ericom.com).

» BACK to Table of Contents

OVERVIEW

Ericom AccessToGo provides end-users with remote access to Windows desktops and applications from any compatible phone or tablet device.

Ericom Connect and WebConnect Client uses the same engine and interface as AccessToGo, but is dedicated for managed broker access only. Please refer to sections related to AccessToGo usage and Connect/WebConnect configuration.

Ericom Blaze Client uses the same engine and interface as AccessToGo, but is dedicated for Blaze access only. Please refer to sections related to AccessToGo usage and Blaze configuration. Blaze 2.x and 3.x versions are not cross compatible. Ericom Blaze Client requires Access Server 3.x.

Email mobile@ericom.com with any questions or requests for technical support.

Architecture

Ericom AccessToGo is comprised of three installable components:
      a.   Downloadable client
      b.   (Optional) Access Server for RDP Acceleration and Compression
      c.   (Optional) Secure Gateway Service that provides highly secure and encrypted remote access to desktops and applications

This diagram illustrates how the components of AccessToGo interact with each other. The orange arrows indicate remote connections and the blue arrows represent internal connections.

Components of AccessToGo

  • The end-user launches the Ericom AccessToGo client on a compatible mobile phone or tablet. Connection parameters are entered into the AccessToGo application.
  • AccessToGo initiates a RDP or Blaze connection to the desired RDP host.
       a. If the optional Ericom Secure Gateway is used, the AccessToGo session will connect through it over a secure port (default 443).
  • If Blaze is enabled, the Access Server will accept the AccessToGo session and accelerate RDP (over port 8080 by default). If Blaze is not enabled, the AccessToGo session will be directly accepted by RDP (over port 3389 by default).

This diagram illustrates how the components of AccessToGo interact with each other and the Ericom Connect or PowerTerm WebConnect broker. The orange arrows indicate remote connections and the blue arrows represent internal connections.

AccessToGo

This diagram illustrates how the components of AccessToGo interact with each other and the VMware View broker. The orange arrows indicate remote connections and the blue arrows represent internal connections.

AccessToGo

» BACK to Table of Contents

Blaze RDP Compression and Acceleration

Ericom AccessToGo contains Ericom's Blaze technology for RDP compression and acceleration. This technology enhances remote desktop performance over slow network connections. The accelerated sessions are also useful for viewing content that contain highly graphical images and animations.

There are three main features in this technology:

  • Image compression
  • Packet shaping
  • Whole frame rendering

Image compression compresses images before transmitting them to the client for rendering. The level of compression is dependent on the acceleration/quality level selected by the user (a default value can also be configured by the administrator).

Packet shaping optimizes the network messages to improve network utilization and performance.

Whole frame rendering means that the display is updated as a whole rather than in blocks, as performed by standard RDP. This is especially noticeable when watching video or over slow network connections. Coupled with the other optimization features, it results in a smoother display that more closely resembles the functionality on local desktops.

» BACK to Table of Contents

What's New

  • Added Ericom Connect option
  • Added Paste function to the password and PIN entry fields
  • Smashed some bugs

» BACK to Table of Contents

GETTING STARTED


Pre-requisites

The session communication between the end-user and the remote desktops utilizes RDP, so RDP access must be enabled on the RDP hosts.

  • Verify with your network administrator that RDP connections are allowed to the target RDP host(s).
  • Enable RDP on the target PC. Go to Control Panel | System | Remote settings. Under Remote Desktop select "Allow connections from computers running any ...". NLA is not currently supported so do not select the third setting.
  • Click on the Select Users button to add users that will be allowed to connect remotely. Click OK.
  • Verify that the system's Windows firewall allows incoming RDP connections (the default port is 3389). If Ericom protocols are being used, 8080 needs to be opened as well

Configure the network or router firewall to allow incoming connections to the target PC over the RDP port.

» BACK to Table of Contents

Device Requirements

AccessToGo requires at least 512 MB of RAM installed on the device. The following devices are supported:

  • Apple iOS 5 or higher
  • Android OS 2.1 or higher
  • Blackberry Playbook 2.0.1 or higher
  • Blackberry 10 and above

» BACK to Table of Contents

Downloading AccessToGo

Go to the device's marketplace (i.e. Google Play Store, Apple Appstore) and search for Ericom and select the desired app:

  • AccessToGo
  • Ericom Connect Client
  • Ericom WebConnect Client
  • Ericom Blaze Client.

Once the application is downloaded an icon will appear in the device's application list. Tap the icon to launch the application.
AccessToGo (includes RDP, Blaze, and PowerTerm WebConnect access):

Downloading AccessToGo

Ericom Connect Client (includes Ericom Connect access only):

Downloading AccessToGo

Ericom WebConnect Client (includes PowerTerm WebConnect access only):

Downloading AccessToGo

Ericom Blaze Client (includes Ericom Blaze accelerated RDP access only):

Downloading AccessToGo

» BACK to Table of Contents

Connection List

When Ericom AccessToGo is launched, the Connection List is displayed. This is a list of all saved connections. Two sample connections to the Ericom Demo server located in the USA are included. One connection uses standard RDP, while the other uses Ericom's Blaze RDP acceleration to connect to the RDP host. If a new connection is created with the same name as an existing connection, it will automatically be renamed to avoid confusion.

Connection List

Press, tap, or click on the desired connection to launch it.

» BACK to Table of Contents

Connection Options

Existing connections can be copied, edited, or deleted.

To apply an action to a connection press and hold on the desired connection until the action menu appears.

Connection Options


Button Function Description
Connect Connect using the configured parameters
Edit Edit the existing connection parameters
Copy Copy the existing connection so it can be
Delete Delete this connection

» BACK to Table of Contents

Online Help

To view the online AccessToGo manual - tap the Online Help button.

Online Help
» BACK to Table of Contents

Creating a New Connection

At the AccessToGo connection list screen, click on the New Connection button.

Several options will be available for selection. Choose the desired connection type and enter the connection parameters.

Connection Type Description
RDP (Free) Connect to a RDP host with standard RDP. Make sure to enable RDP on the host
Blaze Requires Blaze Server 2.5 or Access Server 3.x to be installed on the RDP host. Accelerates RDP screens showing graphics (movies, photos, etc.) over slow remote connections. For more information visit www.EricomBlaze.com. Blaze 2.x and 3.x versions are not cross compatible. Ericom Blaze Client 3.x requires Access Server 3.x.
Ericom Connect Connects to Ericom's Connect broker to access virtual applications and desktops
PowerTerm WebConnect (VDI / TS) Connects to PowerTerm WebConnect broker to access virtual applications and desktops
VMware View (RDP) Connect to a desktop managed by a VMware View broker. RDP connections are free
VMware View (Blaze) Connect to a desktop managed by a VMware View broker using Blaze. Blaze connections will require Access Server on the virtual desktop
» BACK to Table of Contents

Connection Parameters

Connection Parameters
Connection Name A customizable label for the connection being configured
Computer The address of the target system that has RDP enabled.
User name The user's credentials to login to the RDP host. Can optionally contain domain specification, e.g. domain\user. When using Ericom Secure Gateway this field is mandatory. Otherwise this field is optional - if not specified then user will be prompted for credentials by the RDP host.
Password Corresponding password for the user name.
User Ericom Secure Gateway When enabled, AccessToGo will connect to the remote desktop using the specified Ericom Secure Gateway.
Ericom Secure Gateway Configure and select the desired Ericom Secure Gateway for remote connectivity.
Blaze - RDP acceleration When checked, enables lossy image compression for the session. Degree of quality loss / acceleration can be specified using the drop down list. Requires Access Server on the RDP host and activated license(s).
Acceleration Quality Controls the degree of acceleration that is enabled in the session. Faster acceleration results in lower quality.
Desktop Size Size of the remote RDP desktop for the session. If the remote desktop is larger than the mobile device window, the user will have to scroll or zoom to see desktop areas that are not displayed. When Automatic is enabled, if the device is a tablet (screen size is 6 inches or larger), it will open the session in Full Screen. For non-tablet devices, the remote desktop size will be automatically determined by the application.
IMPORTANT: Refer to the Advanced Feature section on how to use the PPI feature to display the perfect resolution on your device!
Start Program on connection Enables application launch mode. On Terminal Server sessions, only the application will appear and the remote desktop will not be accessible. On workstation systems accepting RDP, the selected application will launch, but can be minimized to reveal the desktop.
Path/File Name Specify the path to the application to be launched
Start Folder Specify the start folder for the application
Color Depth Sets the color depth of the session
Play sound on device Enables audio for sessions where audio is available on the RDP host. To verify if audio is available, connect to the RDP host using mstsc.exe and verify that audio can be heard on a standard PC.

Connections with limited bandwidth or high latency may not redirect audio perfectly. There may be distortion or choppiness.
Connection Speed Set the Connection Speed of the network
Desktop Options Configure RDP related desktop experience settings
Console Session Check this setting to enable console session. This is equivalent to using the /console or /admin flag when using mstsc.exe.
» BACK to Table of Contents

Disconnecting and Exiting

To disconnect an active session or exit the AccessToGo application on Android devices, press the device's Back button. A prompt will appear to confirm the disconnection or exit.

» BACK to Table of Contents

Configuring Ericom Secure Gateway

The Secure Gateway is used for encrypted remote access from the AccessToGo application to the internal RDP hosts. The Secure Gateway is available for the following mode: RDP, Blaze, VMware View in RDP mode, and VMware View in Blaze mode. Ericom Connect and PowerTerm WebConnect connections will use the Secure Gateway as its address (when the ESG is configured to act as a reverse proxy for the PowerTerm WebConnect service).

The Secure Gateway is enabled in a Connection's Options.

Configuring Ericom Secure Gateway

  1. Check Use Ericom Secure Gateway to enable the use of a Secure Gateway.
  2. Then tap Ericom Secure Gateway to select configured Secure Gateways.
  3. To add a new Secure Gateway, tap the New Gateway button and complete the required fields:
    Field Description
    Server The address of the Secure Gateway server
    Connection Port The port value that the Secure Gateway service is listening on
    User Name User name to authenticate into the Secure Gateway
    Password Corresponding password for the Secure Gateway
  4. Tap on the desired Secure Gateway to enable it.
NOTE: The default gateway port is 443. If the Secure Gateway is listening on a custom port, make sure to enter the correct value for the Connection Port parameter.

» BACK to Table of Contents

USING ACCESSTOGO

AccessToGo Toolbar

The AccessToGo toolbar is located at the bottom of the desktop or application once a session is established. To display the AccessToGo toolbar on Android based devices, press the Menu button on the device (usually the leftmost button).

To display the Toolbar upon connection, go to Settings and check Always

AccessToGo toolbar

Button Function Description
Scroll wheel mode When this mode is enabled, sliding the finger up and down the screen will mimic the movements of a scroll wheel
On-screen mouse Displays/Hides the on-screen mouse
On-screen touchpad mouse Display/Hides the on screen trackpad touchpad mouse
Remote Mouse Mode
(Enabled by default)
When enabled, all mouse movements and gestures will be applied within the remote session. For example, the gesture to zoom out of the current display will be disabled. To scroll the local screen, tap and hold for half a second and then move the finger.
Display On-screen keyboard Displays the on-screen keyboard.
Zoom In/Out Zoom In/Out of the screen
Hide Toolbar When the Toolbar is displayed, this button will hide it
Show Toolbar (Apple iOS only) When the Toolbar is hidden, this button will display it. On Android devices, press the Menu button to display the Toolbar
Extended Menu Displays additional functions, such as Configure Gestures

» BACK to Table of Contents

Using the Finger as Mouse

The user may use his or her finger to initiate mouse movements. The user taps an area on the screen, a click indicator will appear. The indicator will consist of a dot where the mouse click is executed upon in the session and a circle to represent the finger tap.

To execute a right-click, tap and hold the screen. Wait for the right click indicator to complete a circle and then release to complete the right click.

» BACK to Table of Contents

Using the On-screen Mouse

The on-screen mouse provides convenient functions to interact with the remote session. Regardless of whether the mouse is enabled, the user may also use his or her finger to interact with the session.

Operation Finger gesture
Left-click single tap
Right-click single tap

Full on-screen mouse icon:

When the On-screen mouse is enabled, the following functions are available:
Icon Function Description
Mouse/Left click Tap this icon to execute a left click. Press and hold this icon to drag the mouse pointer around the screen.
Pointer This icon represents the mouse pointer
Right click Tap this icon to right-click on the area where the mouse pointer is over
Scroll wheel mode When this mode is enabled, sliding the finger up and down the screen will mimic the movements of a scroll wheel
Remote Mouse Mode When enabled, all mouse movements and gestures will be applied within the remote session. For example, the gesture to zoom out of the current display will be disabled. To scroll the local screen, tap and hold for half a second and then move the finger.
Display On-screen keyboard Displays the on-screen keyboard
Close Mouse Hides the mouse

» BACK to Table of Contents

Using the On-screen Touchpad Mouse

The Touchpad mouse allows the user to use the screen of the device as a touchpad mouse. When the Touchpad is enabled, the user can tap on any area on the screen to obtain control of the mouse. Simply slide the finger to move the mouse around the screen. The finger does not have to be directly over the mouse. Tap and hold the mouse to initiate a right-click. While Touchpad is enabled, the user can still perform zoom in and zoom out gestures on the screen.

Touchpad Mouse button:
Using the On-screen Trackpad Mouse

» BACK to Table of Contents

Using the Keyboard Toolbar

AccessToGo includes enhanced keyboard functionality. When the on-screen keyboard is enabled, the following operations are available.

Using the On-screen Keyboard

Icon Description
Displays advanced keyboard keys: function keys, arrow keys, and key combinations (i.e. CTRL+ALT+DEL). Pressing this key will also toggle the advanced keys with the OS virtual keyboard.
Simulates the ESC key
Simulates the TAB key
Simulates the pressing of the CTRL key - when activated the green light will turn bright
Simulates the pressing of the ALT key - when activated the green light will turn bright
Simulates the pressing of the Windows key (displays the Windows Start menu)
Displays the on-screen PC keyboard. The device's virtual keyboard is the default. The on-screen PC keyboard provides an enhanced user experience. Pressing the button again while the keyboard is displayed will toggle between default OS keyboard and the AccessToGo keyboard.
Pressing this button will toggle through the languages that are enabled. To enable languages, go to Settings | Select Preferred Keyboard Languages
Close the on-screen keyboard
» BACK to Table of Contents

Using the On-screen Keyboard

Pressing the On-Screen keyboard button will reveal the AccessToGo keyboard. The AccessToGo keyboard provides additional keys and features for an improved user experience when typing in Windows-based applications.

On-Screen keyboard button:

AccessToGo Keyboard:
On-screen PC keyboard

» BACK to Table of Contents

Using the On-screen Function Keyboard

Pressing the On-Screen Function keyboard button will reveal the AccessToGo function keyboard. The Function keyboard provides function keys, common Windows key combinations, and scrolling keys for an improved user experience when typing in Windows-based applications and desktops.

On-Screen function button:

AccessToGo Function Keyboard:

» BACK to Table of Contents

Using Remote Session PPI Resolution

With the increasing diversity of end-user devices and user preferences, it is ever more important to allow the user to work with the most comfortable resolution when launching a remote desktop or application.

By default, the PPI for devices with screen sizes less than 7 inches is 190; and the PPI for screen sizes 7 inches or greater is 170. These settings will provide the optimal usage based on the device's screen size, however the user may also select a custom PPI value. Refer to the Advanced Feature section on how to use the PPI feature to display the perfect resolution on your device!

Copy and Paste of text between device and host

AccessToGo includes text-only clipboard support for Copy and Paste functionality. The clipboard is enabled by default and may be disabled by going to Setting and unchecking Enable Clipboard.

When this feature is enabled, copy and paste functionality is supported in both directions: copy/paste from local device to the AccessToGo session and vice versa.

Here is an example of a copy/paste operation from the remote AccessToGo session to the local device browser.

Perform a Copy operation from the remote AccessToGo session:

Once the desired text is copied to the clipboard, switch to the local application and initiate a Paste operation. The selected text will be copied over from the clipboard.


NOTE: On certain devices, switching to the local application may end the AccessToGo session.

» BACK to Table of Contents

Using Physical Keyboards and Mice

Physical input/output devices are handled by the operating system, and not directly by the applications. AccessToGo will accept input from physical keyboards and mice based on what is received from the operating system when such devices are used. Certain keys on a physical keyboard, such as the Right Shift, may not work properly because the operating system does not support it (and it will not work properly with any application on the device).

Activating a Physical keyboard

Physical keyboards, such as a Bluetooth keyboard, may or may not work as soon as the session is established (varies based on the device). On devices where the keyboard does not work upon session connect, enable the AccessToGo Device Keyboard (tap button below) and then try typing.

NOTE: When using a physical mouse, the right mouse button is only supported on devices running Android 4.0 and higher.

Bluetooth keyboards that have been tested on Android and Apple iOS devices:
HP Touchpad Bluetooth Keyboard, Microsoft Bluetooth Keyboard 6000

» BACK to Table of Contents

Using the Tablet Function Bar

The Tablet Function bar displays popular keys (ESC, TAB, CTRL, ALT, Windows) and functions (such as display On-screen mouse) that may be used during any active session. The bar may be disabled by unchecking Enable Top Bar under Settings.

AccessToGo will detect whether the device is a tablet upon startup. A device where AccessToGo has more than 5.7 inches of display space will be classified as a tablet, and the Tablet Function bar will appear (by default) at the top of any active session.

Tap and hold any button to view a brief description of its purpose.

Button Function Description
Esc Escape key
Tab Tab key
Ctrl Control key
Alt Alt key
Windows key Executes the Windows key
Device keyboard Displays/Hides the device keyboard for text input
Function keyboard Displays/Hides the function keyboard to perform special keys and combinations
PC keyboard Displays/Hides the PC keyboard for text input. This feature resembles a traditional PC keyboard layout
Scroll wheel mode When this mode is enabled, sliding the finger up and down the screen will mimic the movements of a scroll wheel
On screen mouse Displays/Hides the on-screen mouse
On-screen Touchpad mouse Display/Hides the on screen Touchpad mouse
Remote Mouse Mode When enabled, all mouse movements and gestures will be applied within the remote session. For example, the gesture to zoom out of the current display will be disabled. To scroll the local screen, tap and hold for half a second and then move the finger.
Zoom In/Out Zoom In/Out of the screen
Extended Menu Displays a menu with additional AccessToGo functions
» BACK to Table of Contents

Using the Extended Menu

The Extended menu is accessible from the AccessToGo Toolbar and Tablet bar and provides additional functions described below.

Button Function Description
Current Keyboard Locale Displays the current keyboard locale language
Configure Gestures Configure the desired functions for supported gestures
Remote PPI Configure the PPI setting during an active session. Remote Session will automatically resize.
On-screen Help Displays the on-screen help dialog
Exit Session Exits the current session and returns to the previous menu
» BACK to Table of Contents

Using the Tablet Split Keyboard

AccessToGo includes the ability to use a Spilt PC Keyboard. This PC keyboard mode is designed to make the virtual keyboard more ergonomic so that the end-user can type with the thumb while holding the device.

» BACK to Table of Contents

Disabling Split Keyboard

To disable the Split PC Keyboard and switch to full PC Keyboard mode, tap this button in the lower right:

Auto-display Keyboard and Position on Text

AccessToGo will automatically display the built-in keyboard and position the display so the text field is visible for optimal usability. The keyboard will automatically close when the text field is no longer in focus. Certain applications are written in a manner where AccessToGo cannot detect the text field, as a result this feature will not work with such applications.

NOTE: This operation is not applicable when Split-keyboard is enabled on tablets

Disabling Auto-Keyboard and Position

Go to the Settings menu and Language and Keyboard and uncheck Automatically show keyboard.

CONNECT TO DESKTOP

Once the connection parameters are configured, save the connection if desired. Press the Connect button to start the connection.

After a successful login, the user is connected to the desktop; the content of the virtual desktop is displayed within the browser window. AccessToGo intercepts mouse button and keyboard events, and transmits them to the RDP host. If the device is recognized as a tablet, the AccessToGo toolbar will be displayed at the top of the application as shown here:


To disconnect from an active session, press the device's Back button. A prompt will be displayed to confirm the disconnect request. A Disconnect command may also be initiated from the Windows Start menu.


To enable Blaze RDP acceleration access, the optional Access Server must be installed on the RDP host. The following RDP hosts are supported: Windows XP, Vista, 7, 2003, 2008, 2008 R2, 2012, and 2012R2.

NOTE: In order to use Blaze mode, Access Server 3.x is required on the RDP host. If an older version of Blaze Server is installed, the connection will fall-back to the RDP protocol.
» BACK to Table of Contents

Auto Rotate Resize

During a Full Screen session, AccessToGo can automatically resize the screen to support a new resolution when the device is reoriented (auto-rotate feature is enabled). To enable this feature, go to the application Settings and check the setting In full Screen, resize on orientation change.

» BACK to Table of Contents

CONNECT TO AN APPLICATION

To launch just an application rather than the full desktop configure the Programs parameters in the Connection parameters.

Programs Parameters
Start program on connection Configures the connection to launch just the specified program on the RDP host upon connection
Path and File Name The path of the application to be launched from the RDP host. Make sure the application is properly installed
Start Folder The path to the working folder for the application

Once an application is enabled and configured under Start program on connection, only the application will appear once the session is connected. The launched application will cover the entire session area and the remote desktop will not be displayed.

Remote applications only work when connecting to Terminal Servers. This functionality is not available on Windows workstation operating systems (i.e. Windows 7).

On Windows 2008 Terminal Servers (and 2008 R2RDS) RemoteApps must be enabled on the server. Applications that will be launched must be added to the RemoteApps Programs allowed list.

Follow instructions for adding applications to RemoteApp:

Select desired applications that may be launched using TS/RDS:

After the desired application(s) have been added, test the connection using AccessToGo before distributing to end-users.

» BACK to Table of Contents

CONFIGURE REMOTE ACCESS

AccessToGo may be used as a remote access solution to any Windows based PC that supports RDP. Certain Windows operating systems do not support incoming RDP sessions (i.e. Windows 7 Home). Here are the steps required to implement a basic remote access connection:

  1. Verify with your network administrator that remote RDP connections are allowed to the target PC. Some organizations prohibit RDP connections to their PC's.
  2. Install AccessToGo on the end-user device (i.e. iPad).
  3. Enable RDP on the target PC. Go to Control Panel | System | Remote settings. Under Remote Desktop select "Allow connections from computers running any ...". NLA is not currently supported so do not select the third setting.
  4. Click on the Select Users button to add users that will be allowed to connect remotely. Click OK.
  5. Verify that the PC's Windows firewall allows incoming RDP connections (the default port is 3389)
  6. Configure the network or router firewall to allow incoming connections to the target PC over the RDP port.
  7. Configure AccessToGo to connect to the address of the target PC. If the connection is being made remotely, point to the external address of the firewall/router that has been configured with the rule to port forward incoming connections to the target PC.
  8. If the optional Access Server is used for RDP acceleration, note that the Blaze port is 8080.
  9. If the optional Ericom Secure Gateway is used for remote connections, port 443 (rather than the RDP port) will be required on the network firewall. The Secure Gateway port value can be changed, see the documentation on the Ericom Secure Gateway for more information.

CONFIGURE MANAGED BROKER ACCESS

AccessToGo may be used to connect to an application or desktop hosted through an Ericom Connect or PowerTerm WebConnect connection broker. Here are the steps required to implement a remote access connection to a remote session:

  1. Verify with your network administrator that remote RDP connections are allowed to the target RDP host(s).
  2. Enable RDP on the target PC. Go to Control Panel | System | Remote settings. Under Remote Desktop select “Allow connections from computers running any ...”. NLA is not currently supported so do not select the third setting.
  3. Click on the Select Users button to add users that will be allowed to connect remotely. Click OK.
  4. Verify that the system's Windows firewall allows incoming RDP and/or Blaze connections (the default port is 3389 and 8080 respectively.)
  5. Configure the network or router firewall to allow incoming connections to the target PC over the RDP port.
  6. Install AccessToGo on the end-user device (i.e. iPad).
  7. Configure AccessToGo to connect to the address of the Ericom Connect or WebConnect server. Explicitly specify the port if it is not 8011 for Connect or 4000 for WebConnect (i.e. 192.168.1.1:443).
  8. If the optional Ericom Secure Gateway is used for remote connections, specify its external address and port 443 (rather than the PowerTerm WebConnect port). The Secure Gateway will act as a reverse proxy to the PowerTerm WebConnect server. The Secure Gateway port value can be changed (default is 443). See the Ericom Secure Gateway documentation for more information.
  9. Configure the optional username and password that will be used to login to Ericom Connect or PowerTerm WebConnect.
NOTE: To use the PowerTerm WebConnect "SmartInternal" setting, this environment variable must be set on the server:
SmartInternalIsGateway set to 1
» BACK to Table of Contents

Using the User Interface

The Ericom Connect and WebConnect Connection interface will be displayed upon successful authentication into the brokered environment.

There are four tab options that the user can select:

Function Description
Log out
Displays all assigned published applications and desktops
Displays all assigned published applications and desktops marked as Favorite by the user
Displays all assigned published applications and desktops that were recently launched.
Access the Settings to configure AccessToGo features such as the Automatic PPI resize.
Enter a keyword in this field that will be used with the Search function. Tap the Search button to begin the search.
Search for published connections that contact the keyword entered in the Search field. For example, entering "pa" will return results such as Paint, Wordpad, and Space Game.
If a keyword is entered in the Search field, this button will clear it.

Tap and hold a connection to display the option menu:

Function Description
Launch the connection
Add connection to Favorites

To search for a connection, enter a keyword into the Search field and tap the magnifying glass icon. A list of connections will be displayed based on the search.

» BACK to Table of Contents

Support for Two-Factor Authentication

When connecting to an Ericom Connect or PowerTerm WebConnect 6.0 environment where two-factor authentication is enabled, a dialog will appear after the initial password login to request the second factor.

The user is able to enter a second authentication factor by typing it in or using the “Paste” function. Tap and hold the text field to see the Paste function, or press the Paste button to paste a string that has been copied to the clipboard.

If the second authentication is successful, the resource list will be displayed. If the authentication fails, the user may retry the authentication again.

CONFIGURE VMWARE VIEW ACCESS

AccessToGo may be used to connect to a virtual desktop hosted through a VMware View VDI connection broker. Here are the steps required to implement a basic remote access connection to a virtual desktop:

  1. Verify with your network administrator that remote RDP connections are allowed to the target virtual desktops.
  2. Install AccessToGo on the end-user device (i.e. iPad).
  3. Enable RDP on the target PC. Go to Control Panel | System | Remote settings. Under Remote Desktop select "Allow connections from computers running any ...". NLA is not currently supported so do not select the third setting.
  4. Click on the Select Users button to add users that will be allowed to connect remotely. Click OK.
  5. Verify that the PC's Windows firewall allows incoming RDP and/or Blaze connections (the default port is 3389 and 8080 respectively.)
  6. Configure the network or router firewall to allow incoming connections to the target PC over the RDP port.
  7. Configure AccessToGo to connect to the address of the VMware View broker server. If the connection is being made remotely, point to the external address of the firewall/router that has been configured with the rule to port forward incoming connections to the target PC.    a. If the optional Ericom Secure Gateway is used for remote connections, port 443 (rather than the RDP port) will be required on the network firewall. The Secure Gateway port value can be changed, see the documentation on the Ericom Secure Gateway for more information.
  8. Configure the optional username and password that will be used to login to VMware View.
NOTE: Steps 3, 4, and 5 should be implemented on the primary virtual desktop image (gold image/template) so that they will automatically be propagated to virtual desktops that are clone from the primary one.
» BACK to Table of Contents

SETTINGS

Click on the Settings button at the Connection List screen to configure AccessToGo application settings.

The available settings are organized into the following categories: Appearance, Gestures, Language and Keyboard, Connection, and About.

Appearance 
Always Show Bottom bar Displays the Toolbar at the bottom of the screen upon connection.
In Full Screen Resize on Orientation change If the device supports auto-rotate when the device is reoriented, AccessToGo will reconnect to the session to support the new resolution after the orientation change. This will only occur when the connection is in Full Screen mode.
Enable click animation When checked, an animation will appear when the user performs a single click or double-click (long single tap) operation within an AccessToGo session.
Remote Desktop PPI See section on PPI
Remote Mouse mode in Full Screen Enables remote mouse mode, unless the virtual keyboard is open (so the user can navigate around the screen.
Language and keyboard 
UI Language Changes the language of the AccessToGo application interface.
Default Keyboard type Select between the keyboard layout of a native device keyboard or a PC keyboard.
PC Keyboard Language Select the languages of the PC keyboard that will be used with AccessToGo.
Remote Keyboard Locale Select the region of the desired keyboard language locale. This should be set to the same language that is used on the remote RDP session.
Use keyboard scan-codes Enables keyboard scan code mode. This setting must be enabled for certain operating systems and applications. Try enabling this setting if the user is unable to type within a desktop session or application.
Automatically show keyboard Enable/disable the feature to automatically show the keyboard and position the text field when the focus is on a text field.
Connection 
Enable Copy/Paste between device/host Enable/disable the feature to allow copy/paste between device and the host session.
Reconnect Check this setting to enable session reconnect.
PowerTerm WebConnect/ VMware View Timeout If a session cannot be established to the connection broker during this timeout interval, AcccessToGo will stop trying to connect. Applies to Ericom Connect as well.
Ask before disconnect When checked, a confirmation prompt will appear when the user attempts to disconnect a session.
About 
Product Version Version number and build
What's New Displays a list of new features in this version
Device Device ID
OS Version Type and version of the operating system
Reset Settings Restore application settings back to the defaults
Debug Logging Enable upon request by Ericom Technical Support
» BACK to Table of Contents

Gestures

AccessToGo supports hand gestures to maximize user productivity. Any of the supported gestures may be configured to perform a certain operation. To modify Gestures, go to the Settings menu and tap on Configure Gestures.



Tap on the Edit button to modify the desired Gesture.



The following images display the default Gestures configuration.



Gestures may also be configured during an active session by opening the Extended menu and tapping Configure Gestures.
NOTE: When opening AccessToGo 3.5 or later for the first time, a prompt will appear to select two-finger tap as the new Zoom feature. Click Yes to use the Zoom gesture



» BACK to Table of Contents

Remote Desktop Session PPI (Pixel's Per Inch)

This Ericom patent pending feature lets the user choose the ideal PPI for their device. With the increasing diversity of end-user devices and user preferences, it is ever more important to allow the user to work with the most comfortable resolution when launching a remote application or desktop.

By default, the Recommended PPI for devices with screen sizes less than 7 inches is 190; and the PPI for screen sizes 7 inches or greater is 170. These settings will provide the optimal usage based on the device's screen size, however the user may also select a custom PPI value.

On devices with a lower resolution (e.g. 800x480) use a higher PPI to achieve more desktop space. The application or desktop will have a "zoomed-out" effect.

On devices with higher resolutions (e.g. 2560x1560) use a lower PPI to make the graphics and text more visible. The application or desktop will have a "zoomed-in" effect.

The default setting is 190 PPI.

Sample Screenshots

Test Device: Samsung 3S
OS: Android 4.1.2
Native PPI: 304

When using the Native PPI, the remote desktop session will make use of the entire available resolution of the device. As seen in the first screenshot, the icon images and text may be too small for certain user's preferences.

In the second image, the PPI has been set to 190 so the icons and text are larger and easier to read. The session still makes use of the entire display area of the device; however, it uses fewer pixels per inch to display a lower resolution desktop.

» BACK to Table of Contents

URL SCHEMES

URL Schemes provides an easy method to launch preconfigured application and desktop sessions using AccessToGo. AccessToGo connections may be automatically launched by using the URL scheme "ericom". When the user selects (or clicks) a .rdp or .blaze configuration file that is referenced by the "ericom" URL scheme, AccessToGo will launch the session as configured in the settings file.

NOTE: Clicking on a URL link while AccessToGo is already running will just switch to the AccessToGo application. In order to load the configuration defined in the link, AccessToGo must not be running when the URL is launched.

There are three methods to launch an AccessToGo session by using the URL scheme:

  1. Using the URL scheme to launch a .rdp or .blaze file using HTTP/HTTPS (supported on iOS and Android).
    Examples:
    <a href="ericom://http://www.test.com/myconnection.rdp">Connect to RDP Demo from WWW </a>

    <a href="ericom://https://www.test.com/myconnection.blaze">Connect to Blaze Demo from WWW </a>
  2. Using the URL scheme to launch a .rdp or .blaze file in the Ericom folder of the device (supported on Android only).
    Example:
    Connect to RDP Demo from root folder 
  3. Using the URL scheme to launch a .rdp or .blaze file from a subfolder on the device (supported on Android only).
    Example:
    <a href="ericom:///sdcard/myconnection.blaze">Connect to Blaze Demo from subfolder </a>
» BACK to Table of Contents

Creating .rdp or .blaze files

The best method to create a .rdp or .blaze file for use with AccessToGo is to download the Ericom Blaze client from the Ericom website. Test the connection using the Blaze client, and then perform a Save As operation to save the settings into a configuration file. Refer to the Connection Parameter Definitions table to manually configure any setting in the .rdp or .blaze file.

NOTE: Saved passwords are not automatically transferred when moving .rdp and .blaze files from one machine to another.

To pass passwords using the configuration file, the desired password will need to be manually entered into the file using the value "html password" or "x password". Delete any entry for "Blaze password".

» BACK to Table of Contents

Add MIME Type to Web Server

In order to use the AccessToGo URL Scheme, a MIME type must be added to a web server hosting the URL links. Here is an example of how to do this in Microsoft IIS 7:

  1. Go to the IIS Manager and launch MIME Types:



  2. Click Action | Add and enter a new MIME Type:
    1. File name extension: .rdp
    2. MIME type: text/simple
    3. Create another one for File name extension: .blaze



  3. Now use the device where AccessToGo is installed and use a browser to navigate to the web page with the configured link. Click the link and AccessToGo will automatically launch with the configured parameters:

» BACK to Table of Contents

Configuration File Parameter Definitions

NOTE: Some settings (e.g. Printing) are not used by AccessToGo

ParameterTypeDefaultDescription
alternate shellsnoneSets the shell used in the Terminal Services session. This can be used to set an alternate shell such as progman.exe or use it to set the application which the user runs on logon to the Terminal Server.
audiomodei2 (Blaze)
0 (AccessNow)
0, Bring to this computer
1, Leave at remote computer
2, Do not play
auto connecti Not used
autoreconnection enabledi1Attempts to reconnect when connection drops
bitmapcachepersistenablei Not used
connect to consolei00, connect to a virtual session
1, connect to the console session
desktopheighti600height of session desktop in pixels
desktopwidthi800width of session desktop in pixels
disable cursor settingi Not used
disable full window dragi0, Blaze
1, AccessNow
1, disables display of window contents while dragging in session
disable menu animationi01, disables menu animations in session
disable themesi01, disables use of themes in session
disable wallpaperi01, disables display of wallpaper in session
displayconnectionbari11, displays the connection bar in a full-screen session
domains Not used
full addresss IP address/name of server (and optional port value)
keyboardhooki2For applying standard Windows key combinations
0, On the local computer
1, On the remote computer
2, In fullscreen mode only
maximizeshelli Not used
password 51b Not used
porti3389Not used
redirectcomportsi Not used
redirectdrivesi Not used, see "drivestoredirect:s:" instead
redirectprintersi00, don't redirect
1, redirects client printers in session
2, redirect with blaze universal printer driver
redirectsmartcardsi01, redirects client smart cards in session (XP/.NET only). Currently in Linux version only.
screen mode idi21, window
2, Full screen
server porti Not used
session bppi32all options are supported: 8,15,16,24,32
shell working directorys Working directory if an alternate shell was specified.
smart sizingi Not used
usernames Username to be used for logon
winposstrs Not used
allow font smoothingi11, enabled font smoothing
redirectclipboardi10, disabled
1, enabled
prompt for credentialsi00, disabled
1, enabled
session sharingi10, disabled
1, enabled
connection typei61, Modem
2, LowSpeed
3, Satellite
4, HighSpeed
5, WAN
6, LAN
dirstoredirects "Desktop", "My Docs", (and "Media" on non-win)
use multimoni00, current
1, use multi monitors
2, span multi monitors
#, use monitor #
remoteapplicationmodei1Not used
allow desktop compositioni2Not used
compressioni Not used
disable cursor settingi Not used
bitmapcachepersistenablei Not used
redirectposdevicesi Not used
authentication leveli Not used
negotiate security layeri Not used
gatewayhostnameisNot used
gatewayusagemethodi Not used
gatewaycredentialssourcei Not used
gatewayprofileusagemethodi Not used
promptcredentialoncei Not used
audiocapturemodei Not used
videoplaybackmodei Not used
use redirection server namei Not used

Ericom Parameters
blaze versions Version number
blaze accelerationi 0, disabled
1, enabled
blaze image qualityi40Blaze quality (100 – lossless, 95 – best, 75 – high,20 – fair,40 good)
Blaze passwords Encrypted password
html passwords No encryption
wc passwords decrypt using CryptUnprotectData
x passwords decrypt using XTEA
use ericom secure gatewayi00, disabled
1, enabled
use secure gateway credsi00, disabled
1, enabled
ask secure gateway credsi00, disabled
1, enabled
secure gateway hostnames Ericom Secure Gateway address
Sample value: Test.abc.com
timezone standard names for Mac and Linux
addins to uses list of add-in component names to be used
ui languages Not Used
» BACK to Table of Contents

Launching Applications using AccessToGo URL Scheme

When using the URL Scheme to launch just an application from a Terminal Server/Remote Desktop Server, add the desired application(s) to the RemoteApp Program list.

The following image shows how to add MSPaint to the allowed application list:

In the .rdp or .blaze file, verify that the following parameters are configured:

  • remoteapplicationmode:i:1
  • alternate shell:s:mspaint
  • (optional) shell working directory:s:

» BACK to Table of Contents

Passing Encrypted Passwords using XTEA

Refer to the Blaze manual on using encrypted passwords.

TECHNICAL SUPPORT

Verify Connectivity

When experiencing connectivity problems - check that all firewalls between the AccessToGo application and RDP host are configured to allow the appropriate ports:
RDP: 3389
Blaze: 8080 (3399 in pre 3.x versions)
Secure Gateway: 443

To verify the connectivity of an address and port, download a Telnet app to the device and try connecting to the target address and port. If a Connection Refused message is returned, then the connection is not available.

URL Scheme is not working

If the URL Scheme launches AccessToGo, but does not connect using the configured parameters, check the following:

  • AccessToGo was not already running
  • The address of the RDP host configure in the RDP file (make sure that a DNS name can be correctly resolved on the device).

Recreate the settings file (.rdp or .blaze) using the Ericom Blaze client (free download). This ensures that all parameters are defined correctly. Any typos will invalidate the file.

Disable RDP SSL

Access Server requires access to native RDP to be enabled on the RDP host. For this reason, do not change the RDP Security Layer to SSL. Leave the setting on RDP Security Layer and using the built-in AccessNow SSL encryption, or Secure Gateway, to add SSL encryption.

SSL Certificate Error with PTWC and ESG

When using AccessToGo with the Ericom Secure Gateway (ESG) for Ericom Connect or PowerTerm WebConnect (PTWC) access, a trusted certificate is typically installed in the ESG. When requesting a trusted certificate from a third-party provider, a custom CSR must be sent to the provider.

To properly support AccessToGo, configure the following during the CSR creation. In the Details section of the Cryptographic Service Provider (CSR) - change the options for the Private Key. By default this is set to Microsoft Strong Cryptographic Provider (Signature). Change this to Microsoft RSA SChannel Cryptographic Provider (Encryption).

If the CSR not configured properly, there will be entries in the Event Viewer showing "The client and server cannot communicate, because they do not possess a common algorithm". When this error appears, a new certificate will have to be generated for the ESG.

Requesting Technical Support

To request technical support for AccessToGo, send the following information to mobile@ericom.com

  • Description of problem
  • Device type (i.e., Android)
  • Operating System version (i.e., Froyo 2.2)
  • Using Access Server on the RDP host?
  • Number of users/devices affected by the problem?
  • Contact Phone number
» BACK to Table of Contents

ABOUT ERICOM

Ericom® Software is a leading provider of Application Access and Virtualization Solutions. Since 1993, Ericom has been helping users access business-critical applications running on a broad range of Microsoft® Windows® Terminal Servers, Virtual Desktops, Blade PCs, legacy hosts, and other systems. Ericom provides concrete business value by helping organizations realize the benefits of their IT investments. With offices in the United States, United Kingdom, EMEA, India and China, Ericom also has an extensive network of distributors and partners throughout North America, Europe, Asia, and the Far East. Our expanding customer base is more than 30 thousand strong, with over 8 million users. For more information on our products and services, contact us at the location nearest to you. And visit our web site:http://www.ericom.com