Product Documentation

Create and manage StorageZone Connectors

Sep 27, 2015

StorageZone Connectors provide access to documents and folders in:

  • SharePoint sites, site collections, and document libraries
  • Network file shares

A connected SharePoint site, SharePoint library, or network file share appears in the ShareFile client interface under Folders > SharePoint or Folders > Network Shares for users with permission to view the connected resource.

StorageZone Connectors do not support document sharing or sync across devices.

To grant permissions to create StorageZone Connectors

Use the Manage Users page to set permissions that enable Administrators and employee users to create connectors, as follows:

  • Administrators: Create and manage Connectors. Enables administrators to use the ShareFile administrator console to create and manage connectors and to use a supported ShareFile client to create connectors.
  • Employee users: Create SharePoint Connectors; Create Network Share Connectors. Enables users of supported ShareFile clients to enter the URL of a SharePoint library or network file share and create a connector to it.

To create a StorageZone Connector for SharePoint

Pre-requisite

  • If you are using StorageZones for ShareFile Data, create the zone to be used for the connector.

The following steps describe how to create a StorageZone Connector from the ShareFile web interface. ShareFile users can also create a connector from supported devices by typing the URL of the SharePoint site.

  1. Log on to your ShareFile account as an administrator, click the Connectors tab, and then click Create Connector.
  2. From the Type menu, choose SharePoint.
  3. If you are using StorageZones for ShareFile Data, choose a Zone for the connector.

    The zone for a connector must either be in the same domain as the SharePoint server or must have a trust relationship with it. If you have SharePoint servers in multiple domains and cannot configure trusts between the domains, create a StorageZones Controller for each domain.

  4. For Site, specify the URL of a SharePoint root-level site, site collection, or document library, in the following forms.
    • Example connection to a SharePoint root-level site: https://sharepoint.company.com

      A connection to a root-level site gives users access to all sites (but not site collections) and document libraries under the root-level. ShareFile hides SharePoint system folders from users.

    • Example connection to a SharePoint site collection: https://sharepoint.company.com/site/SiteCollection

      A connection to a site collection gives users access to all subsites within that collection.

    • Example connection to a SharePoint 2010 document library:
      • https://mycompany.com/sharepoint/
      • https://mycompany.com/sharepoint/sales-team/Shared Documents/
      • https://mycompany.com/sharepoint/sales-team/Shared Documents/Forms/AllItems.aspx
    • Example connection to a SharePoint 2013 document library:

      The default SharePoint 2013 URL (when Minimal Download Strategy is enabled) is in the form: https://sharepoint.company.com/_layouts/15/start.aspx#/Shared%20Documents/.

  5. Type a user-friendly Name for the connector.

    The name is used to identify the SharePoint site to users. The name should be brief so it displays well on mobile devices with small screens.

  6. Click Add Connector. The View/Edit Folder Access dialog box appears.
  7. To make connectors visible to others: In View/Edit Folder Access, add users and distribution groups and then click Save Changes.

    This step determines only whether a connector is visible to users. StorageZone Connectors inherits access permissions from the SharePoint server. Read/write access is affected by the ShareFile plan: XenMobile MDM Edition and XenMobile App Edition support read access only. XenMobile Enterprise Edition and ShareFile Enterprise Edition support read/write access.

To create a StorageZone Connector for network file shares

Pre-requisite

  • If you are using StorageZones for ShareFile Data, create the zone to be used for the connector.

The following steps describe how to create a connector from the ShareFile Web interface. ShareFile users can also create a connector from supported devices by typing the path of a file share.

  1. Log on to your ShareFile account as an administrator, click the Connectors tab, and then click Create Connector.
  2. From the Type menu, choose File Share.
  3. If you are using StorageZones for ShareFile Data, choose a Zone for the connector.

    The zone for a connector must either be in the same domain as the file share or must have a trust relationship with it. If you have SharePoint servers in multiple domains and cannot configure trusts between the domains, create a StorageZones Controller for each domain.

  4. For Path, type the UNC path.

    Example with FQDN: \\fileserver.acme.com\shared

    Example that redirects to a user's home directory: \\myserver\homedirs\%username%

    Example that redirects to a user's home directory: %homedrive%

    StorageZones Controller resolves the variable %homedrive% by looking up a user's home folder path property in Active Directory.

    Important: Do not create a connector to the ShareFile Data storage location. Depending on user permissions, doing so can enable users to remove all ShareFile Data.
  5. Type a user-friendly Name for the connector.

    The name is used to identify the file share to users. The name should be brief so it displays well on mobile devices with small screens.

  6. Click Add Connector. The View/Edit Folder Access dialog box appears.
  7. To make connectors visible to others: In View/Edit Folder Access, add users and distribution groups and then click Save Changes.

    This step determines only whether a connector is visible to users. StorageZone Connectors inherits access permissions from the CIFS server. Permissions for read/write access are determined by the security settings of the network file server and are also affected by the ShareFile plan: XenMobile MDM Edition and XenMobile App Edition support read access only. XenMobile Enterprise Edition and ShareFile Enterprise Edition support read/write access.

    To change this setting later, click the Connectors tab and then click Edit/View Access for the connector you want to update.

To change a connector name

A connector name is used to identify a SharePoint site or network file share to users.

  1. Log on to your ShareFile account as an administrator and then click the Connectors tab.
  2. In the Title column, click the connector name.
  3. Type a user-friendly Name for the connector and then click Save.

To delete a connector

Deleting a connector does not remove data from SharePoint or a network file share.

  1. Log on to your ShareFile account as an administrator and then click the Connectors tab.
  2. Select the check box for the connector, click Delete, and then click OK.