Citrix - How to configure the Single Client method for published application launch with Single Sign-On?
search cancel

Citrix - How to configure the Single Client method for published application launch with Single Sign-On?


Article ID: 50881


Updated On:


CA Single Sign On Secure Proxy Server (SiteMinder) CA Single Sign On SOA Security Manager (SiteMinder) CA Single Sign-On



The technical details in this document cover a specific scenario for launching published Citrix Applications via the SSO client installed on a Citrix Presentation Server. This is one of two known supported configurations (Single Client/Dual Client) tested by QA for SSO. There are other known configurations that can be implemented for your solution. We recommend to employ CA Technical Services for any out-of-the-norm solutions you are looking for.


  • Note well: If you are interested in the dual-client method of operation for achieving Single Sign-On in the Citrix Presentation Server environment, please consult with the following pages in the CA SSO Implementation Guide; Chapter 15: Implementing Citrix Application Migration

    • This solution will use Windows Authentication as a pass-through for a users' windows credentials from a common desktop into the Citrix Program Neighborhood.

    • This document assumes you have sufficient knowledge of creating Application Resources on an SSO server and applying Access Control Rules to them.

    • This document assumes that you have prior knowledge of working with both the Citrix Presentation Server and ICA client pieces.

Installation of SSO client on Citrix Presentation Server 4.5 for single client mode of operation.

    1. Run setup of SSO client on the Citrix Server (We are using 8.1 CR20 client release but this applies to all versions of SSO.)

      <Please see attached file for image>

      Figure 1

    2. Accept the license agreement

    3. Install to default location (normally M: Drive on Citrix)

      <Please see attached file for image>

      Figure 2

    4. Select the typical installation option

    5. Specify your SSO server list in the ServerSet configuration page.

      <Please see attached file for image>

      Figure 3

    6. Enter in the hostnames of the Windows Authentication Agent servers. In this example they are installed on the same hosts as SSO server is.

      <Please see attached file for image>

      Figure 4

    7. Enter in your trusted certificate paths or use the samples provided with SSO.

      <Please see attached file for image>

      Figure 5

    8. Click Install to continue.

    9. Do not restart machine.

    10. Click next on the MSI dialog to close it.

      <Please see attached file for image>

      Figure 6

    11. Click finish.

    12. Find and open your Auth.ini and Client.ini files present in M:\Program Files\CA\SSOINSTALLDIR\Client\cfg and make the following changes respectively.

      In Auth.ini:

        • Change ServerSetSelection=0 to ServerSetSelection=3

        • Change AutoNetworkAuth=no to AutoNetworkAuth=yes

      • In Client.ini:

      • Change SsoSignOffOnExit=no to SsoSignOffOnExit=yes

        • Save both of these files

Creation of Citrix Published Application for use with the SSO client.

  1. Open the Citrix Access Management Console and navigate to Citrix Resources > Presentation Server > "Citrix_Farm" > Applications > Common Tasks > New > Publish Application

  2. Go through each dialog box and enter the appropriate information for your new application. The example here is for "Notepad for Terminal". Location is the most important screen. You will not enter in the path to the application itself but instead enter the path to the SSO client interpreter executable and then the name of the application created in Single Sign-On application resources.

    <Please see attached file for image>

    Figure 7

  3. Once complete you may reboot your Citrix server.

    Common Desktop Configuration for use with Citrix Published Applications.

  4. Install the Citrix ICA32 Client on a common workstation. (Windows XP SP2 is being used as the example)

  5. Login to the "Citrix_Farm" Program Neighborhood with the ICA Client. (example shown is using the domain Administrator account)

    <Please see attached file for image>

    Figure 8

  6. You should automatically see the new published application in the Application Set Manager window.

    <Please see attached file for image>

    Figure 9

  7. Double-Click on the Application you want to run. You should see the SSO client status bar progress. This is taking the credentials of the user that is currently logged into the Citrix ICA Network Neighborhood. NOTE: There is no SSO client installed on this machine.

  8. You should be presented with the SSO client learn mode screen for the application. Fill in the credentials for your application to be automatically launched every time you use it.

    <Please see attached file for image>

    Figure 10

    You have now finished the single SSO client mode of operation for Citrix Presentation Server.


Release: SOASA199000-12.1-SOA Security Manager-w/ SOA Agent Addl CPUs


1558695252946000050881_sktwi1f5rjvs16myn.gif get_app
1558695251084000050881_sktwi1f5rjvs16mym.gif get_app
1558695249247000050881_sktwi1f5rjvs16myl.gif get_app
1558695247324000050881_sktwi1f5rjvs16myk.gif get_app
1558695245469000050881_sktwi1f5rjvs16myj.gif get_app
1558695243624000050881_sktwi1f5rjvs16myi.gif get_app
1558695241748000050881_sktwi1f5rjvs16myh.gif get_app
1558695239787000050881_sktwi1f5rjvs16myg.gif get_app
1558695238120000050881_sktwi1f5rjvs16myf.gif get_app
1558695236119000050881_sktwi1f5rjvs16mye.gif get_app