Support for migrating Manage Engine attachments into a Service Now instance is provided when migrating CSV files extracted using the Manage Engine Support Utility.
When extracting Manage Engine Attachments from a URL, authentication needs to be provided.
The method of authentication required will depend on whether the Manage Engine instance is On Premise or in the cloud.
- Manage Engine in the cloud uses a type of Oauth2 authentication
- Manage Engine on premise typically uses a bearer token authentication.
To configure this authentication, perform the following steps:
Configure Attachment Migration for the form mapping(s) in the project you are using to migrate the data
See the section CSV to Service Now - Configuring Attachment Migration on the Form Mapping for more information.
In the attachment configuration settings (on the options tab) select the URL Authentication Method.
- For cloud based Authentication, select 'Manage Engine'.
- For on Premise, select 'Bearer Token.
This informs Precision Bridge that it needs to authenticate each call to download attachments via URL.
When executing the project, go to the Attachments tab, then the URL Authentication tab. This will be for 'Manage Engine' or 'Token' depending on what was selected in the form mapping.
Entering Manage Engine Authentication Details
The following information must be entered:
| Field | Description |
| Accounts URL |
This is the URL that ManageEngine will call to obtain a one use code that can be used to obtain a session token for the connection to Manage Engine. This will usually be https://api-console.zoho.com/ or similar. |
| Client ID |
This will be obtained from your 'Self Client' created using the above Accounts URL. See the 'Generating an API Code' section of the article ManageEngine to CSV Utility for more information on creating and using a Self Client |
| Client Secret |
Again this will be obtained from your Self Client |
Entering Bearer Token Authentication Details
The following information must be entered:
| Field | Description |
| Token |
This will be an API token generated for a particular user. Refer to Manage Engine documentation on how to generate this. |
| Custom Header |
In the API call the authentication is sent using the 'Authorization' header. By default, the value is formatted as Bearer <token> however if a different header is used, you will need to specify its name here. Manage Engine on premise may use the authtomen header. Check the Manage Engine API documentation for clarification. |
Project Execution
With the 'Manage Engine' authentication method configured, each time the project is executed and begins to load, you will be prompted for a code:
This code should be generated with your Self Client. A new code is needed for each execution, codes can only be used once. Again, see the ManageEngine to CSV Utility article for more information.
If the Accounts URL, Client ID, Client Secret and Code are valid, Precision Bridge will obtain a session token, stored internally, which will be used for this execution to extract the Manage Engine attachments.
If any of the above are invalid, an error will occur and the Execution Load will terminate.
Related Articles
CSV To Service Now Attachment Migration - Overview
CSV to Service Now - Configuring Attachment Migration on the Form Mapping
Comments
0 comments
Please sign in to leave a comment.