File Director


OneDrive connector for Home map points

Configure Azure Active Directory (Azure AD) and the File Director admin console to use OneDrive accounts as the storage location for user's home map points. File Director can then utilize the 1TB of storage, included free of charge, with each Office 365 for Business license. Once configured, users can update files on map points using File Director and OneDrive clients. All changes are synchronized with the File Director server so the files are up-to-date, regardless of the client used to edit or view them.

You can use multiple application ID's when connecting to the SharePoint Online API, so each node in a cluster can have its own application ID, which improves the efficiency of the connector.

Watch a related video


  • Your perimeter firewall must allow communication to <instancename> on port 443 and Microsoft supplied URLs detailed in this article.
  • You are an Office 365 administrator.
  • Your public domain is associated with your Azure AD instance.
  • Password replication is set up on your local AD.

    Federated AD access is not supported - the local username UPN must match the one used to sign into Azure

  • Users have an Office 365 license assigned to them from the Office 365 Admin Center.
  • Users have OneDrive storage provisioned.

    For further information about how to pre-provision OneDrive for Business for your users, see:

    For further reading about integrating applications with Azure AD, see the Microsoft documentation.

The process below describes the setup using the new Azure AD portal. To see how to set it up using the classic Azure AD portal, click here.

Step 1 - Configure Azure AD

Log in to Azure AD and copy your Tenant ID

  1. Log into Office 365 as an Administrator.
  2. Click Admin.

  3. In the Admin center, select Admin Centers > Azure AD.

    The Azure Portal displays.

  4. Select the tile for your Azure Active Directory.

  5. Click Domain names from the Manage menu and copy your domain name to a text editor - you need this to generate data for the manifest.

Add a File Director application to Azure AD

  1. Select Enterprise Applications and click New application.

  2. Select All then click Application you're developing.

  3. Click Ok, take me to App Registrations to register my new application then click New application registration.

  4. Enter a Name for your application, select Web app / API and enter the Sign-on URL.

    This is the URL your users will use to sign in to File Director.

  5. Click Create.

    Your application is added to the list of App registrations.

Configure permissions for the appliance

This determines what the application is allowed to do and what it can access.

  1. Select the application you added then select Required permissions and click Add.

  2. Select Select an API and click Office 365 SharePoint Online (Microsoft SharePoint).

  3. Click Select.
  4. Select Select permissions and then select all Application Permissions.

  5. Click Select then click Done.
  6. Click Grant Permissions then click Yes.

Step 2 - Configuring File Director

This uses public key infrastructure to generate a self-signed certificate in the server and upload the public key to Azure as part of a manifest.

Copy the app ID

1.Click Manifest for your Azure AD application.

The manifest displays.

2.Copy the app Id from the manifest and save it to Notepad - you need this to generate data for the manifest.

One Drive Registration

  1. In the File Director Web Admin console, select Configuration > Cloud Connectors.
  2. Enter the Tenant Name - this is the domain name you copied from Azure AD in Step 1 - Configure Azure AD.
  1. Click Add Application ID to display the Add Application ID dialog.
  2. Enter the Application ID for the app - this is the app Id you copied from Azure AD and click OK.

A new App must be created in Azure for each Application ID you want to use.

  1. Repeat steps 3 and 4 until all app Ids have been added.
  2. Select an Expiry period; 1 or 2 years.
  3. Click Generate.

The data you need to add to the manifest is generated.

  1. Click Copy to copy the data to the clipboard. You can save this to a text editor if you are not going to edit the manifest immediately - if you are, just leave it on the clipboard.

In Azure AD, Locate the keyCredentials class in your manifest and paste the data you copied from the File Director web admin console between the square brackets.

  1. Click Save

Home Map Point Source

Select OneDrive as the Home Map Point Source. The OneDrive tenant name automatically populates from the manifest information.

Although OneDrive is selected as the Home Map Point Source, you still need to configure the active directory setting. The local Active Directory is used for authentication but must be in sync with Azure AD. For further information, see Configure the Active Directory connection.

When users access their Home folder, they are now using their OneDrive storage - there is no impact on their File Director user experience.

OneDrive now displays files that have been saved to the user's File Director home map point. A folder named _filedirector_ is also created in the root of user's OneDrive storage. This folder stores contains creation times, modified times, and other metadata.

Related Topics

Was this article useful?