Product Documentation

Workspace configuration

Jan 10, 2018

This article shows administrators how to configure workspaces for subscribers, who might be using one or more services available from Citrix Cloud.

What is a workspace?

A workspace is part of a digital workspace solution that enables IT to securely deliver access to apps from any device.

This screenshot is an example of what the workspace experience looks like to your subscribers. This interface is evolving and may look different to what your subscribers are working with today. For example, it might say "StoreFront" at the top of the page instead of "Workspace".

For an overview of changes to the workspace experience, see What's new in the workspace experience and look out for Citrix Cloud: What's New blogs. 

localized image

Who can use workspaces?

The workspace experience is initially available to subscribers of:

  • XenApp Essentials Service. XenApp Essentials offers secure access to virtual Windows apps. This service includes a workspace URL, enabled by default, usually in the format: https://<yourcompanyname>.cloud.com. Follow the steps to set up XenApp Essentials, then test and share the workspace URL link with your subscribers to give them access to their apps.
  • XenDesktop Essentials Service. XenDesktop Essentials offers secure access to Windows 10 virtual desktops. This service includes a workspace URL, enabled by default, usually in the format: https://<yourcompanyname>.cloud.com. Follow the steps to set up XenDesktop Essentials, then test and share the workspace URL link with your subscribers to give them access to their desktops.
  • XenApp and XenDesktop Service. The XenApp and XenDesktop Service offers secure access to virtual apps and desktops. This service includes a workspace URL, enabled by default, usually in the format: https://<yourcompanyname>.cloud.com. Follow the steps to set up the XenApp and XenDesktop Service, then test and share the workspace URL link with your subscribers to give them access to their apps and desktops. Your subscribers can access the workspace URL without any additional configuration.

Important

Workspace Configuration and the new workspace experience are available to all XenApp Essentials Service customers, to all new (from December 2017) XenApp and XenDesktop Service customers, and to new XenDesktop Essentials customers.

Further updates will follow for existing XenApp and XenDesktop Service customers, and for existing XenDesktop Essentials Service customers. Currently, these customers continue to use StoreFront as outlined in the XenApp and XenDesktop Service StoreFront article, and in the XenDesktop Essentials article.

Change access to workspaces

In Citrix CloudWorkspace Configuration > Access, Workspace is enabled and ready to use.

localized image

Note

In XenApp Essentials, Workspace Configuration is available from the Citrix Cloud menu after you create the first catalog.

localized image


Disable workspace integration for a service

You can disable workspace integration for specific services. This does not disable the workspace URL, however it disables the data and applications for a service. 

To disable workspace integration for a service:

  1. Go to Workspace Configuration > Service Integrations.
  2. Select the ellipses (...) next to the service, and Disable.

Important

Disabling workspace integration blocks subscriber access for that service. Subscribers will no longer have access to data and applications from that service in Citrix Workspace.

localized image
localized image

Customize the workspace URL

The first part of the workspace URL is customizable. You can change the URL from, for example, https://example.cloud.com, to https://new-example.cloud.com.

  • From the Citrix Cloud menu, go to Workspace Configuration > Access, and select the Change link next to the workspace URL.

Guidance for new URLs:

  • The customizable part of the URL ("new-example") must be between 6 and 63 characters long.
  • Can include letters, numbers, or hyphens (-).
  • Cannot include Unicode characters.
  • When you rename a URL, the old URL is immediately removed and no longer available.
  • If you change the workspace URL, your subscribers cannot access their workspaces until the new URL is active (takes about 10 minutes). You’ll also need to tell them what the new URL is and manually update all local Citrix Receiver apps to use the new URL.

External Connectivity 

Provide secure access for your remote subscribers by adding NetScaler Gateways to the resource locations.

You can add NetScaler Gateways from Workspace Configuration > Access > External Connectivity or from Citrix Cloud > Resource Locations.

localized image

Note

The External Connectivity part of the Workspace Configuration > Access page is not available in XenApp Essentials. The XenApp Essentials Service uses the NetScaler Gateway Service, which requires no additional configuration.

Change authentication to workspaces

As an administrator, you can choose to have your subscribers (end users) authenticate to their workspaces using either Active Directory or Azure Active Directory.

Federated authentication to workspaces using Azure Active Directory is currently for tech preview only.

pdf

Enable federated authentication using Azure Active Directory

Step-by-step deployment guide for federated authentication to workspaces using Azure Active Directory.

Warning

  • This tech preview is for use in a test environment only. Windows Server 2016 VDAs are not recommended at this time.
  • If you are using Azure Active Directory (AAD), do not make the registry change described in CTX225819. Making this change may cause session launch failures for AAD users.
  • Switching authentication modes can take up to 5 minutes and will cause an outage to your subscribers during that time.
  • Subscribers will see the message "Please log on again, or close your browser to protect your account". This happens because the subscriber may still be signed into Azure AD.

Customize the appearance of workspaces

To customize how subscribers see their workspace, change the settings in Workspace Configuration > Customize and Save.

localized image

Changes to the workspace appearance take effect right away. Local Citrix Receiver apps may take around five minutes for the updated user interface to display.

Changes to the sign-in logo do not impact users who authenticate to their workspace using Azure Active Directory. For more information on how to add company branding to your sign-in page in Azure AD, see the Microsoft documentation.

The Sign-in logo appears to the left of the workspace sign-in form. You can replace the Citrix logo with your own. 

localized image

The maximum dimensions of your logo should be 350 x 120 px and a maximum size of 2 MB. Supported formats are JPEG, JPG, or PNG. The colors and branding of the rest of the sign-in page are not affected.

localized image

The After Sign-in logo appears at the top left of the workspace. The maximum dimensions of your logo should be 340 x 120 px and a maximum size of 2 MB. Supported formats are JPEG, JPG, or PNG. The colors and branding of sign-in page are not affected.

The Content Branding colors change the header background, text and icon color, and the highlight color ("Link color") in the workspace.

localized image

The Link color is used in link text, the expanded card, and the icon color of the settings in card layout.

Expanded card

localized image

Settings icon color

localized image

What's new in the workspace experience

This section gives an overview of the end user workspace experience, including recent changes.

localized image

Browser support

Access workspace using Internet Explorer 11, Edge, Chrome, or Firefox.

Citrix Receiver support

Access workspace using Citrix Receiver for any of the desktop platforms (Windows, Mac, and Linux). Citrix Receiver for HTML5 and Citrix Receiver for Chrome are also supported.

Citrix Receiver for iOS and Citrix Receiver for Android will work, however they do not include the new workspace experience or support Azure Active Directory authentication (Tech Preview).

Card layout

Apps and desktops in your workspace are represented in a "card" layout. An expanding panel shows more details and actions.

Settings

Access settings from the drop-down menu. The menu contains the user name. The user name comes from the Active Directory display name. If the display name is left blank (we do not recommend this), the domain and account name display.

Select Settings for more options. You can toggle the settings page between a list and card layout.

localized image
  • Activate Citrix Receiver. Downloads a file that adds this workspace to your local Citrix Receiver app.
  • Change Citrix Receiver. Opens a page that checks for a local Citrix Receiver app. Not available in Internet Explorer 11.
  • Download Citrix Receiver. Downloads a Citrix Receiver installation file to your machine. Run the file to install a local Citrix Receiver app for Windows or Mac.

Working with local (native) Citrix Receiver apps

New customers. If you are new to a service in Citrix Cloud and new to the workspace experience, you’ll get the latest version of the user interface as soon as it is available. You can access the workspace experience from your browser, or from a local Citrix Receiver app.

Existing customers. If you have been working with an earlier version of the workspace experience, it can take around five minutes for the updated user interface to display in local Citrix Receiver apps. You may temporarily see an older version of user interface.

Changes to your service. If you have changed your service subscription, you may need to manually refresh the local Receiver app. In Citrix Receiver for Windows:

  1. From the Windows system tray, right-click the Citrix Receiver icon, and click Advanced Preferences > Reset Receiver.
  2. Open Citrix Receiver for Windows, then select Accounts > Add, and enter the workspace address, for example, https://example.cloud.com.
localized image

As an alternative to step 2., you can  use a browser to enter the workspace URL and sign in. Then, activate Citrix Receiver from Settings > Account Settings >Activate Citrix Receiver. Activating Citrix Receiver downloads a .CR file that adds the workspace to your local Citrix Receiver app.