Overview

DryvIQ supports connections to Microsoft OneDrive for Business Government Community Cloud (GCC) High — an environment that provides compliance with US government requirements for cloud services platforms. The DryvIQ Microsoft OneDrive for Business GCC High connection enables you to analyze, migrate, copy, and synchronize files from your OneDrive account to cloud storage repositories and on-premises network file shares. DryvIQ creates the connection using the OAuth 2.0 flow to simplify login and connection management. You can use any administrator account with the proper privileges to manage Microsoft 365 configurations to create the connection.

Do not select the “Microsoft Office 365 GccH (OAuth 2.0 Deprecated)” connector. This is the old connector that uses CSOM, which Microsoft is deprecating. Select the “Microsoft Office 365 GccH” connector when creating the connection since it uses Microsoft Graph API, which results in better job performance.

Creating a Connection

Expand the Manage section in the left navigation menu.
Click Connections.
Click Add connection.
Select Microsoft OneDrive for Business GccH as the platform on the Add connection modal.
Enter the connection information. Reference the table below for details about each field.
Click Sign in with Microsoft OneDrive for Business GccH.
Enter the email for the account being used to create the connection and click Next. You must use an admin account with the proper privileges to manage Microsoft 365 configurations.
Enter the password for the account and click Sign in.
You will see a green "Connected” message on the bottom of the modal when DryvIQ establishes connection. (If the connection fails, verify the information you entered.)
Click Done to finish creating the connection.

Add Connection Modal for Microsoft OneDrive for Business GccH

Field	Description	Required

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.	Optional
URL	Enter the URL of your Microsoft OneDrive for Business GCCH High account. You can find the URL by logging into Microsoft OneDrive for Business GCCH High using the account you want to use to create the connection. The URL in the address bar is the URL you need to use.	Required
Token endpoint	This setting is rare for most Microsoft connections and can be left blank. If needed, your administrator will provide this value.	Optional
Graph API endpoint	This setting is rare for most Microsoft connections and can be left blank. If needed, your administrator will provide this value.	Optional
External users notifications	This indicates if you want to send notifications to external users. The default value is No, so notifications will not be sent. If you select Yes, notifications will be sent to external users when they have been granted access to content based on permissions.	Optional
Behavior When Deleting Items	Select the type of deletion DryvIQ should perform when deleting items: Permanent or Soft. Soft delete is the default behavior. A soft delete marks items as deleted. You can still access them to restore or permanently delete the items. Permanent delete is the recommended behavior. A permanent delete removes the items. This deletion is not reversible.	Optional

Microsoft Login

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. Use the Platform Comparison tool to see how your integration platforms may interact regarding features and limitations.

Supported Features	Unsupported Features	Other Features/Limitations

Supported Features	Unsupported Features	Other Features/Limitations
Version preservation	Mirror lock ownership	Invalid characters: \| " \ / : * ? < > See below for more information.
Timestamp preservation		File size maximum: 250 GB Microsoft limit DryvIQ uses a file maximum size of 249.999999 GB to ensure transfer. See below for more information.
Author/Owner preservation		Segment path length: N/A
File lock propagation		Path length maximum: 400
Account map See below for more information.		Restricted types: N/A
Group map		Maximum number of files per folder: 5000
Permission preservation		Maximum Enterprise Keyword length: 255 characters
User impersonation		Restricted characters in Enterprise Keywords: < and >
Metadata map See below for more information.		No leading whitespace See below for more information.
Tags map		No trailing periods and whitespace. See below for more information.
		If a file extension is present, trailing periods and whitespace are allowed before the extension
		No non-printable ASCII characters
		Transferring Microsoft Lists is not supported.

Authentication Requirement for Microsoft Office 365 Connections

Some SSO providers retain prior login sessions and allow users to select an existing account during sign-in. This behavior can result in a connection being created using an unintended user identity. To prevent this, DryvIQ requires a new authentication for each new connection, even if the account has already been authenticated. This ensures that every connection is created with the correct user account, permissions, and tenant context.

File and Folder Name Restrictions

The following are restricted file/folder names.

_vti_test
CON
PRN
AUX
NUL
COM0
COM1
COM2
COM3
COM4
COM5
COM6
COM7
COM8
COM9
LPT0
LPT1
LPT2
LPT3
LPT4
LPT5
LPT6
LPT7
LPT8
LPT9

For more information on restrictions, see Microsoft’s official documentation.

Connection Pooling

Microsoft Office 365 connections using OAuth 2 authentication may experience bandwidth throttling from Microsoft when using connection pooling.

Corrupt Files

If you see “Error=Value=CobaltAllZerosDetected” errors in the logs, the file that triggered the error will not be uploaded to SharePoint Online. Microsoft produces this error for files it considers to be corrupt.

Delta Job Runs

After the initial transfer of an item using a Microsoft SharePoint connection, DryvIQ will leverage Microsoft’s change tracking API on delta job runs to identify changes. This results in fewer Graph API requests and shorter job execution times.

HTML Files

SharePoint Online does not support uploading HTML files larger than 256 MB. If your migration includes HTML files that exceed this limit, the file transfer will fail, and an entry will be logged in the audit with the following message: "Unable to interpret the contents of this page because it exceeds the maximum page size of 268435456 bytes.”

Impersonation with Batch Mode

When using Impersonation with Batch Mode, SharePoint Online shows “System Account” in the activity rather than the impersonated user. This is expected behavior for batch mode/bulk migration API. With batch mode off, the impersonated user will display in the activity panel.

Invalid Characters and Spaces

DryvIQ verifies file and folder names to identify unsupported characters based on the platform. Invalid characters are handled according to the Allow unsupported file names to be changed setting for the job.

If the setting is disabled, DryvIQ will throw an exception when it encounters a file or folder that cannot be migrated due to an unsupported character in the name.

If enabled, DyvIQ will replace invalid characters with an underscore (_) or UTF-8 encoding based on the option selected. This will allow the files and folders to be transferred. The logic includes leading and trailing spaces in file and folder names. DryvIQ replaces the space rather than trimming it because trimming the space could cause duplicate file names. Adding the underscore ensures the name remains unique.

DryvIQ will sanitize file names that contain combined Unicode characters by replacing them with underscores (_).

Language Translation

DryvIQ does not support translation when migrating between SharePoint sites that have different default language configurations.

Mapping

When creating CSV mapping files for import, usernames must be lowercase to meet the connector's search requirements.

Metadata Mapping

If a library requires specific metadata but the file being copied into the library lacks it, the file will be flagged and will not transfer in subsequent job runs. If you have files stuck in a flagged state due to missing metadata, you may need to transfer the files and add the required metadata manually.

OneNote Files

Microsoft has specific standards for migrating OneNote notebooks (as defined in Microsoft documentation), and DryvIQ adheres to them. DryvIQ converts OneNote content during the initial folder transfer. If a folder is recognized as a valid OneNote notebook, DryvIQ converts it to the appropriate OneNote notebook format in Microsoft 365. The item status in the DryvIQ Platform will be shown as Revised to indicate that DryvIQ performed a conversion during migration.

Only the top-level notebook folder is marked and reported as converted. Nested OneNote subfolders that belong to the same notebook are included in the migration, but they are not reported as separate converted notebooks. This provides clearer migration results and avoids duplicate conversion entries.

If a folder is not a valid OneNote notebook, DryvIQ does not convert it; instead, it transfers it as a standard folder in Microsoft 365.

Updates to the files after the initial transfer do not change the folder type. DryvIQ does not re-evaluate folder eligibility for OneNote conversion on subsequent job runs. For example, if a folder contains a non-OneNote file, DryvIQ transfers it as a regular folder during the initial migration. If you later remove the non-OneNote files from the source folder, DryvIQ will not detect that change and will not attempt to convert the folder in later executions.

Site and Library Path Resolution

Microsoft connectors use a SharePoint-based URL to identify the target location. In some cases, a SharePoint site and a document library can have the same name and therefore appear to share the same path. When this happens, DryvIQ will use the document library.

When entering paths manually, small mistakes such as extra spaces or typos can cause SharePoint to create a new document library instead of using the intended site or library. DryvIQ will then use that newly created location as the destination.

Always verify URLs and paths carefully to avoid migrating content to an unintended location.

Timestamps

There is a discrepancy in timestamps for the SharePoint Online Folder Created Date when using CSOM and Batch Mode. This behavior is a known issue within OneDrive for Business/Office 365.

DryvIQ will attempt to preserve timestamps on folders when using both CSOM and the batch API. However, SharePoint Online updates the folder's modified dates whenever a file is uploaded into it. As a result, when using CSOM, timestamps are preserved when the folder is created, but they are updated after each file is uploaded. When using the batch API, it preserves the timestamps on folders after all files in the batch are committed. This process is the cause of the discrepancy between the two methods.

Version Deletes

Version deletes are supported.