...
On This Page
| Table of Contents |
|---|
Overview
The Egnyte connector in DryvIQ allows you to analyze, migrate, copy, and synchronize files to/from your Egnyte account to/from cloud storage repositories and on-premise network file shares. The first step is to create the Egnyte connection by providing the connection information required for DryvIQ to connect to the account.
Create Connection | User Interface
Select Connections > Add connection.
Select Egnyte as the platform on the Add connection modal.
Enter the connection information. Reference the table below for details about each field.
Select Sign in with Egnyte.
On the Egnyte log in modal, enter the e-mail address or username for the account you are using for the connection and select Continue.
Enter the password for the account and select Log in.
Select Allow Access when prompted to authorize the connection.
You will see a "Connection test succeeded" message on the Add connection modal. (If you don't see this message, repeat the sign in and authorization steps above.)
Select Done to finish creating the connection.
Add Connection Modal - Egnyte
...
...
Field
...
Description
...
Required
Display as
...
Enter the display name for the connection. If you will be creating multiple connections, ensure the name readily identifies the connection. The name displays in the application, and you can use it to search for the connection and filter lists.
If you do not add a display name, the connection will automatically be named using the account owner's name. For example, Egnyte (John Doe). If it will be useful for you to reference the connection by account, you should use the default name.
...
Optional
...
User Type
...
Required
...
Connect as standard user
...
Select this option to create a standard connection to access a user's files and folders. This is the default selection.
...
Connect as account administrator
...
Select this option to create an administrator connection. This requires administrator privileges and grants access to all accounts within the organization. This option is often used along with impersonation to simplify transferring multiple user accounts. When connected as an administrator, the first level of folders will be user names.
...
Domain
...
Enter the URL for your Egnyte account. It will look something like https://companyname.egnyte.com.
...
Required
Egnyte Log In
...
Grant Access to Egnyte Account
...
Connection Test Succeeded
...
Features and Limitations
Platforms all have unique features and limitations. DryvIQ’s transfer engine manages these differences between platforms and allows you to configure actions based on Job Policies and Behaviors. Utilize the Platform Comparison tool to see how your integration platforms may interact regarding features and limitations.
Files and Folders
Below is list of Egnyte’s supported and unsupported features as well as additional file/folder restrictions. The information below the tables provides additional details about supported and unsupported features as well as best practices when using this connector.
...
Supported Features 
...
Unsupported Features 
...
Other Features/Limitations 
...
...
...
Invalid characters: / < > : \ | ? * +
...
Timestamp preservation
(See below for more information)
...
...
Path length maximum
(See Path Lengths below)
...
...
...
Segment path length: 245
(See Path Lengths below)
...
...
...
No leading periods
...
...
...
No trailing periods before extensions
...
Permissions preservation
(See below for more information)
...
No leading whitespace
...
...
No trailing whitespace before an extension
...
...
No trailing whitespace after an extension
...
No non-printable characters
API Rate Limits
Depending on the project scope, performance may be impacted by Egnyte's rate-limiting restrictions. Prior to transferring content, DryvIQ recommends contacting Egynte (api-support@egnyte.com) to discuss increasing your API call volume by obtaining additional OAuth tokens. Requesting additional OAuth tokens will allow DryvIQ to make the required calls to Egnyte while working within their restrictions. The performance will depend on the number of additional OAuth tokens approved by Egnyte for your tenant. Please see Egnyte's documentation for further details.
Path Lengths
Egnyte does not impose restrictions for the total path length.
Segment path lengths are limited to 245 character. Segments are delimited by a forward slash (/). For example, <max 245 characters>/<max 245 characters>.
Permissions
DryvIQ supports and migrates permissions if “Permissions Inheritance” is enabled on Egnyte.
Timestamp Preservation
The DryvIQ Platform will extract and preserve file timestamps for created-on and modified-on dates for all storage platforms. However, Egnyte does not maintain a traditional created-on timestamp. When the source platform does not preserve the created-on timestamp, DryvIQ will make all attempts to capture timestamps starting with Egnyte's modified-on timestamp.
For the Version Preservation feature, DryvIQ is using two variants of Egnyte's modified-on timestamp:
Modified-on First Version: This is the closest parallel to a traditional created-on timestamp. For the first version of the file, regardless of how many versions exist, the first modified-on timestamp is considered the created-on timestamp.
Modified-on Current Version: This is the closest parallel to last modified-on timestamp. For the current version of the file, the modified-on timestamp is considered the last modified-on timestamp.
While the Egnyte uploaded-on timestamp is available, DryvIQ ignores this option as there is no corresponding timestamp attribute available on other storage platform. For example, Box's uploaded-on timestamp is a native operation, and Box prevents any write operation to this attribute.
Users
Egnyte supports three levels of users: Administrators, Power Users, and Standard Users. DryvIQ handles each user differently.
Administrators: This is the user who registers for the account. That user is automatically set as the account administrator.
Power Users: These users are the company employees. These are considered internal users. Author preservation is preserved for content created in private folders and for Egnyte Power Users. Sharing permissions are also preserved for power users.
Standard Users: These are the company’s business partners. These are considered external users. If standard users are included in a group, they are not transferred, and DryvIQ will not log unresolved permission errors.
For more information about Egnyte users, refer to Egnyte's Users and Groups documentation.
...
Creating a Connection
The following GET messages will return an Egnyte login link. Use the link to complete logging into the account and to grant DryvIQ access to the account.
Create a New Connection as a Standard User
| Code Block | ||
|---|---|---|
| ||
GET {{url}}v1/connections/platforms/egnyte/new |
Create a New Connection as an Account Administrator
| Code Block | ||
|---|---|---|
| ||
GET {{url}}v1/connections/platforms/egnyte/new?admin_mode=1 |
...