Microsoft recently made a change where their real-time collaboration feature now uses Microsoft Authentication Libary (MSAL) authentication instead of Azure Active Directory Authentication Library (ADAL). Hence, iManage co-authoring authentication is now upgraded to use Microsoft Authentication Logic (MSAL) instead of the Microsoft Azure Active Directory Authentication Library (ADAL). With this upgrade, Co-authoring no longer uses ADAL authentication. Additionally, we've published iManage co-authoring app on the Azure store. 

Registering iManage Co-authoring app for iManage Work Desktop for Windows 10.7.0 or earlier

If you are using iManage Work Desktop for Windows 10.7.0 or earlier, your administrator must register iManage Co-authoring app in Azure AD by doing the following steps. If you don't register the iManage Co-authoring app, an error will be displayed and you'll be unable to send documents for co-authoring. 

  1. Sign in to the Azure portal.
  2. Browse to Azure Active Directory > App registrations. The list of all app registrations appears.
  3. Select New registration. The Register an application page appears.
  4. In the Name heading, specify a user-facing display name. For example, iManage Co-authoring.

  5. Under the Supported account types heading, select an access level.

  6. Under Redirect URI, select Public client (mobile & desktop), and then type the redirect URI. For example, https://login.microsoftonline.com/common/oauth2/imanageCoAuthoring.

  7. Select and read the Microsoft Platform Policies, and then select Register. An overview page for the new application registration is created and displayed.

  8. In the sidebar of the new application registration page, select API permissions. The Request API permissions page appears. 

  9. Under the Select an API setting, select Windows Azure Active Directory, Microsoft Graph, and Office 365 SharePoint Online.
  10. In the Select permissions heading, select Delegated permission and then select the following options for each API: 
    • Windows Azure Active Directory: sign-in and read user profile
    • Microsoft Graph: sign-in and read user profile
    • Office 365 SharePoint Online: Read and write usr files and Read and write items and list in all site applications

Update the following options in the coauthoring configuration setting in imWorkOptions.xml file:

For more information about registering an app in Microsoft Azure AD, see: How to enable native client applications to interact with proxy applications.

NOTE:

If you see a 'Need Admin Approval' error message, even though you have registered the co-authoring in Microsoft Azure AD, your administrator has to provide the necessary permissions. Contact your administrator for further help. 

Registering iManage Co-authoring app for iManage Work Desktop for Windows 10.8.0 or later

When you install iManage Work Desktop for Windows 10.8.0 or later and start a co-authoring session for the first time, a prompt requesting for permissions is displayed. This is because iManage Work Desktop for Windows 10.8.0 or later now automatically registers and uses our hosted iManage Co-authoring app. Once the required permissions are provided, you can continue with your co-authoring session.