Get started

Setup

Citrix Workspace app for iOS supports the configuration of Web Interface for your Citrix Virtual Apps deployment. There are two types of Web Interface sites: XenApp Services sites and Citrix Virtual Apps and Desktops Sites. Web Interface sites enable client devices to connect to the server farm. Authentication between Citrix Workspace app for iOS and a Web Interface site can be handled using various solutions, including Citrix Secure Web Gateway.

Also, you can configure StoreFront to provide authentication and resource delivery services for Citrix Workspace app for iOS, enabling you to create centralized enterprise stores to deliver desktops, applications, and other resources to users.

For more information about configuring connections, including videos, blogs, and a support forum, see http://community.citrix.com.

Before your users access applications hosted in your Citrix Virtual Apps and Desktops deployment, configure the following components in your deployment as described here.

  • When publishing applications on your farms or sites, consider the following options to enhance the experience for users accessing those applications through StoreFront stores.

    • Ensure that you include meaningful descriptions for published applications because these descriptions are visible to users in Citrix Workspace app for iOS.
    • You can emphasize published applications for your mobile device users by listing the applications in the Featured list of Citrix Workspace app for iOS. To populate this list on Citrix Workspace app for iOS, edit the properties of applications published on your servers and append the KEYWORDS:Featured string to the value of the Application description field.
    • To enable the screen-to-fit mode that adjusts the application to the screen size of mobile devices, edit the properties of applications published on your servers and append the KEYWORDS:mobile string to value of the Application description field. This keyword also activates the auto-scroll feature for the application.
    • To automatically subscribe all users of a store to an application, append the KEYWORDS:Auto string to the description you provide when you publish the application in Citrix Virtual Apps. When users log on to the store, the application is automatically provisioned without users needing to manually subscribe to the application.
  • If the Web Interface of your Citrix Virtual Apps and Desktops deployment does not have a Web site or Citrix Virtual Apps and Desktops Site, create one. The name of the site and how you create it depends on the version of Web Interface you have installed. For instructions on how to create one of these sites, see the “Creating Sites” topic for your version of Web Interface.

Manual setup

In general, when Citrix Workspace app for iOS connects to Citrix Gateway, Citrix Workspace app for iOS attempts to locate a XenApp Services site or Citrix Virtual Apps Web site after authenticating. If no site is detected, Citrix Workspace app for iOS displays an error. To avoid this situation, you can configure an account manually so Citrix Workspace app for iOS can connect to Citrix Gateway.

  1. Tap the Accounts icon in the upper right corner and then in the Accounts screen, tap the Plus Sign (+). The New Account screen appears.
  2. In the lower left corner of the screen, tap the icon to the left of Options and tap Manual setup. Additional fields appear on the screen.
  3. In the Address field, type the secure URL of the site or Citrix Gateway to which you want to connect (for example, agee.mycompany.com).
  4. Select one of the following connection options. The remaining fields on the screen change, depending on your selection.
    • Web Interface - Select for Citrix Workspace app for iOS to display a Citrix Virtual Apps Web site similar to a Web browser. This is also known as Web View.
    • XenApp Services - Select for Citrix Workspace app for iOS to locate a specific XenApp Services site for which authentication through Citrix Gateway is not configured. In the additional options that appear on this screen, provide site logon credentials.
      • <StoreFront FQDN>: If there are multiple stores, a list will be presented and the user can choose the store to add.
      • <StoreFront FQDN>/citrix/<Store Name>: This will add the StoreFront store <Store Name>.
      • <StoreFront FQDN>/citrix/PnAgent/config.xml: This will add the default legacy PNAgent store.
      • <StoreFront FQDN>/citrix/<Store Name>/PnAgent/config.xml: This will add the legacy PNAgent store associated with <Store Name>.
    • Citrix Gateway - Select for Citrix Workspace app for iOS to connect to a XenApp Services site through a specific Citrix Gateway. In the additional options on this screen, select the server edition and its logon credentials, including whether it requires a security token for authentication.
  5. For certificate security, use the setting in the Ignore certificate warnings field to determine whether you want to connect to the server even if it has an invalid, self-signed, or expired certificate. The default setting is OFF. Important: If you do enable this option, make sure you are connecting to the correct server. Citrix strongly recommends that all servers have a valid certificate to protect user devices from online security attacks. A secure server uses an SSL certificate issued from a certificate authority. Citrix does not support self-signed certificates and does not recommend by-passing the certificate security.
  6. Tap Save.
  7. Type your user name and password (or token, if you selected two-factor authentication), and then tap Log On. The Citrix Workspace app for iOS screen appears, in which you can access your desktops and add and open your apps.

StoreFront

Important:

  • When using StoreFront, Citrix Workspace app for iOS supports Citrix Access Gateway Enterprise Edition versions from 9.3, and Citrix Gateway versions through 12.
  • Citrix Workspace app for iOS supports only XenApp Services sites on Web Interface.
  • Citrix Workspace app for iOS supports launching sessions from Workspace for Web, as long as the web browser works with Workspace for Web. If launches do not occur, configure your account through Citrix Workspace app for iOS directly. Users must manually open the ICA file using the browser Open in Workspace function. For the limitations of this deployment, see the StoreFront documentation.

With StoreFront, the stores you create consist of services that provide authentication and resource delivery infrastructure for Citrix Workspace app for iOS. Create stores that enumerate and aggregate desktops and applications from Citrix Virtual Apps and Desktops sites and Citrix Virtual Apps farms, making these resources available to users.

  1. Install and configure StoreFront. For details, see the StoreFront product documentation. For administrators who need more control, Citrix provides a template you can use to create a download site for Citrix Workspace app for iOS.
  2. Configure stores for StoreFront as you would for other Citrix Virtual Apps and Desktops applications. No special configuration is needed for mobile devices. For details, see User Access Options in the StoreFront section of Product Documentation. For mobile devices, use either of these methods:
    • Provisioning files. You can provide users with provisioning files (.cr) containing connection details for their stores. After installation, users open the file on the device to configure Citrix Workspace app for iOS automatically. By default, Workspace for Web sites offer users a provisioning file for the single store for which the site is configured. Alternatively, you can use the Citrix StoreFront management console to generate provisioning files for single or multiple stores that you can manually distribute to your users.
    • Manual configuration. You can directly inform users of the Citrix Gateway or store URLs needed to access their desktops and applications. For connections through Citrix Gateway, users also need to know the product edition and required authentication method. After installation, users type these details into Citrix Workspace app for iOS, which attempts to verify the connection and, if successful, prompts users to log on.
    • Automatic configuration. Tap Add Account on the Welcome screen and type the URL of the StoreFront server in the address field. The configuration of the account happens automatically while the account is added.

To configure Citrix Gateway

If you have users who connect from outside the internal network (for example, users who connect from the internet of from remote locations), configure authentication through Citrix Gateway.

  • When using StoreFront, Citrix Workspace app for iOS supports Citrix Access Gateway Enterprise Edition versions from 9.3, and Citrix Gateway versions through 12.

To configure Citrix Workspace app for iOS to access apps

  1. If you want to configure Citrix Workspace app for iOS to automatically access apps when creating an account, in the Address field, type the matching URL of your store, such as storefront.organization.com.
  2. Select the Use Smartcard option when you are using a smart card to authenticate.
  3. For manual configuration (accessible by tapping Options>Manual Setup), continue by completing the remaining fields and select the Citrix Gateway authentication method, such as enabling the security token, selecting the type of authentication, and saving the settings.

Note:

Logons to the store are valid for about one hour. After that time, users must log on again to refresh or launch other applications.

Web Interface

To configure the Web Interface site, users with iPhone and iPad devices can launch applications through your Web Interface site and the built-in Safari browser on the mobile device. Configure the Web Interface site the same as you would for other Citrix Virtual Apps applications. If no XenApp Services site is configured for the mobile device, Citrix Workspace app for iOS automatically uses your Web Interface site. No special configuration is needed for mobile devices.

Web Interface 5.x is supported by the built-in Safari browser.

To launch applications on the iOS device

On the mobile device, users can log on to the Web Interface site using their normal logon and password.

Automatic provision for mobile devices

In StoreFront, use the Export Multi-Store Provisioning File and Export Provisioning File tasks to generate files containing connection details for stores, including any Citrix Gateway deployments and beacons configured for the stores. Make these files available to users to enable them to configure Citrix Workspace app for iOS automatically with details of the stores. Users can also obtain Citrix Workspace app for iOS provisioning files from Workspace for Web sites.

Important:

In multiple server deployments, use only one server at a time to make changes to the configuration of the server group. Ensure that the Citrix StoreFront management console is not running on any of the other servers in the deployment. Once complete, propagate your configuration changes to the server group so that the other servers in the deployment are updated.

  1. On the Windows Start screen or Apps screen, locate and click the Citrix StoreFront tile. Select the Stores node in the left pane of the Citrix StoreFront management console.
  2. To generate a provisioning file containing details for multiple stores, in the Actions pane, click Export Multi-Store Provisioning File and select the stores to include in the file.
  3. Click Export and Save the provisioning file with a .cr extension to a suitable location on your network.

User access information

You must provide users with the Citrix Workspace app for iOS account information they need to access their hosted their applications, desktops, and data. You can provide this information by:

  • Configuring email-based account discovery
  • Providing users with a provisioning file
  • Providing users with account information to enter manually

Configure email-based account discovery

You can configure Citrix Workspace app for iOS to use email-based account discovery. When configured, users enter their email address rather than a server URL during initial Citrix Workspace app for iOS installation and configuration. Citrix Workspace app for iOS determines the Access Gateway or StoreFront server, or AppController virtual appliance associated with the email address based on Domain Name System (DNS) Service (SRV) records and then prompts the user to log on to access their hosted applications, desktops, and data.

Note:

Email-based account discovery is not supported if Citrix Workspace app for iOS is connecting to a Web Interface deployment.

Provide users with a provisioning file

You can use StoreFront to create provisioning files containing connection details for accounts. You make these files available to your users to enable them to configure Citrix Workspace app for iOS automatically. After installing Citrix Workspace app for iOS, users simply open the .cr file on the device to configure Citrix Workspace app for iOS. If you configure Workspace for Web sites, users can also obtain Citrix Workspace app for iOS provisioning files from those sites.

For more information, see the StoreFront documentation.

Provide users with account information to enter manually

If providing users with account details to enter manually, ensure you distribute the following information to enable them to connect to their hosted and desktops successfully:

  • The StoreFront URL or XenApp Services site hosting resources; for example: servername.company.com.

  • For access using Citrix Gateway, provide the Citrix Gateway address and required authentication method.

When a user enters the details for a new account, Citrix Workspace app for iOS attempts to verify the connection. If successful, Citrix Workspace app for iOS prompts the user to log on to the account.