Apps configuration using a template

SaaS apps configuration with single sign-on on the Secure Private Access service is simplified by provisioning a template list for popular SaaS apps. The SaaS app to be configured can be selected from the list.

The template pre-fills much of the information required for configuring applications. However, the information specific to the customer must still be provided.


The following section has the steps to be performed on the Secure Private Access service for configuring and publishing an app using a template. The configuration steps to be performed on the app server is presented in the subsequent section.

Configure and publish apps using template - Secure Private Access service specific configuration

On the Secure Private Access tile, click Manage.

  1. Click Continue and then click Add an app.


    The Continue button appears only for the first time that you use the wizard. In the subsequent usages, you can directly navigate to the Applications page and then click Add an app.

  2. Select the app that you want to configure in the Choose a Template list and click Next.

  3. Enter the following details in the App Details section and click Save.

    App name – Name of the application.

    App description - A brief description of the app. This description that you enter here is displayed to your users in the workspace.

    App icon – Click Change icon to change the app icon. The icon file size must be 128x128 pixels. If you do not change the icon, the default icon is displayed.

    If you do not want to display the app icon, select Do not display application icon to users.

    URL – URL with your customer ID. The user is redirected to this URL if; - SSO fails or - Don’t use SSO option is selected.

    Customer domain name and Customer domain ID - Customer domain name and ID are used to create an app URL and other subsequent URLs in the SAML SSO page.

    For example, if you are adding a Salesforce app, your domain name is salesforceformyorg and ID is 123754, then the app URL is

    Customer domain name and Customer ID fields are specific to certain apps.

    Related Domains – The related domain is auto-populated based on the URL that you have provided. Related domain helps the service to identify the URL as part of the app and route traffic accordingly. You can add more than one related domain.

    Icon – Click Change icon to change the app icon. The icon file size must be 128x128 pixels. If you do not change the icon, the default icon is displayed.

    app details

  4. In the Enhanced Security section, select Enable enhanced security to choose the security options you would like to apply to the application and click Next.


    The Enhanced Security section is available only if you are entitled to Secure Private Access service. For details, see

    • The following enhanced security options can be enabled for the application.

      • Restrict clipboard access: Disables cut/copy/paste operations between the app and system clipboard
      • Restrict printing: Disables ability to print from within the Citrix Workspace app browser
      • Restrict downloads: Disables the user’s ability to download from within the app
      • Display watermark: Displays a watermark on the user’s screen displaying the user name and IP address of the user’s machine
    • Select Launch application always in Citrix Secure Browser service to always launch an application in the Secure Browser service regardless of other enhanced security settings.


      • The other enhanced security options are still enforced once the app is launched inside the Secure Browser.

      • If you are accessing the app from the Citrix Workspace app or from the Citrix Workspace for web, then the app is launched in the embedded browser or the native browser respectively until the policy is enforced on mobile devices.

    • Select Enforce policy on mobile device to enable the previously mentioned enhanced security options on your mobile device.


      When Enforce Policy on Mobile Device is selected along with Enable enhanced security, the user experience for the application access is negatively impacted for the desktop users and the mobile users.

  5. Enter the following SAML configuration details in the Single Sign On section and click Save.

    Assertion URL – SaaS app SAML assertion URL provided by the application vendor. The SAML assertion is sent to this URL.

    Relay State – The Relay State parameter is used to identify the specific resource the users access after they are signed in and directed to the relying party’s federation server. Relay State generates a single URL for the users. Users can click this URL to log on to the target application.

    Audience – Service provider for whom the assertion is intended.

    Name ID Format – Supported format type of user.

    Name ID – Name of the format type of user.

    SAML configuration


    When the Don’t use SSO option is selected, the user is redirected to the URL configured under the App Details section.

  6. Download the metadata file by clicking the link under SAML Metadata. Use the downloaded metadata file to configure SSO on the SaaS apps server.


    • You can copy the SSO login URL under Login URL and use this URL when configuring SSO on the SaaS apps server.
    • You can also download the certificate from the Certificate list and use the certificate when configuring SSO on the SaaS apps server.
  7. Click Next.

  8. In the App Connectivity section, define routing for the related domains of applications, if the domains must be routed externally or internally through Citrix Gateway connectors. For details, see Route tables to resolve conflicts if the related domains in both SaaS and web apps are the same.

    SPA App connectivity

  9. Click Next.

  10. In the App Subscribers section, assign users or groups to the app.

    SPA App subscribers

    • In Choose a domain, select the domain applicable to the app, and then in Choose a group or user, select the group or user to whom you are subscribing this app. You can differentiate between a user and a group based on the appearance of the alphabets U or G that against the name.

    • Click Save. The subscriber details are loaded automatically.

You can unsubscribe a subscribed user or a group by clicking the delete icon next to Status.

  1. Click Finish.

    After you click Finish, the app is added to the Applications page. You can delete, manage subscribers, or edit an app from the Applications page after you have configured the application. To do so, click the ellipsis button on an app and select the actions accordingly.

    • Manage Subscribers
    • Edit Application
    • Delete
Apps configuration using a template