VMware Horizon Client
for Android User Guide
04 JAN 2018
VMware Horizon Client for Android 4.7
VMware Horizon Client for Android User Guide
You can find the most up-to-date technical documentation on the VMware website at:
https://docs.vmware.com/
If you have comments about this documentation, submit your feedback to
docfeedback@vmware.com
VMware, Inc.
3401 Hillview Ave.
Palo Alto, CA 94304
www.vmware.com
Copyright © 2011–2018 VMware, Inc. All rights reserved. Copyright and trademark information.
VMware, Inc. 2
Contents
VMware Horizon Client for Android User Guide 5
1
How Do I Log In? 6
2
Connecting to Remote Desktops and Applications 7
3
Setting the Certificate Checking Mode in Horizon Client 7
Connect to a Remote Desktop or Application 8
Use Unauthenticated Access to Connect to Remote Applications 10
Switch Remote Desktops or Published Applications 12
Reconnecting to a Desktop or Published Application 12
Disconnecting From a Remote Desktop or Application 13
Log Off From a Remote Desktop 13
Using Remote Desktops and Applications 14
4
Using the Unity Touch Sidebar with a Remote Desktop 14
Using the Unity Touch Sidebar with a Remote Application 17
Horizon Client Tools on a Mobile Device 19
Gestures 21
Using Native Operating System Gestures with Touch Redirection 22
Copying and Pasting Text and Images 23
Dragging and Dropping Text and Image Files 23
Saving Documents in a Published Application 24
Share Access to Local Storage with Client Drive Redirection 24
Multitasking 25
Configure Horizon Client in Thin Client Mode 26
Using Horizon Client on a Thin Client 26
Using Android 7.0 Nougat Multi-Window Modes with Horizon Client 27
VMware, Inc.
Using Shortcuts 28
5
Manage Server Shortcuts 28
Manage Desktop and Application Shortcuts 28
Create a Remote Desktop or Application Shortcut 29
Select a Favorite Remote Desktop or Application 30
Configure the Horizon Client Default View 30
Using External Devices 32
6
Input Devices, Keyboards, and Keyboard Settings 32
Enable the Japanese 106/109 Keyboard Layout 33
3
VMware Horizon Client for Android User Guide
Screen Resolutions and Using External Displays 33
Using the Real-Time Audio-Video Feature for Microphones 35
Using Horizon Client with Samsung DeX 36
Enable the DeX Mode Auto Launch Feature 36
Troubleshooting Horizon Client 37
7
Restart a Remote Desktop 37
Reset a Remote Desktop or Remote Applications 38
Uninstall Horizon Client 39
Collecting and Sending Logging Information to VMware 39
Report Horizon Client Crash Data to VMware 41
Horizon Client Stops Responding or the Remote Desktop Freezes 42
Problem Establishing a Connection When Using a Proxy 42
Connecting to a Server in Workspace ONE Mode 43
VMware, Inc. 4
VMware Horizon Client for
Android User Guide 1
This document, VMware Horizon Client for Android User Guide, explains how to use VMware Horizon
Client™ for Android to connect to and use remote desktops and applications.
For information about the software installed on your remote desktops, contact your system administrator.
This document assumes that Horizon Client for Android is already installed and configured on your client
device. For information about installing and configuring Horizon Client for Android, see the VMware
Horizon Client for Android Installation and Setup Guide document.
®
VMware, Inc. 5
How Do I Log In? 2
Before you can log in and connect to a remote desktop or application, a system administrator at your
company must set up your user account. If your system administrator has not set up your user account,
you cannot use Horizon Client or HTML Access.
If Horizon Client prompts you for a server name and domain name, your system administrator must tell
you the server name to type and domain to select. At some companies, Horizon Client automatically
connects to the correct server and selects the correct domain for you.
If you do not know your user name or password or how to reset your password, contact the system
administrator at your company.
When you are ready to log in and get started, see Chapter 3 Connecting to Remote Desktops and
Applications.
VMware, Inc.
6
Connecting to Remote Desktops
and Applications 3
You can use Horizon Client to connect to remote desktops and applications.
This chapter includes the following topics:
n
Setting the Certificate Checking Mode in Horizon Client
n
Connect to a Remote Desktop or Application
n
Use Unauthenticated Access to Connect to Remote Applications
n
Switch Remote Desktops or Published Applications
n
Reconnecting to a Desktop or Published Application
n
Disconnecting From a Remote Desktop or Application
n
Log Off From a Remote Desktop
Setting the Certificate Checking Mode in Horizon Client
You can determine whether client connections are rejected if any or some server certificate checks fail by
configuring a setting in Horizon Client.
Certificate checking occurs for SSL connections between the server and Horizon Client. Certificate
verification includes the following checks:
n
Is the certificate intended for a purpose other than verifying the identity of the sender and encrypting
server communications? That is, is it the correct type of certificate?
n
Has the certificate expired, or is it valid only in the future? That is, is the certificate valid according to
the computer clock?
n
Does the common name on the certificate match the host name of the server that sends it? A
mismatch can occur if a load balancer redirects Horizon Client to a server that has a certificate that
does not match the host name entered in Horizon Client. Another reason a mismatch can occur is if
you enter an IP address rather than a host name in the client.
n
Is the certificate signed by an unknown or untrusted certificate authority (CA)? Self-signed certificates
are one type of untrusted CA.
To pass this check, the certificate's chain of trust must be rooted in the device's local certificate store.
VMware, Inc.
7
VMware Horizon Client for Android User Guide
To set the certificate checking mode, start Horizon Client and open Settings. In Settings, tap Security
options and tap Security mode. You have three choices:
n
Never connect to untrusted servers. If any of the certificate checks fails, the client cannot connect
to the server. An error message lists the checks that failed.
n
Warn before connecting to untrusted servers. If a certificate check fails because the server uses a
self-signed certificate, you can click Continue to ignore the warning. For self-signed certificates, the
certificate name is not required to match the server name you entered in Horizon Client.
n
Do not verify server identity certificates. This setting means that no certificate checking occurs.
If the certificate checking mode is set to Warn, you can still connect to a server that uses a self-signed
certificate.
Connect to a Remote Desktop or Application
To connect to a remote desktop or application, you must provide the name of a server and supply
credentials for your user account.
Prerequisites
Obtain the following information from your system administrator:
n
Instructions about whether to turn on a VPN (virtual private network) connection.
n
Server name to use for connecting to the server.
n
If the port is not 443, the port number to use for connecting to the server.
n
Credentials to log in, such as an Active Directory user name and password, RSA SecurID user name
and passcode, RADIUS authentication user name and passcode, or smart card personal identification
number (PIN).
n
Domain name for logging in.
n
Instructions about whether you can use fingerprint authentication.
If your system administrator sent you an email that contains a URL to use for setting up an RSA SecurID
software token on your client device, open that email and verify that you also have the activation code or
that the activation code appears at the end of the URL.
If your system administrator instructs you to configure the certificate checking mode, see Setting the
Certificate Checking Mode in Horizon Client.
Procedure
1 If a VPN connection is required, turn on the VPN.
2 On the client device, tap the Horizon app icon.
VMware, Inc. 8
VMware Horizon Client for Android User Guide
3 Connect to a server.
Option Action
Connect to a new server Enter the name of a server, enter a description (optional), and tap Connect.
Connect to an existing server Tap the server shortcut on the Servers tab.
Connections between Horizon Client and servers always use SSL. The default port for SSL
connections is 443. If the server is not configured to use the default port, use the format shown in this
example: view.company.com:1443.
4 If a smart card is required or optional, select the smart card certificate to use and enter your PIN.
If your smart card has only one certificate, that certificate is already selected. If there are many
certificates, you can scroll through the certificates.
5 If you are prompted for RSA SecurID credentials or RADIUS authentication credentials, either type
your credentials or, if you plan to use an embedded RSA SecurID token, install an embedded token.
Option Action
Existing token If you use a hardware authentication token or software authentication token on a
smart phone, enter your user name and passcode. The passcode might include
both a PIN and the generated number on the token.
Install software token Tap External Token. In the Install Software Token dialog box, paste the CT-KIP
URL or CTFString URL that your administrator sent to you in email. If the URL
contains an activation code, you do not need to enter anything in the Password
or Activation Code text box.
6 If you are prompted a second time for RSA SecurID credentials or RADIUS authentication
credentials, enter the next generated number on the token.
Do not enter your PIN, and do not enter the same generated number that you entered before. If
necessary, wait until a new number is generated.
7 If you are prompted for a user name and password, supply your Active Directory credentials.
a Type the user name and password as instructed by your system administrator.
b Select a domain.
If the Domain drop-down menu is hidden, type the user name as username@domain or
domain\username.
c (Optional) If the Enable Fingerprint check box is available, select it to use fingerprint
authentication.
The Enable Fingerprint check box is available only if biometric authentication is enabled on the
server and you have not previously authenticated with fingerprint authentication.
VMware, Inc. 9
VMware Horizon Client for Android User Guide
d (Optional) Select the Save Password check box if your administrator has enabled this feature
and if the server certificate can be fully verified.
If this is the first time you are saving a password, you are prompted to activate the device
administrator, which is required to save a password on client devices.
e Tap Connect.
If fingerprint authentication is enabled and you are logging in for the first time, your Active Directory
credentials are stored securely in the client device's database for future use.
8 If you are prompted for fingerprint authentication, place your finger on the fingerprint sensor.
If you do not want to use fingerprint authentication, tap Cancel. You can connect to the server again
and tap Use password to enter a user name and password.
9 (Optional) Tap the display protocol settings icon in the upper-right corner of the window to select the
display protocol to use.
VMware Blast provides better battery life and is the best protocol for high-end 3D and mobile device
users.
10 Tap a desktop or application to connect to it.
If you are connecting to a published desktop, and if the desktop is already set to use the Microsoft
RDP display protocol, you cannot connect immediately. You are prompted to have the system log you
off the remote operating system so that a connection can be made with the PCoIP display protocol or
the VMware Blast display protocol.
The remote desktop or application starts.
If you are using Horizon Client on a Chromebook or an Android device in DeX desktop mode, the remote
desktop or application starts in a new window instead of in the original window. The desktop and
application selector window also remains open, so that you can connect to multiple items at the same
time. When you open a new application, Horizon Client opens all previous application sessions.
Horizon Client does not open previous application sessions when you open a remote desktop session.
You can have a maximum of four sessions at the same time.
After you connect to a desktop or application for the first time, a shortcut for the desktop or application is
saved to the Recent tab. The next time you want to connect to the remote desktop or application, you can
tap the shortcut instead of tapping the server icon.
Use Unauthenticated Access to Connect to Remote
Applications
A Horizon administrator can use the Unauthenticated Access feature to create Unauthenticated Access
users and entitle those users to remote applications on a Connection Server instance. Unauthenticated
Access users can log in to the server anonymously to connect to their remote applications.
VMware, Inc. 10
VMware Horizon Client for Android User Guide
Prerequisites
Obtain the following information from your system administrator:
n
Instructions for whether to turn on a VPN (virtual private network) connection.
n
Server name to use for connecting to the server.
n
Port number to use for connecting to the server if the port is not 443.
n
An Unauthenticated Access user account to use for logging in anonymously.
If your system administrator instructs you to configure the certificate checking mode, see Setting the
Certificate Checking Mode in Horizon Client.
Procedure
1 If a VPN connection is required, turn on the VPN.
2 On the client device, open the Horizon app.
3 Tap the Settings (gear) icon in the upper-right corner of the Horizon Client window, tap
Unauthenticated access, and select the Unauthenticated access check box.
4 Connect to the server on which you have unauthenticated access to remote applications.
Option Description
Connect to a new server Enter the name of a server, enter a description (optional), and tap Connect.
Connect to an existing server Tap the server shortcut on the Servers tab.
Connections between Horizon Client and servers always use SSL. The default port for SSL
connections is 443. If the server is not configured to use the default port, use the format shown in this
example: view.company.com:1443.
5 When the login window appears, select a user account from the User account drop-down menu, if
required.
If only one user account is available, the user account is automatically selected.
6 (Optional) Select the Always use this account check box to bypass the login window the next time
you connect to the server.
To deselect this setting before you connect to the server the next time, touch and hold the server
shortcut until the context menu appears, tap Edit, tap Forget the saved Unauthenticated Access
account (name), and tap Done.
7 Tap Connect to log in to the server.
The application selection window appears.
8 Tap an application icon to start the application.
After you connect to a remote application for the first time, a shortcut for the application is saved to the
Recent tab. The next time you want to connect to the application, you can tap the shortcut instead of
tapping the server icon.
VMware, Inc. 11
VMware Horizon Client for Android User Guide
Switch Remote Desktops or Published Applications
Horizon Client supports multiple remote desktop and application sessions when you use a Chromebook
or an Android device in DeX desktop mode. You can switch these remote desktop and application
sessions.
Procedure
u
Select a remote desktop or published application from the same server or a different server.
Option Description
Choose a different desktop or
application on the same server
From the desktop and application selector window, tap the other desktop or
application. The desktop or application opens in a new window so that now you
have multiple windows open and you can switch between them.
Note If the new application is in the same farm as the current application, the
new application opens in the same window.
Choose a different desktop or
application on a different server
Tap the Back button or the Disconnect icon in the upper-right corner of the
desktop and application selector window and tap Log Out to disconnect from the
server. You can now connect to a different server and open a new desktop or
application.
Reconnecting to a Desktop or Published Application
For security purposes, a Horizon administrator can set timeouts that log you off of a server after a certain
number of hours and that lock a published application after a certain number of minutes of inactivity.
If you have not used a published application for a certain amount of time, you receive a warning prompt
30 seconds before the application is automatically locked. If you do not respond, the application is locked.
By default, the timeout occurs after 15 minutes of inactivity, but your Horizon administrator can change
the time period. For example, if you have one or more applications open and you walk away from your
computer, the application windows might no longer be open when you return an hour later. Instead you
might see a dialog box that prompts you to click OK so that the application windows appear again.
The server timeout period is typically set for a certain number of hours of inactivity. By default, you are
required to log in again if you have Horizon Client open and connected to a particular server for more
than 10 hours. This timeout applies to both published application and remote desktop connections.
On a Chromebook or an Android device in DeX desktop mode, if you navigate to the desktop and
application selector window and one or more previous application sessions are disconnected,
Horizon Client prompts you to reconnect to the previous application sessions. You can click Reconnect
to applications to open the previous application sessions, or click Not now to dismiss the message. You
can also select a check box to not show the message again.
VMware, Inc. 12
VMware Horizon Client for Android User Guide
Disconnecting From a Remote Desktop or Application
You can disconnect from a remote desktop without logging off, so that applications remain open on the
remote desktop. You can also disconnect from a remote application so that the remote application
remains open.
On a mobile device, when you are using a remote desktop or application in full-screen mode, you can
disconnect by tapping the Horizon Client Tools radial menu icon and tapping the Disconnect icon. If you
are not using full-screen mode, Disconnect is in the menu in the upper-right corner of the Horizon Client
toolbar.
On a thin client, when you are connected to a remote desktop or application, you disconnect by clicking
the Disconnect icon in the Unity Touch sidebar or in a pop-up menu, depending on your thin client
model. For more information, see Using Horizon Client on a Thin Client.
Note A Horizon administrator can configure a remote desktop to automatically log off when it is
disconnected. In that case, any open programs in the remote desktop are stopped.
Log O From a Remote Desktop
You can log off from a remote desktop operating system, even if you do not have a desktop open in
Horizon Client. If you are currently connected to and logged in to a remote desktop, you can use the
Windows Start menu to log off. After Windows logs you off, the desktop is disconnected.
Prerequisites
Obtain the credentials that you use to log in, such as your Active Directory user name and password,
RSA SecurID user name and passcode, or RADIUS authentication user name and passcode.
Procedure
1 On the Servers tab, tap the server shortcut.
2 If prompted, supply your RSA user name and passcode, your Active Directory user name and
password, or both.
3 Touch and hold the desktop name until the context menu appears.
You can perform this step from either the All or Favorites tab.
4 Tap Log Off in the context menu.
Any unsaved files that are open on the remote desktop are closed during the logoff operation.
What to do next
Tap the Back button or the Disconnect icon in the upper-right corner of the window and tap Log Out to
disconnect from the server.
VMware, Inc. 13