Register an iManage Work Application for Token Vault
This topic describes the first configuration task in the process of setting up an iManage Work connector to use modern authentication (OAuth2).
Perform this task through the iManage Help Center if you have an iManage Cloud server, otherwise in the iManage Work Control center.
To register an application in iManage Cloud, do the following:
- Contact the iManage Help Center (https://help.imanage.com/) and submit a new application registration request.
- The request must contain the following information:
- The application must be Web type.
- The Allow Refresh Token option must be on.
-
A list of redirect URIs corresponding to your Token Vault configuration in the following format:
https://<FQDN>:<port>/callback
where
- FQDN is the fully qualified domain name of the Token Vault machine.
- port is the value of HttpsPort setting in the Token
Vault appsettings.json configuration file in case of
https usage.
For example: https://tokenvaultmachine.testdomain.com:8381/callback.
This URI must be the same as the Redirect URI displayed by Token Vault on the Authorization Provider registration page.
You should receive a Client ID and Client secret, which corresponds to the newly registered application.
To register an application in iManage Work Control Center of an on-premise iManage Work server, perform the following steps:
- Open the Control Center of your iManage Work server.
- Select Applications under Settings group in the menu on the left.
- Click on Add Application to register a new application, and select Configure Manually.
- Fill out the registration information of application:
- Specify a Name for the application.
- Specify a unique API Key for the application. Copy this value for
later use.
This application property is required for the registration an iManage Work authorization provider in Token Vault.
- Click on the Auto-Generate under the API Secret textbox to generate a new API Secret for the application. Copy the newly generated API Secret value for later use. This is another required application property for registering an iManage Work Authorization provider in the Token Vault.
- Click on Authentication button at the bottom of this page, and fill out
the authentication information for the application:
- Select Web as Application Type.
- Select Confidential as Client Type.
- For Redirect URI enter your Token Vault configuration in the
following format: https://<FQDN>:<port>/callback
where
- FQDN is the fully qualified domain name of the Token Vault machine and
- port is the value of HttpsPort setting in the Token Vault
appsettings.json configuration file in case of https usage,
For example: https://tokenvaultmachine.testdomain.com:8381/callback.
This URI must be the same as the Redirect URI displaying by Token Vault on the Authorization Provider registration page.
- Turn on Allow Refresh Token option.
- Click on the Access button at the bottom of this page.
- For the Allow access to option select All users or select Custom and add only those users who will use eCopy ShareScan iManage Worksite connector with modern authentication.
- Click on the Review button on the bottom of this page to review application settings.
- After you reviewed the application settings and Enable application on the Review page, click on the Finish button to finish application registration.