Connectors

Connectors overview

Connectors allow employees to access files and folders stored on a connected on-premises or cloud-based resource. Users can use the web application and Citrix Files apps to view and interact with data stored in connected locations.

Connector overview

Connector type Description Supported services
ShareFile Cloud Connectors Allows Content Collaboration account users access to personal cloud-based data storage services within Citrix Files apps. Users can download, upload, move, copy, and delete data within these connected resources. These connectors require each user to authenticate with their service credentials. Users must and allow the Content Collaboration service to communicate with the permitted cloud-based service. Office 365, OneDrive for Business, SharePoint Online, Dropbox, Box, OneDrive, Google Drive
Workspace Integrations Allows Workspace users access to cloud-based data storage services under the Files menu in the left navigation bar. Users can download, upload, move, copy, and delete data within these connected resources. When opening a connector, users will see the option to authenticate if required. Once authenticated, files and folders to the target connector location will appear. Office 365, OneDrive for Business, SharePoint Online, Dropbox, Box, OneDrive, Google Drive
On-premises Connectors On-premises connectors allow users to access data locations within Network file shares or as SharePoint sites. These connectors require an additional configuration of storage zone controller(s) in a local environment. SharePoint sites, collections, libraries, Network file shares, Documentum Connector

The following connector types can be enabled once:

  • Box
  • Dropbox
  • Google Drive
  • OneDrive

Alternatively, the remaining connectors require additional configuration. The following connector types can configure multiple connections for user access:

  • On-premise connections

  • OneDrive for Business

  • SharePoint Online

Please note an Office 365 administrator must add the Citrix ShareFile Connector for Office 365 to secure Content Collaboration service access to Office 365 data.

Configuration requirements

  • Personal Cloud Connector access is enabled for a Content Collaboration account.
  • Existing on-premises storage zone has connector features enabled on the primary storage zone controller.
  • Employee users with the permission to Create and Manage Connectors have access to Connector settings in Admin Settings.
  • To share files from connectors, Connector Sharing access must be enabled for the Content Collaboration account.
  • Users with access to Connectors require Use Personal File Box permissions to share files from Connectors. Files shared from Connectors are copied to the File Box first. Recipients of the share link or email might not have immediate access to download those files until the copy is complete.
  • This feature requires Citrix managed storage zones (cloud storage).

Enable and add connectors for Content Collaboration users

Note:

Account owners can request to activate this feature on their Content Collaboration account.

For accounts that have Personal Cloud Connectors features enabled, employee users with the required permissions to manage and add connectors can open Admin settings > Connectors.

Select Enable or Add from the available connectors.

Connector dashboard

Enable and add connectors for Workspace Files users

Login to your Citrix Cloud account. Select Manage Content Collaboration, under the Manage tab, select Connectors. Click Enable or Add from the selection of available connectors.

Connector dashboard

Employee users will be able to access connectors in Workspace under the Files tab and Manage Integrations from their Account Settings.

Manage access to connectors

When enabling and adding a Connector, you grant other users access to the Connector within their Content Collaboration account or the Files menu (in Citrix Workspace). The user has access to data locations within their own accounts. Local storage resource determines access-control permissions to those cloud-based data locations.

You can choose which employee users or distribution groups have access to their cloud-based or on-premises connector in the Manage Access dialog box. Click Save or Skip when done adding users. If you select skip, only the user that creates the connector, and the Super User Group, have access to the connector.

Connector manages access

Add an on-premises SharePoint, Network File share, or Documentum Connector

Note:

An existing storage zone with Network Share or SharePoint connector features enabled is required to add on-premises connectors. For more information, see Create and manage storage zone connectors.

Employee users must have the permissions to Create and Manage Connectors and Create root-level folders to add on-premises connectors.

  1. Navigate to Admin Settings > Connectors and then select Add next to Network Share or SharePoint connector. Please note that if you are using Citrix Cloud these settings are found in Content Collaboration > Manage > Connectors.

  2. Within the Add Connector dialog box, enter the display name for the Connector. Connectors must have a unique name and not one currently used on the account.

    Add a connector shared drive Add a connector sharepoint site

  3. You can choose the on-premises zone that is local to the Network Share or SharePoint site.

    Note:

    The zone must either be in the same domain or have a trust relationship with the storage resource.

  4. Enter the path to the Network File Share connector using the UNC Path or enter the Site using the HTTP or HTTPS URL of the SharePoint site or document library.

Additional considerations include:

  • Network File shares and SharePoint document libraries will require additional (basic) authentication upon opening the connector. The credentials used to log in to the Content Collaboration account might be different than the credentials required to authenticate to the Connector.
  • If both Network File share and SharePoint connectors are configured, note the same credentials are used to authenticate with SharePoint libraries and Network File shares. If a user needs to use different credentials to access a connected library or share, the user must log out of their Content Collaboration account and close the browser session. When you open the connector, you need to authenticate using the alternate credentials.
  • Basic Authentication does not support non-ASCII characters. If using localized user names, try using NTLM or Negotiate authentication.
  • Due to a known Microsoft Issue, Network File share connectors cannot be accessed from the Microsoft Edge browser when utilizing a Citrix ADC for connector authentication.