2.2 Installing the Office 365 Driver

2.2.1 Installing the Driver Shim

Ensure that you perform the following tasks before installing the Office 365 driver:

  • Create an Office 365 user administrator account through which the driver can authenticate to Office 365 and perform administrative functions, such as creating users and groups. The driver must log in to Office 365 using an Office 365 account with administrative privileges.

  • Install the Microsoft requirements as in the prerequisites.

    The Microsoft Online module is installed in the default Windows PowerShell path of your Windows computer.

    By default, Microsoft Online Services Sign-In Assistant is installed in the path C:\Windows\System32\WindowsPowerShell\v1.0\Modules\MSOnline.

    and Microsoft Online Services Module in C:\Windows\System32\WindowsPowerShell\v1.0\Modules\MSOnlineExtended.

    For the driver to start successfully, ensure that you copy all the dll files from these two default Windows PowerShell paths to the driver installation folder.

To create and configure the driver, install the driver files from the installation directory of the msonlinedriverfp.zip file.

To install the driver, perform the following steps:

  1. Before starting the installation, stop the .NET Remote Loader service.

  2. Navigate to the <Identity_Manager_4.8_Windows.iso extracted location>\products\IDM\windows\setup\drivers\office365 folder.

  3. Copy the DXMLMSOnlineDriver.dll, SQLite.Interop.dll, and System.Data.SQLite.dll files to the .NET Remote Loader installation folder.

  4. Download the driver packages from the Package Update channel.

  5. For creating a driver, see Section 4.0, Creating a New Driver Object.

2.2.2 Configuring the Office 365 Driver

Use the .NET Remote Loader graphical interface to configure the Office 365 driver:

  1. Browse to the installation directory of the .NET Remote Loader and run rlconsole.exe to open the GUI console. The .NET Remote Loader GUI is similar to the traditional Remote Loader GUI.

  2. Click Add, then specify the Description, Driver (DXMLMSOnlineDriver.dll) and other parameters in the page that displays.

  3. To configure the Office 365 driver as an application, deselect the Establish a Remote Loader service for this driver instance.

    You can configure the Office 365 driver as an application or as a service.

  4. Click OK. A prompt displays asking you if you want to start the Remote Loader. You can start the driver now or later.

    When the driver is started as an application, a trace window opens. It doesn’t open if the driver is started as a service.