Microsoft recently made a change where their real-time collaboration feature now uses Microsoft Authentication Library (MSAL) authentication instead of Azure Active Directory Authentication Library (ADAL). So, 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 the iManage Co-Authoring app on the Azure store. 

Registering the 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. When the required permissions are provided, you can continue with your co-authoring session. 

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

If you're using iManage Work Desktop for Windows 10.7.0 or earlier, your administrator must register the iManage Co-Authoring app in Azure AD by performing the following steps. If you don't register the iManage Co-authoring app, an error message 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. A list of all app registrations is displayed.

  3. Select New registration. The Register an application page opens.

  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 enter 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. On the sidebar of the new application registration page, select API permissions. The Request API permissions page opens. 

  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 user files and Read and write items and list in all site applications.

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

  • <key name="OneDriveClientID" value="7817b9c1-b0fd-4ffb-bdc2-2cbbc138b675"/>

  • <key name="OneDriveReturnUrl" value="https://login.microsoftonline.com/common/oauth2/imanageCoAuthoring"/> 

For more information about registering an app in Microsoft Azure AD, go to:
https://learn.microsoft.com/en-us/entra/identity/app-proxy/application-proxy-configure-native-client-application#step-2-register-your-native-application

NOTE: If the “Need Admin Approval” error message is displayed, even though you've registered the co-authoring app in Microsoft Azure AD, your administrator has to provide the necessary permissions. Contact your administrator for further help.