Set up iManage spoke
Integrate a ServiceNow instance and the iManage spoke by using iManage credentials to authenticate ServiceNow requests.
Before you begin
- Request an Integration Hub subscription.
- Activate the iManage spoke.
- Role required: admin.
Request an application with iManage
Request an application with iManage and register it in the iManage Control Center.
Before you begin
You must have an iManage account and tenant administrator credentials.
Role required: admin
Procedure
As an iManage Cloud (cloudimanage.com) customer, send an email to appregistration@imanage.com with the following details.
- Application Name: ServiceNow - External Storage
- Redirect_Url:
<your-instance>/oauth_redirect.do - Customers name: Give your Customer name
- Tenant/Customers ID: Give your tenant or customer ID iManage will review and respond with the Client ID and Secret
Once you have the Client ID/ Secret, register your application in iManage Control Center by following the document Adding an application.
Note:
- This integration capability has been validated for iManage cloud. If you want to use it for iManage on-premises, validate that it meets your requirements before using it.
- If you are a iManage on-premises user, follow the document Adding an application package to register your application.
What to do next
Register iManage as OAuth provider.
Register iManage as OAuth provider
Register iManage as an OAuth provider to allow the instance to request OAuth 2.0 tokens.
Before you begin
Note the following requirements:
- Integration Hub subscription.
- iManage access credentials
- The iManage spoke must be activated
Role required: admin
Procedure
On your ServiceNow® instance, navigate to System OAuth > Application Registry.
Select New.
On the page titled What kind of OAuth application, select Connect to a third-party OAuth Provider.
On the form, fill in the fields.
Field Description Name Unique name to identify the record, for example, iManage OAuth profile.Client ID Application ID of the iManage application. Client Secret The Client Secret you generated when you created the application. Default Grant type The value in this field should be Password. Token URL The value in this field should be https://cloudimanage.com/auth/oauth2/token. You might have to unlock the field to enter the value.Redirect URL The value in this field should be https://<your-instance>.service-now.com/oauth_redirect.do. You might have to unlock the field to enter the value.Right-click the form header, and select Save.
The system validates the OAuth credentials.
Result
iManage is registered as an OAuth provider, which enables the instance to request OAuth 2.0 tokens.
What to do next
Integrate the iManage spoke with ServiceNow instance.
Integrate the iManage spoke with ServiceNow instance
Integrate the connection to your iManage account. The iManage spoke connection & credential aliases use these connections to perform actions in iManage.
Before you begin
Role required: admin
Procedure
Navigate to All > IntegrationHub > Connections & Credentials > iManage.
Select the Create New Connection & Credential related link.
On the form, fill in the fields.
Field Value required Connection Name Name to identify the connection. This field is automatically set to iManage spoke connection. Connection URL The URL to establish connection with the spoke. This field is automatically set to https://cloudimanage.com. Update the default URL to your specific URL required to establish the connection.OAuth Entity Name Name of the OAuth entity profile. This field is automatically set to iManage spoke Auth. OAuth Client ID Client ID of the iManage application you registered in the registration portal. OAuth Client Secret Client Secret generated when you registered the application in the iManage portal. OAuth Redirect URL The redirect URL. The format of the URL is https://<your-instance>.service-now.com/oauth_redirect.do. Select Create and Get OAuth Token.
Result
The iManage spoke is set up and integrated with your ServiceNow instance.