StoreFront Configuration

Install SSL certificate for accessing Session Remote Start

For ease of deployment, each Session Remote Start server is configured as a special type of Gateway with StoreFront. As such, StoreFront must be able to contact Session Remote Start at the specified Gateway callback URL (https://<Session Remote Start FQDN>/SessionRemoteStart/CitrixAuthService/AuthService.asmx).

Add Session Remote Start as a Gateway

  1. Click Manage Citrix Gateways in the Stores panel on the right.

    Manage Citrix Geteways

  2. Add a new gateway.

    Add a New Gateway

  3. Set Display name, set Citrix Gateway URL with https://<Session Remote Start FQDN>/SessionRemoteStart/, and change Usage or role to Authentication only.

    Set citrix gateway

  4. Set Callback URL with https://<Session Remote Start FQDN>/SessionRemoteStart.

    Storefront authentication settings

Create a New Store for Session Remote Start

Although an existing Store can be used, it is recommended that a new Store should be created specifically for Session Remote Start usage.

Manage Authentication Methods

  1. On the new Store, find the Manage Authentication Methods in the Store configuration panel on the right.
  2. Ensure the Pass-through from Citrix Gateway is checked.

    Pass through from citrix gateway

  3. Expand settings, Click Configure Delegated Authentication.

    Configure delegated authentication

  4. Enable the Full delegate credential validation to Citrix Gateway.

    Full delegate credential validation to citrix gateway

Configure Remote Access Settings

  1. Click Configure Remote Access Settings in the Store configuration panel on the right.
  2. Enable the Remote Access.
  3. Select the Gateway configured above.

    Configure remote accesss settings

Configure Session Remote Start plugin

This plugin should be applied to the store that the end user is using, not the Session Remote Start store.

  1. Backup Existing plugins: On the StoreFront server, go to the following website dir, 'C:\inetpub\wwwroot\Citrix\%StoreName%\', open 'bin' folder. Backup the existing StoreCustomization_Input.dll, StoreCustomization_Enumeration.dll to a specific directory. e.g. 'C:\stf_original_plugin'.

  2. Paste the Citrix team provided three DLLs to the bin folder - StoreCustomization_Input.dll, StoreCustomization_Enumeration.dll, SrsStoreFrontPluginCommon.dll.

  3. Set up system environment:
    • Open System (Control Panel).
    • Click the Advanced system settings link.
    • Click Environment Variables.
    • Add New… in the System variables section, In the New System Variable window, add below environment variables. Click OK. Close all remaining windows by clicking OK.
    Variable Name Required/Optional Description Example
    srs_server_urls Required Session Remote Start server URL https://pmd-server.rl011.local/SessionRemoteStart
    stf_original_plugins_path Optional Original plugins directory C:\stf_original_plugin
    launching_suffix Optional Resource title suffix while preparing by Session Remote Start. If not configured, ‘ - Preparing’ by default.
    • Preparing
  4. Grant access to stf_original_plugins_path. Similar to Session Remote Start file permission configuration, grant access to StoreFront application pool identity.
  5. Restart IIS service - iisreset.
StoreFront Configuration