iManage Integration

Admin setup of iManage integration

Cloud iManage Server

  1. Go to DBL and use the account dropdown to go to Organization Settings > Integrations.
  2. Under “Document Integration”, select ” iManage Cloud” and press “Save”.
  3. Configure your iManage work server. In most cases this should be “cloudimanage.com”, without any “https://” or additional path
  4. Press “Save”
  5. To confirm that everything is set up properly, test the iManage authentication with your own account.

On-Prem iManage Server

In order to integrate Dashboard Legal with on On-premise iManage server, you will need a package provided to you by the Dashboard Legal team.

  • Send your DBL representative the full url where Dashboard Legal is deployed.
  • You will be returned a file titled “manifest.yaml.zip” which includes the package necessary for the integration.

 

  1. Log into your iManage control center, and upload an application package that was provided to you.
  2. Enable the application for all of your users, and please set “Allow Refresh Token” to “Yes”
  3. Go to DBL and use the account dropdown to go to Organization Settings > Integrations.
  4. Under “Document Integration”, select ” iManage On-Prem” and press “Save”.
  5. Configure your iManage work server. This should look like “domain.com”, without any “https://” or additional path
  6. Press “Save”
  7. To confirm that everything is set up properly, test the iManage authentication with your own account.

 

Integration Details

Requirements

  • iManage 10 or above (cloud or on-prem)
  • iManage server needs to accept https requests from the following trusted DBL IP addresses
    • 3.216.106.22
    • 50.16.89.87
    • 34.194.112.116
    • 34.215.146.24
    • 34.211.19.80
    • 44.233.49.140
    • 3.133.176.193
    • 3.15.81.45
    • 18.116.255.130

API Endpoints

The following API endpoints are used, prefixed with “[BASE_URL]/work/api/v2/customers/[CUSTOMER_ID]/libraries/[LIBRARY_ID]”

  • GET “/workspaces”
  • GET “/workspaces/[MATTER_ID]”
  • GET “/folders”
  • GET “/folders/[FOLDER_ID]”
  • GET “/documents”
  • GET “/documents/[DOCUMENT_ID]”
  • GET “/documents/[DOCUMENT_ID]/download”
  • GET “/documents/[DOCUMENT_ID]/versions”
  • POST “/workspaces/[MATTER_ID]/folders”
  • POST “/folders/[FOLDER_ID]/subfolders”
  • POST “/documents/[DOCUMENT_ID]/versions”
  • POST “/folders/[FOLDER_ID]/documents”

What happens next

The iManage integration will enable your organization users to log into iManage via their account integrations settings page. The authentication is Oauth2-based, and after being redirected to iManage to enter their credentials, they will be able to view the same documents in Dashboard Legal as they would in the cloud iManage UI.

If a user has not linked their iManage account, they will not be able to see any documents in Dashboard Legal, but a message asking them to log in. The user should only have to log in once, but if they ever want to refresh their API token, or disconnect their iManage account, they may do so from their account integration page.

Please take a look at the how to guide for managing documents as a user or workstream admin.

Things to note about administering the iManage integration

  • iManage matters are mapped to Dashboard Legal Workstream boards. In the settings for the board, board admins will find a dropdown to select the iManage matter for that workstream.
  • Once linked, that matter’s documents will show up in the workstream board. An iManage matter can only be linked to one Dashboard Legal Workstream
  • You can only set up one DMS integration at a time. If you go back to the organization integration settings and select “Dashboard Legal”, the workstream documents will source from Dashboard Legal’s DMS. Although it’s possible to toggle between various DMS providers, we’d recommend not doing that.