Bulletproof Guide to Citrix Receiver Start Menu Integration

In this post I’m going to show you how to setup Citrix Receiver Start Menu Integration and troubleshoot in case it doesn’t work.

First off, to get this working you NEED to use HTTPS. Check out my previous posts Securing Citrix X1 StoreFront with Powershell and Citrix StoreFront Complete Automation.

I’m using Citrix Receiver 4.3 and Citrix Storefront 3.0. Let’s install Citrix Receiver using the following Powershell code:

This will install Citrix Receiver with Single Sign On and copy the icon to the Startup folder.

Please be aware that if you install 4.3 Technical Preview you need to do some manual clicks. This will go away when it’s official.

Bulletproof Guide to Citrix Receiver Start Menu Integration 06

One of the most common mistakes is forgetting to add your Storefront URL to the Trusted Zone List. You’ll find the GPO in Administrative Templates – Windows Components – Internet Explorer – Internet Control Panel – Security Page.

Bulletproof Guide to Citrix Receiver Start Menu Integration 04

Let’s create a Group Policy for Citrix Single Sign On with Storefront Configuration. You need to import the ADM templates.

I’m keeping the ADM templates with the binaries. You’ll find these under C:\Program Files (x86)\Citrix\ICA Client\Configuration.

Bulletproof Guide to Citrix Receiver Start Menu Integration 05

Bulletproof Guide to Citrix Receiver Start Menu Integration 09

Navigate to Administrative Templates – Classic Administrative Templates – Citrix Components – Citrix Receiver – User Authentication – Local username and password. Set the following:

Bulletproof Guide to Citrix Receiver Start Menu Integration 10

Navigate to Administrative Templates – Classic Administrative Templates – Citrix Components – Citrix Receiver – Storefront – Storefront Accounts List. Enable the policy and define your Store.

Bulletproof Guide to Citrix Receiver Start Menu Integration 11

Navigate to Administrative Templates – Classic Administrative Templates – Citrix Components – Citrix Receiver – Self Service and enable the first 3 policies.

I prefer to enable SelfServiceMode and Add/Remove Account at this stage. This makes it much easier for troubleshooting.

Bulletproof Guide to Citrix Receiver Start Menu Integration 12

Bulletproof Guide to Citrix Receiver Start Menu Integration 13

This is how I link the Internet Explorer and Citrix Receiver SSON policies.

Bulletproof Guide to Citrix Receiver Start Menu Integration 14

Now restart the computer and make sure it belongs to the OU where you have linked the GPO.

Head over to Store and configure Domain Pass-through.

Bulletproof Guide to Citrix Receiver Start Menu Integration 02

Bulletproof Guide to Citrix Receiver Start Menu Integration 03

To add the application shortcut to the Start Menu you need to set KEYWORDS:auto.

Bulletproof Guide to Citrix Receiver Start Menu Integration 15

Logon to your test computer. If everything works it should look like this.

Bulletproof Guide to Citrix Receiver Start Menu Integration 16

When you disable SelfServiceMode you’ll get all applications populated via the Citrix Receiver Start Menu Integration.

Bulletproof Guide to Citrix Receiver Start Menu Integration 22

Troubleshooting

Single Sign On

The first step is to verify that the Single Sign On process ssonsvr.exe is running in Task Manager.

Bulletproof Guide to Citrix Receiver Start Menu Integration 17

Now open your browser and verify that you get Single Sign On to StoreWeb. Please note that this works with both HTTP and HTTPS.

Bulletproof Guide to Citrix Receiver Start Menu Integration 18

Add Account

The Store has not been configured in GPO.

Bulletproof Guide to Citrix Receiver Start Menu Integration 07

Your apps are not available at this time

Bulletproof Guide to Citrix Receiver Start Menu Integration 19

Your Store is not configured to use HTTPS.

Bulletproof Guide to Citrix Receiver Start Menu Integration 21

You can verify this by clicking Accounts. If you have the Store configured with HTTPS in GPO, but the account show HTTP, you have certification problems. Verify that HTTPS works with StoreWeb.

Bulletproof Guide to Citrix Receiver Start Menu Integration 20

Cannot start App – Please contact your helpdesk

Citrix Receiver Cannot Start App

You’ll find various error messages in the event log of your Storefront server.

Citrix Receiver Cannot Start App 02

You need to enable TrustedXML on your delivery controllers, check CTX140045 for more info.

 

Citrix Receiver Start Menu Integration not working

Make sure to go through the steps above. If you can manually add icons in Citrix Receiver / StoreWeb and they show up in the Start Menu there´s something wrong with your application keywords.

Resources

9 Responses to Bulletproof Guide to Citrix Receiver Start Menu Integration

  1. When you state to import the templates, are you suggesting to import them into sysvol, and the client machine?

    I have gotten the web portion to work, I go to the storefront page, i get prompted to use the current user credentials.. say yes. Apps are enumerated etc.

    Receiver is another story, I have tried to configure the store via studio and that seems to give it the proper store but I get an error that the apps are not available, try again later.

    If I add the store it works!

    I have set the receiver policies and copied to my dc and desktop image in the policy definitions folders respectively. RSOP shows that the settings get applied.

    If i remove the store defined in studio, and attempt to run receiver with just the policy set – it comes up as if no connection has been set. if i add it i am sure it will work.

    Suggestions?

    The only thing I did not do is install receiver via command line and defining the store, sso etc. Is that required for this? Going to try this next anyway but if the initial install was done manually and i specified to enable sso (4.3) doesnt that carry over to my imaged desktop?

    • Hi Juan.

      1. Import to sysvol only
      2. The first step is to verify that the Single Sign On process ssonsvr.exe is running in Task Manager. Therefore install Receiver with SSO -> ‘/silent /includeSSON’

  2. ADMX Migrator encountered a policy that does not have a supportedOn value when a import admx to policyDefinitions…

    i will have some issues with these warning?

    Thanks!

  3. Has anyone tested running Citrix receiver 4.2 ADM template with a 4.3 receiver deployment? This would be strictly for testing.

Leave a reply