Configure

When using Citrix Workspace app for Linux, the following configuration steps allow users to access their hosted applications and desktops.

Configure Citrix Virtual Apps connections using Web Interface

This topic applies only to deployments using either Citrix Virtual Apps Services on Web Interface or “legacy PNAgent” on StoreFront.

Options such as self-service, storebrowse, and pnabrowse enable users to connect to published resources (that is, published applications, and server desktops) through a server running a Citrix Virtual Apps Services site. These programs can launch connections directly or can be used to create menu items through which users can access published resources. pnabrowse can also create desktop items for this purpose.

Customizable options for all users running Citrix Virtual Apps on your network are defined in a configuration file, config.xml, which is stored on the Web Interface server. When a user starts one of these programs, it reads the configuration data from the server. After that, it updates its settings and user interface periodically, at intervals specified in the config.xml file.

Important:

The config.xml file affects all connections defined by the Citrix Virtual Apps Services site.

Publish content

A Citrix Virtual Apps Services site may also publish a file, rather than an application or desktop. This process is referred to as publishing content, and allows pnabrowse to open the published file.

There is a limitation to the type of files that are recognized by Citrix Workspace App for Linux. For the system to recognize the file type of the published content and for users to view it through Citrix Workspace app, a published application must be associated with the file type of the published file. For example, to view a published Adobe PDF file using Citrix Workspace app, an application such as Adobe PDF Viewer must be published. Unless a suitable application is published, users cannot view the published content.

Configure smart card

To configure smart card support in Citrix Workspace app for Linux, you must configure StoreFront server through the StoreFront console to allow smart card authentication. Enable the required protocol from the StoreFront console.

Note:

Smart cards are not supported with the Citrix Virtual Apps Services site for Web Interface configurations (formerly known as Program Neighborhood Agent), or with the “legacy PNAgent” site that can be provided by a StoreFront server.

Citrix Workspace app for Linux supports smart card readers that are compatible with PCSC-Lite and smart cards with PKCS#11 drivers for the appropriate Linux platform. By default, Citrix Workspace app for Linux now locates opensc-pkcs11.so in one of the standard locations. To ensure that Citrix Workspace app for Linux finds either opensc-pkcs11.so in a non-standard location or another PKCS#11 driver, store the location in a configuration file using the following steps:

  1. Locate the configuration file: $ICAROOT/config/AuthManConfig.xml
  2. Locate the line <key>PKCS11module</key> and add the driver location to the <value> element immediately following the line.

    Note:

    If you enter a file name for the driver location, Citrix Workspace app navigates to that file in the $ICAROOT/PKCS#11 directory. Alternatively, you can use an absolute path beginning with “/.”

To configure the behavior of Citrix Workspace app for Linux when a smart card is removed, update SmartCardRemovalAction in the configuration file using the following steps:

  1. Locate the configuration file: $ICAROOT/config/AuthManConfig.xml
  2. Locate the line <key>SmartCardRemovalAction</key> and add ‘noaction’ or ‘forcelogoff’ to the <value> element immediately following the line.

The default behavior is ‘noaction’. No action is taken to clear credentials stored and tokens generated with regards to the smart card on the removal on the smart card. The ‘forcelogoff’ action clears all credentials and tokens within StoreFront on the removal of the smart card.

Introducing Workspace launcher

Previously, the browser plug-in provided along with Citrix Workspace app for Linux enabled users to launch published desktops and applications was based on the Netscape Plugin Application Programming Interface (NPAPI).

Mozilla Corporation has announced that NPAPI support is deprecated as of version 52 of the Firefox browser. Other browsers, too, have deprecated support for NPAPI. Hence, Citrix has introduced Workspace launcher.

Citrix is introducing Workspace launcher (WebHelper) as a solution to deprecated NPAPI support. To enable this feature, configure StoreFront to send requests to Workspace launcher in order to detect the Citrix Workspace app installation.

For information about configuring StoreFront, see Solution – 2 > a) Administrator configuration in Knowledge Center article CTX237727.

Note:

Citrix Workspace launcher currently works only with direct connections to StoreFront. It is not supported in other cases such as connections through Citrix Gateway.