Citrix Self-Service in kiosk mode (current eLux versions)

The Citrix Self-Service user interface with extensions is configured as kiosk mode. All relevant parameters are defined in the kioskmode.ini configuration file. Advanced functionality and MultiStore option are also configurable.

Defining Citrix Self-Service UI in kiosk mode

Note

The eLux package Citrix Workspace-App for Linux must be installed on the devices.
The eLux package Citrix Extensions 2.x or later and the included feature package Self-service wrapper must be installed on the devices.

For modifications on the Citrix dialog design, further feature packages must be installed on the devices:
Dialog Extension and Self-service dialog themes

This may require modifications of the image definition file on the web server via ELIAS.

  1. For the relevant devices, open Advanced device configuration > Advanced file entries and define the following entry:

    File /setup/terminal.ini
    Section Layout
    Entry KioskMode
    Value 1

    For further information, see Advanced file entries.

    This parameter enables the kiosk mode for the Citrix Self-Service user interface with extensions.

  2. Create a text file named kioskmode.ini and add the section header [Parameters]. Enter the relevant parameters:1

    Parameter Description
    ReconnectOnLogon=true|false Determines whether the Self-Service UI tries to reconnect to all sessions for a given store, immediately after logon to that store (Citrix Self-Service option)
    ReconnectOnLaunchOrRefresh=true|false Determines whether the Self-Service UI tries to reconnect to all sessions when an application is launched or the store is refreshed (Citrix Self-Service option)
    SharedUserMode=true|false If the Shared User Mode is enabled, the Self-Service UI uses one technical user account for multiple users. The user data are removed from the device when users log off or close the UI.
    (Citrix Self-Service option)

    We recommend that you do not combine SharedUserMode=false and Prelogin=true

    SelfSelection=true|false

    Is used to disable the search box and the Self-Selection panel (legacy UI)

    Disabling these UI elements prevents users from subscribing to extra applications.

    LogoffMode=0|1|2|3 0 = No automatic logoff
    1 = Logoff timer is started with logon
    2 = Logoff timer is started when the last Citrix app/desktop is closed
    3 = Logoff timer is started when the first Citrix app/desktop is opened
    LogoffDelay=<seconds> Delay in seconds after the logoff timer is started
    LogoffInfoTimeout=<seconds> Shows a message for n seconds during logoff
    ShowLastUser=true|false Shows last logged-on username in User field
    PreLogin=true|false Determines, whether on logon a dropdown list with pre-configured stores is shown (MultiStore).

    We recommend that you do not combine SharedUserMode=false and Prelogin=true

    PreLoginTitle Dialog title for the stores list (MultiStore)
    PassThroughMode=0|1 0 No pass-through logon data
    1Active Directory
    UserPassword
    Domain<1-N>=<Domain display name,domain> Each entry contains a domain.
  3. To define access to the stores, in the kioskmode.ini file, add one or more sections named [Store<1-N>] or [Environment_Store<1-N>].

    If you define stores by using [Environment_Store<N>], users can switch between the stores by clicking the Store button on the taskbar. The Stores are shown in groups (Environment) as defined.

    [Store<1-N>]

    Parameter Description
    Url=<Store URL> URL of the Citrix store
    FriendlyName=<Store display name> Display name for the Citrix store
    Default=true|false Determines whether this store is displayed as default store
    AutostartResources=<App/Desktop1;App/Desktop2;...> List of Citrix applications/desktops to be started automatically after logon

    Currently only available with PreLogin=true

    [Environment_Store<1-N>].

    Parameter Description
    Url=<Store-URL> URL of the Citrix store
    FriendlyName=<Display name> Display name for the Citrix store
    Default=true|false Determines whether this store is displayed as default store
    Environment=<Group name> Specifies the group by which the stores are grouped (freely definable character string)
    AutostartResources=<App/Desktop1;App/desktop2;...> List of Citrix applications/desktops to start automatically after logon

    Currently only available with PreLogin=true

  4. To change the design of the Citrix dialogs for all Citrix connections, in the kioskmode.ini file, add a section named [Theme]:

    Parameter Description
    ThemeName=<Themes> Name of the Citrix theme

    Default: ucselfservice

    Decorated=true|false Determines whether the windows are shown with window decoration
    ColorHover=<RGB color code> Background color for list elements on mouse hover (Citrix list selection widgets)

    Default: #e6f1f7

    ColorUnselected=<RGB color code> Background color for unselected list items(Citrix list selection widgets)

    Default: #ffffff

    ColorSelected=<RGB color code> Background color for selected list elements (Citrix list selection widgets)

    Default: #cce3f0

  5. Transfer the kioskmode.ini file to the devices to /setup/kioskmode.ini. To do so, use the Scout feature Files configured for transfer. For further information, see Files configured for transfer.

The terminal.ini entry along with the kioskmode.ini file on a device will cause the device to open the Citrix Self-Service interface in kiosk mode after start-up. All configured stores are available to the user. No other applications can be started apart from the self-service interface.

If more than one store is configured, users can switch between the stores by clicking the Store button on the taskbar while pressing shift.

Example for kioskmode.ini

[Parameters]
ReconnectOnLogon=true
ReconnectOnLaunchOrRefresh=true
SharedUserMode=true
SelfSelection=false
ShowLastUser=true
LogoffMode=3
LogoffDelay=10

[Store1]
Url=https://xd7a/int.sampletec-01.com/Citrix/Store/discovery
FriendlyName=XenApp A

[Environment_Store1]
Url=https://xd7b./int.sampletec-01.com/Citrix/Store/discovery
FriendlyName=XenApp B
Default=true
Environment=PROD

[Environment_Store2]
Url=https://xd7c./int.sampletec-01.com/Citrix/Store/discovery
FriendlyName=XenApp C
Default=false
Environment=INT

[Theme]
ThemeName=ucselfservice
Decorated=false
ColorHover=#b0b0b0
ColorUnselected=#a0a0a0
ColorSelected=#c0c0c0