The OneDrive AirSync simplifies importing content from Microsoft OneDrive to DevRev, supporting both one-time historical imports and ongoing incremental syncs.

Data synchronization is one-way from OneDrive to DevRev.

Supported Objects

The following table lists the OneDrive objects and their corresponding DevRev equivalents. Objects marked as Sync to DevRev are eligible for import from OneDrive to DevRev.

Supported Connection Types

OneDrive AirSync supports two connection types. Choose the connection type that best fits your organization's requirements.

User Flow (User-based OAuth connection)

In this flow, users create an OAuth connection by signing in with their Microsoft account.

• Each user authenticates using their Microsoft account.

• The connection accesses the OneDrive belonging to the authenticated user.

• OneDrive AirSync imports files from the authenticated user's OneDrive.

• Access to files follows the permissions of the authenticated Microsoft user.

• Administrator consent is required for the Microsoft Graph permissions used by the connection.

Important: When using the User Flow, OneDrive AirSync imports files stored in the authenticated user's OneDrive. Files that have been shared with the authenticated user through Shared with me are not imported.

Microsoft Graph's API for retrieving items under Shared with me is deprecated and does not provide a reliable long-term mechanism for importing and incrementally synchronizing these files. Therefore, OneDrive AirSync does not currently support files that are shared with the authenticated user.

App Flow (Client Credential Authentication)

In this flow, a Microsoft Entra administrator configures an application that uses client credential authentication.

• A Microsoft Entra administrator creates an application with the required Microsoft Graph permissions and grants admin consent.

• The connection uses the application identity instead of an individual Microsoft user.

• The connection can access OneDrive drives across the tenant.

• Users, groups, and group memberships can be imported across the tenant.

• This flow is recommended for organization-wide OneDrive imports.

Installing the OneDrive AirSync to your org

To get started:

1. Go to Settings > Integrations > Snap-ins.

2. Under the All Snap-ins tab, search for OneDrive AirSync.

3. Open the snap-in.

4. Click Add.

5. Click Install Snap-in.

Setting Up the OneDrive Connection

Depending on the connection type you choose, follow the corresponding setup process below.

User Flow (User-based OAuth connection)

1. Administrator consent

Administrator consent is required for the Microsoft Graph permissions used by the OneDrive connection.

Consent can be granted in either of the following ways:

1. An administrator creates the connection first

   • A Microsoft Entra administrator starts the OneDrive connection setup.

   • During the Microsoft OAuth flow, the administrator reviews the requested permissions and grants consent.

   • Once consent has been granted for the organization, other users can create their own OneDrive connections without requiring the administrator to repeat the consent process.

2. A non-admin user requests administrator approval

   • A non-admin user starts creating a OneDrive connection and signs in through the Microsoft OAuth window.

   • If administrator consent has not already been granted for the required permissions, the user is prompted to request approval.

   • The request is sent to the Microsoft Entra administrator for the organization.

   • The administrator reviews and approves the requested permissions.

   • After approval is granted, the user can continue with the connection setup.

The connection requires permissions to access OneDrive content and the Microsoft Entra directory information required by the connector.

For directory access, the connector uses permissions including:

A user cannot complete the connection setup until the required administrator consent has been granted.

2. Create the connection and start the import

After the required administrator consent has been granted:

1. Go to Settings > Integrations > AirSyncs.

2. Click Start AirSync and select OneDrive.

3. Click Add connection.

4. Select either Admin Connection or Non-Admin Connection.

   These tabs do not restrict which type of Microsoft user can create the connection.

5. Enter a name for the connection.

6. Click Next.

7. In the Connect Microsoft OneDrive step, click Authorize.

8. Sign in using the Microsoft account whose OneDrive content you want to import.

9. Complete the Microsoft OAuth flow.

10. DevRev discovers the OneDrive data set associated with the authenticated user.

11. Under What do you want to bring in?, select the discovered OneDrive data set.

12. Select the time frame for the data you want to import.

13. Review the objects and mappings.

14. Finish the setup and start the import.

OneDrive AirSync imports content from the authenticated user's OneDrive.

Shared with me limitation: OneDrive AirSync imports files stored in the authenticated user's OneDrive. Files that are shared with the user through Shared with me and are stored in another user's OneDrive are not imported.

App Flow (Client Credential Authentication)

The App Flow uses Microsoft Entra client credential authentication. It is intended for organization-wide OneDrive imports and does not depend on an individual Microsoft user's account.

All Microsoft Entra configuration steps must be performed by an administrator who has permission to create applications and grant tenant-wide admin consent.

Prerequisites

Before configuring the connection, ensure that you have:

• Access to the Microsoft Entra tenant containing the OneDrive data.

• Permission to create an application registration.

• Permission to grant administrator consent for Microsoft Graph Application permissions.

• Access to the DevRev organization where OneDrive AirSync is installed.

You will need the following values when creating the OneDrive connection in DevRev:

1. Client ID — Application ID of the Microsoft Entra application.

2. Tenant ID — Directory ID of the Microsoft Entra tenant.

3. Client Secret — Secret created for the application.

1. Create an application in Microsoft Entra ID

1. Sign in to the Microsoft Entra admin center.

2. Navigate to Entra ID > App registrations.

3. Click New registration.

4. Enter an application name.

   For example:

   DevRev - OneDrive AirSync

5. Under Supported account types, select:

   Accounts in this organizational directory only (Single tenant)

6. Leave the Redirect URI blank.

7. Click Register.

After the application is created, open its Overview page and note:

• Application (client) ID — this is the Client ID.

• Directory (tenant) ID — this is the Tenant ID.

2. Add Microsoft Graph permissions

1. Open API permissions.

2. Click Add a permission.

3. Select Microsoft Graph.

4. Select Application permissions.

5. Add:

Make sure each permission is listed with Application as its type.

3. Grant administrator consent

After adding the required permissions:

1. Click Grant admin consent for <tenant>.

2. Confirm the operation.

3. Verify that consent has been granted for every permission.

4. Create a client secret

1. Open Certificates & secrets.

2. Select Client secrets.

3. Click New client secret.

4. Enter a description, such as DevRev OneDrive AirSync.

5. Select the desired expiration period.

6. Click Add.

7. Copy the generated secret value immediately.

The client secret value is displayed only once. Store it securely before leaving the page.

When the client secret expires, the connection can no longer authenticate until it is updated with a valid secret.

5. Create the OneDrive App connection

1. Go to Settings > Integrations > AirSyncs.

2. Click Start AirSync.

3. Select OneDrive.

4. Click Add connection > Client Credentials Connection.

5. Enter a meaningful name for the connection.

6. Enter:

   • Client ID

   • Tenant ID

   • Client Secret

7. Click Next.

DevRev validates the credentials and establishes the connection.

6. Configure and start the import

After the connection is created:

1. Select the OneDrive data set presented by DevRev.

2. Select the time frame for the data you want to import.

3. Review the objects and field mappings.

4. Complete the remaining configuration.

5. Start the import.

Post import options

After a successful import, the following options are available for the imported OneDrive data.

Sync to DevRev

This option synchronizes modifications made in OneDrive with corresponding items previously imported into DevRev.

It also creates DevRev items for new content discovered in the imported OneDrive directories after the previous import or sync.

View Report

This option provides detailed information about the initial import and subsequent synchronization runs.

Delete Import

Use this option to remove an import and the content that was created by that import from DevRev.

Edit Connection

Use this option to change the connection used for subsequent sync operations.

This can be useful if:

• The original connection becomes inactive.

• The user who created a User Flow connection is no longer available.

• The client secret associated with an App Flow connection has expired or been replaced.

Sync to DevRev

After successfully importing data from OneDrive, you can manually synchronize changes from OneDrive with DevRev.

To perform a one-time sync:

1. Go to Settings > Integrations > AirSyncs.

2. Locate the previously imported OneDrive sync unit.

3. Select ⋮ > From OneDrive to DevRev.

This imports changes to previously imported files and any new content discovered since the previous successful synchronization.

A one-time sync may overwrite fields on previously imported DevRev items, even if those fields were modified directly in DevRev.

Historical imports

To view currently running or previous OneDrive imports:

1. Go to Settings > Integrations > AirSyncs.

2. Select the import you want to inspect.

3. Open the context menu (⋮).

4. Select View Report.

The report contains information about the initial extraction and subsequent synchronization runs.

The duration of an initial historical import depends on the amount of OneDrive content being imported and can range from seconds to several hours or longer for large datasets.

Periodic sync

After successfully importing OneDrive data into DevRev, you can enable periodic synchronization.

Periodic sync automatically checks OneDrive for changes and imports those changes into DevRev. By default, periodic synchronization runs once an hour.

To configure periodic sync:

1. Go to Settings > Integrations > AirSyncs.

2. Locate the previously imported OneDrive directory.

3. Select ⋮ > Set Periodic Sync.

4. Configure the desired synchronization settings.

The Enable automation for synced items option can also be enabled when configuring periodic sync.

When enabled, newly created or updated items trigger events that can initiate:

• Webhooks

• Notifications

• Snap-ins

• Other event-driven processes

as if the changes originated directly in DevRev.

If this option is disabled, synchronized updates do not trigger these event-driven processes.

This behavior applies only to periodic syncs. Events are not triggered during the initial import or a manual synchronization.

Changes made through Microsoft APIs may not always be immediately visible to the connector. Depending on Microsoft Graph propagation and processing, some changes may take additional time to appear in a subsequent sync.

Delete import

An import and all content created by that import can be deleted from DevRev.

This can be useful when:

• Running a proof of concept.

• Changing the import configuration.

• Recreating an import using a different connection.

• Changing from User Flow to App Flow or vice versa.

To delete an import:

1. Go to Settings > Integrations > AirSyncs.

2. Locate the previously imported OneDrive directory.

3. Select ⋮ > Delete Import.

Caution: Deleting an import permanently deletes the content that was created by the import, including imported files, users, groups, and group memberships, even if those objects were subsequently modified in DevRev.

After deletion, the OneDrive data can be imported again by creating a new import.