With the Auto Client
Reconnect feature, Receiver can detect unintended disconnections of ICA
sessions and reconnect users to the affected sessions automatically. When this
feature is enabled on the server, users do not have to reconnect manually to
For application sessions, Receiver attempts to reconnect to the
session until there is a successful reconnection or the user cancels the
For desktop sessions, Receiver attempts to reconnect to the session
for a specified period of time, unless there is a successful reconnection or
the user cancels the reconnection attempts. By default, this period of time is
five minutes. To change this period of time, edit this registry on the user
HKLM\Software\Citrix\ICA Client\TransportReconnectRetryMaxTimeSeconds; DWORD;<seconds>
where <seconds> is the number of seconds
after which no more attempts are made to reconnect the session.
Enable and configure
Auto Client Reconnect with the following policy settings:
- Auto client
reconnect. Enables or disables automatic reconnection by Receiver
after a connection has been interrupted.
- Auto client reconnect
authentication. Enables or disables the requirement for user
authentication after automatic reconnection.
- Auto client reconnect
logging. Enables or disables logging of reconnection events in the
event log. Logging is disabled by default. When enabled, the server's system
log captures information about successful and failed automatic reconnection
events. Each server stores information about reconnection events in its own
system log; the site does not provide a combined log of reconnection events for
Reconnect incorporates an authentication mechanism based on encrypted user
credentials. When a user initially logs on, the server encrypts and stores the
user credentials in memory, and creates and sends a cookie containing the
encryption key to Receiver. Receiver submits the key to the server for
reconnection. The server decrypts the credentials and submits them to Windows
logon for authentication. When cookies expire, users must reauthenticate to
reconnect to sessions.
Cookies are not used
if you enable the
client reconnection authentication setting. Instead, users are
presented with a dialog box to users requesting credentials when Receiver
attempts to reconnect automatically.
protection of user credentials and sessions, use SSL encryption for all
communication between clients and the Site.
Disable Auto Client
Reconnect on Citrix Receiver for Windows by using the icaclient.adm file. For
more information, see the documentation for your Receiver for Windows version.
connections also affect Auto Client Reconnect:
- By default, Auto
Client Reconnect is enabled through policy settings at the Site level, as
described above. User reauthentication is not required. However, if a server’s
ICA TCP connection is configured to reset sessions with a broken communication
link, automatic reconnection does not occur. Auto Client Reconnect works only
if the server disconnects sessions when there is a broken or timed out
connection. In this context, the
connection refers to a server's virtual port (rather than an actual
network connection) that is used for sessions on TCP/IP networks.
- By default, the
ICA TCP connection on a server is set to disconnect sessions with broken or
timed out connections. Disconnected sessions remain intact in system memory and
are available for reconnection by Receiver.
- The connection
can be configured to
or log off sessions with broken or timed-out connections. When a session is
reset, attempting to reconnect initiates a new session; rather than restoring a
user to the same place in the application in use, the application is restarted.
- If the server is
configured to reset sessions, Auto Client Reconnect creates a new session. This
process requires users to enter their credentials to log on to the server.
reconnection can fail if Receiver or the plug-in submits incorrect
authentication information, which might occur during an attack or the server
determines that too much time has elapsed since it detected the broken