Docs@Work configuration field description (Ivanti EPMM and Ivanti Neurons for MDM)

The following table provides a description of the configuration fields for Docs@Work for iOS on Ivanti EPMM and Ivanti Neurons for MDM.

Table 1. DOCS@WORK CONFIGURATION FIELD DESCRIPTION IN Ivanti EPMM AND Ivanti Neurons for MDM

Item

Description

Name

Enter brief text that identifies this setting.

Description

Enter additional text that clarifies the purpose of this Docs@Work setting.

Client TLS

If the app is using certificate pinning, select Enable Client TLS Configuration and choose the appropriate Client TLS configuration from the dropdown.

AppTunnel Rules

Configure AppTunnel rules settings for this app. First, configure the Standalone Sentry to support AppTunnel.

 

Enable Access: The setting is available only if Access is configured in the Admin Portal in Services > Access. Otherwise, the setting is grayed out.

If the option is selected, Access trusts the HTTPS traffic via AppTunnel. Tunnel is not needed in this setup.

If Enable Split Tunneling using Tunnel is selected, HTTPS authentication traffic, which would have previously used AppTunnel to Access, goes through Tunnel instead.

 

Enable Split Tunneling using Tunnel: iOS only. Requires Mobile@Work 12.3.0 and Tunnel 4.1.0 for iOS.

Before enabling the option, ensure that Tunnel is deployed and a Tunnel VPN configuration is applied to the AppConnect app. For information about deploying Tunnel for iOS, see the Ivanti Tunnel for iOS Guide. Select the option if the AppConnect app will transition to using WKWebView or the app currently uses WKWebView and any of the following is also true:

  • AppTunnel rules are configured to tunnel app data.
  • Enable Access is selected.

Enabling the option allows the configured AppTunnel rules to be managed through Tunnel rather than through AppTunnel.

For more information about configuring Enable Split Tunneling using Tunnel for Docs@Work, see Split Tunneling using Tunnel.

Content Sites

Name

Enter a name for the content site.

URL

Enter a valid URL for the content site.

A valid URL must start with http:// or https://. Starting with Ivanti EPMM 7.5.1.0, if you are using variables, http:// or https: is not required. However, the entry in the URL field must map to a valid URL that starts with a
http://, https://, or smb://. UNC is also supported.

Examples:

$USER_CUSTOM2$

https://$USER_CUSTOM1$

 

CIFS sites

For CIFS sites, the URL must also include the CIFS port. A valid URL can start with smb:// or \\. UNC is supported. Both domain name and IP address are supported.

Examples for CIFS:

https://server.name:445/path/to/share/folder

smb://server.name:445/path/to/share/folder

\\server.name:445\path\to\share\folder

 

Variables

You can also specify variables in the URL. You can specify a single variable, or a combination of variables. LDAP or AD integration is required for using variables. See also, Docs@Work configuration field description (Ivanti EPMM and Ivanti Neurons for MDM).

Examples with variables:

https://networkdrive/users/$FIRST_NAME$

https://sharepoint.mycompany.com/personal/$FIRST_NAME$_$LAST_NAME$_company_com/

SharePoint URL's limitation with Docs@Work

The SharePoint URL is case sensitive. You need to enter the URL path with the exact case as it is configured in SharePoint Servers. This is applicable for both SharePoint Online (O365) and SharePoint OnPrem.

For example: If SharePoint URL in SharePoint Server is configured as https://<FQDN>/personal/Documents and if Ivanti EPMM or Ivanti Neurons for MDM has configured the SharePoint URL as https://<FQDN>/Personal/documents then Docs@Work will fail to load the Documents page in non Web View mode.

Admin has to configure the SharePoint URL in Ivanti EPMM or Ivanti Neurons for MDM as https://<FQDN>/personal/Documents with exact case.

 

OneDrive for Business

The credentials for OneDrive for Business are always in lower case. If the credentials in LDAP or AD are mixed case, they may not match with the credentials in OneDrive and may result in failure to access the OneDrive for Business site from Docs@Work. To ensure that device users can successfully access OneDrive for Business add #LOWER to the variable in the URL.

Example for OneDrive for Business:

https://company.sharepoint.com/personal/#LOWER($USERID$)#_company_com/documents

Domain

Select the type of content site you are configuring:

  • SharePoint

Select SharePoint for OneDrive for Business.

  • WebDAV
  • CIFS

Subdomain

Select the subdomain type for the content site:

  • SharePoint: Office 365, Corporate

Select Office 365 if you are configuring OneDrive for Business.

  • WebDAV: NetworkDrive, CloudStorage
  • CIFS: NetworkDrive
  • DFS: NetworkDrive

Authentication

Select if the device has to authenticate to the server.

Do not select if you are using Single Sign On using Kerberos Constrained Delegation.

See also “Supported authentication to content repositories” in the Docs@Work Release Notes.

Published

Select to designate the site as a Published site.

All content in a Published site is automatically downloaded and mirrored locally on the device when the device syncs. If the option is not selected, the device user must manually download the content. Documents in a Published site cannot be edited. Devices users cannot upload or create files or folders in published site.

A Web View site cannot be configured as a Published site, and a Published site cannot be configured as a Web View site.

Published sites for SharePoint are not supported at root, site, and subsite levels. Published sites are supported at document library and folder levels. Ivanti recommends that Published sites be set for publishing 50-100 documents.

Web View

Only for SharePoint domains. Only applicable to iOS devices. Does not apply to Android devices.

Select to allow device users to view and navigate SharePoint folders in browser view.

Published Site Configurations

These settings only apply to Published sites.

Update Interval (Minutes)

Specify the update interval for Published sites.

The Default setting is every 60 minutes.

Max auto download size (MB)

Specify the maximum file size for automatic download.

Files greater than this size will not be automatically downloaded. The default setting is 500 MB.

Max documents per update

Specify the maximum number of documents to update for each site.

Only the number of files specified will be updated. The default setting is 100 files.

Update Mode

Specify the method devices can use to update Published sites.

Select either Wi-Fi Only or Wi-Fi and Cellular.

Ivanti recommends using Wi-Fi only if you support large number of documents.

App Configuration

URL

Enter a URL for the content site.

The URL must include http:// or https://. Both domain name and IP address are supported.

To use the following CIFS URL

smb://server.name:445/path/to/share/folder

Convert it to a Content Site URL

https://server.name:445/path/to/share/folder

Domain

Select the type of content site you are configuring:

  • SharePoint (Select SharePoint for One Drive for Business)
  • WebDAV

Subdomain

Select the subdomain type for the content site:

  • SharePoint: Office 365, Corporate

Select Office 365 if you are configuring OneDrive for Business.

  • WebDAV: NetworkDrive, CloudStorage

Authentication

Select if you want the device to authenticate to the server.

Published Site

Select to designate the site as a published site.

All content in a published site is automatically downloaded and mirrored locally on the device when the device syncs. If the option is not selected, the user must manually download the content.

A Web View site cannot be configured as a published site, and a published site cannot be configured as a Web View site.

Published sites for SharePoint are not supported at root, site, and subsite levels. Published sites are supported at document library and folder levels. Ivanti recommends that published sites be set for publishing 50-100 documents.

Web View

Only for SharePoint domains.

Select to allow users to view and navigate SharePoint folders in browser view.

Published site

Update Interval (Minutes)

Specify the updated interval for published sites.

The Default setting is every 60 minutes.

Max auto download size (MB)

Specify the maximum file size for automatic download. Files above this size will not be automatically downloaded. The default setting is 500 MB.

Max documents per update

Specify the maximum number of documents to update for each updated site. Only the number of files specified will be updated. The default setting is 100 files.

Update Mode

Specify the method devices can use to update published sites. Select either Wi-Fi Only or Wi-Fi and Cellular. Ivanti recommends using Wi-Fi Only if you support large number of documents.

Custom Configurations

To configure custom app behavior, add key-value pairs to manage and control the device user experience. For more information about configurable key-value pairs, see Additional configurations using key-value pairs.