Cherwell
Import your tickets, assets and users from Cherwell
The Cherwell connector allows you to connect to your Cherwell environment to retrieve ITSM tickets, CMDB inventory and user information via OAuth2 API.
Objective
The Cherwell connector allows you to retrieve the following information:
- ITSM tickets (incidents, requests, changes)
- CMDB assets (equipment, configurations)
- Users and groups
Prerequisites
- Access to Cherwell with administrator rights
- OAuth2 API access enabled
- API credentials (Client ID and Client Secret) configured
Authentication
This connector uses OAuth2 (Client ID + Client Secret) for API authentication.
Procedure
Generate OAuth2 Credentials
- Access Cherwell (Ivanti CSM):
- Log in to your Cherwell environment with administrator rights.
- Navigate to REST API Configuration:
- Go to CSM Administrator > Security > Edit REST API client settings.
- Create a REST API Client:
- Click the + button to add a new client.
- Enter a name for the API client.
- Configure OAuth2 with Client ID.
- Note the Client ID and Client Secret generated.
- Store Credentials:
- Copy the Client ID and Client Secret securely.
- You will also need your CSM username and CSM password for authentication.
Configure in OverView
- In OverView, go to Data Sources Settings > Sources.
- Select Cherwell and click Configure.
- Fill in the required fields:
- Client ID: Your REST API Client ID
- CSM Username: Your Cherwell administrator username
- CSM Password: Your Cherwell administrator password
- Click Save Configuration.
Alternative: file import through DropPoint
The API access described above is the recommended method for this connector. Where it is not available (a segregated network, a version or licence without API, an export you already produce), OverView accepts file exports, to be uploaded to the bucket dedicated to Ivanti Cherwell.
Bucket : s3://cherwell/
Example : s3://cherwell/export.csv
The procedure is described in the OverView DropPoint guide: generating credentials, configuring the client, then sending files from the OverView web interface, the AWS CLI or an SDK. Its examples come pre-filled with this bucket when you follow this link.
Official Documentation
For more information, see the Ivanti Cherwell REST API documentation