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
Personal Cloud Connectors - Allow users access to cloud-based data storage services within Citrix Files apps. Users can download, upload, move, copy, and delete data within these connected resources. Office 365, OneDrive for Business, SharePoint Online, Dropbox, Box, OneDrive, Google Drive
  - 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.  
On-premises Connectors - on-premises connectors allow users to access data locations within Network file shares or as SharePoint sites. SharePoint sites, collections, libraries, Network file shares, Documentum Connector
  - These connectors require an additional configuration of storage zone controller(s) in a local environment.  

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.

Enable and add connectors

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 Settings > Admin settings > Connectors.

Connector dashboard

Manage account connectors

When enabling and adding a Connector, you grant other users access to the Connector within their Content Collaboration account. 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 personal cloud connector

Note:

This feature requires Citrix managed storage zones.

Employee users with the required permissions can navigate to Settings > Admin Settings > Connectors to view the Personal Cloud Connectors available to their account. The following personal cloud connector types can only be enabled once:

  • Box
  • Dropbox
  • Google Drive
  • OneDrive

Alternatively, the remaining connectors require additional configuration. An Office 365 administrator must add the Citrix ShareFile Connector for Office 365 to secure Content Collaboration service access to Office 365 data. The following connector types can configure multiple connections for user access:

  • OneDrive for Business
  • SharePoint Online

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 Settings > Admin Settings > Connectors and then select Add next to Network Share or SharePoint connector.

  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.
Connectors