Ivanti Neurons for ITAM
App Vendor: Ivanti
App Category: IT Service Management
Connector Version: 1.1.0
API Version: 1.0.0
About App
Ivanti Neurons is a flexible and completely cloud-optimized tool that allows security teams to have more visibility into their entire asset inventory for asset management. The tool brings all the assets together by combining the contextual information of the assets to facilitate more accurate and actionable insights. Additionally, a holistic view of the users and device cut complexity, long wait times, and high escalation costs and allows security teams to remediate issues quickly.
The Ivanti Neurons ITAM app built for the Orchestrate application helps security teams to perform asset management-related actions on the Ivanti Neuron ITAM application and enables security orchestration workflows.
The Ivanti Neurons ITAM app is configured with the Orchestrate application to perform the following actions:
Action Name | Description |
|---|---|
Generic Request | This action makes a generic endpoint request to Ivanti. You can create your own endpoints to perform actions using business objects. |
Update Product Catalog | This action updates the product catalog on the Ivanti Neurons ITAM application. |
Create Product Catalog | This action creates a product catalog on the Ivanti Neurons ITAM application. |
Get Product Catalog Details | This action retrieves details of a product catalog from the Ivanti Neurons ITAM application. |
Get All Product Catalogs | This action retrieves all product catalogs from the Ivanti Neurons ITAM application. |
Update Service Request | This action updates the service request on the Ivanti Neurons ITAM application. |
Update CI | This action updates a Configuration Item (CI) on the Ivanti Neurons ITAM application. |
Create CI | This action creates a Configuration Item (CI) on the Ivanti Neurons ITAM application. |
Create Service Request | This action creates a new service request on the Ivanti Neurons ITAM application. |
Get All Service Request Templates | This action retrieves service request templates from the Ivanti Neurons ITAM application. |
Get All Service Requests | This action retrieves service requests from the Ivanti Neurons ITAM application. |
Get Service Request | This action retrieves details of a service request from the Ivanti Neurons ITAM application. |
Get CI Details | This action retrieves details of configuration items (CI) from the Ivanti Neurons ITAM application. |
Get All CI | This action retrieves the configuration items (CI) from the Ivanti Neurons ITAM application. |
Configuration Parameters
The following configuration parameters are required for the Ivanti Neuron ITAM App to communicate with the Ivanti Neurons ITAM application. The parameters can be configured by creating instances in the app.
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Base URL | Enter the Base URL, FQDN, or IP address of the host server. | Text | Required | Supported format: "https://<host>.<tld>" |
API Token | Enter the API Token to authenticate with the Ivanti ITAM instance. | Password | Required |
Action: Generic Request
This action makes a generic endpoint request to Ivanti.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Business Object | Enter the business object for the request. Example: "employees?$filter=LoginID eq 'test.user" Note: The above example can retrieve details from a business object. | Text | Required | Business objects are defined by the metadata stored in a business object definition. Any business object can be defined by just defining the name and its purpose. |
Method | Enter the HTTP method to be used for the request. Enter the method in capital letters. | Text | Required | Allowed values:
|
Params | Enter the parameters to pass with the query. | Key Value | Optional | |
Data | Enter the data to pass with the request. | Key Value | Optional |
Example Request
[
{
"business_object": "employees?$filter=LoginID eq 'test.user",
"method": "GET"
}
]Action: Update Product Catalog
This action updates the product catalog on Ivanti.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Rec ID | Enter the Rec ID to modify the product catalog. Example: "FF5FD2A8331349F7BE8F4C62FBDBABAC" | Text | Required | |
Created Date Time | Enter the creation date for the product catalog to update. Example: "2018-12-12" | Text | Optional | |
Created By | Enter the created by details to update. | Text | Optional | |
Read Only | Enter the read-only status to update. | Boolean | Optional | Allowed values:
|
Extra Params | Specify any extra parameters required to update. | Key Value | Optional |
Example Request
[
{
"rec_i": "FF5FD2A8331349F7BE8F4C62FBDBABAC",
"read_only": false,
"extra_params": {},
"created_date_time": "2018-12-12"
}
]Action: Create Product Catalog
This action creates a product catalog on Ivanti.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Created Date Time | Enter the created date time in YYYY-MM-DD format. Example: "2018-12-12" | Text | Required | |
Read Only | Enter the read-only status of the product catalog. | Boolean | Required | Allowed values:
|
Created By | Enter the name of the user creating the product catalog. | Text | Required | |
Extra Params | Enter any extra parameters to create a product catalog. | Key Value | Optional |
Example Input
[
{
"read_only": false,
"created_by": "Alan.Taylor",
"extra_params": {},
"created_date_time": "2018-12-12"
}
]Action: Get Product Catalog Details
This action retrieves details of a product catalog from Ivanti.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Rec ID | Enter the record ID of the product catalog to retrieve the details. Example: "FF5FD2A8331349F7BE8F4C62FBDBABAC" | Text | Required |
Example Input
[
{
"rec_id": "FF5FD2A8331349F7BE8F4C62FBDBABAC"
}
]Action: Get All Product Catalogs
This action retrieves all product catalogs from Ivanti.
Action Input Parameters
This action does not require any input parameter.
Action: Update Service Request
This action updates the service request on Ivanti.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Urgency | Enter the urgency value to update the service request. Example: "Low" | Text | Optional | |
Owner | Enter the owner details to update the service request. Example: "exampleowner" | Text | Optional | |
Subject | Enter the subject to update the service request. Example: "Critical Service Request" | Text | Optional | |
Rec ID | Enter the Rec ID of the service request to update. | Text | Required | |
Extra Params | Enter the additional parameters to update service request. | Key Value | Optional |
Example Input
[
{
"rec_id": "E8016EF38214480186E6319E202276BC",
"urgency": "Low",
"extra_params": {}
}
]Action: Update CI
This action updates a CI on Ivanti.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
CI Type | Specify the configuration item type to update. Example: "ExampleConfigurationType" | Text | Optional | |
Name | Enter the name of the configuration item to update. Example: "ExampleName" | Text | Optional | |
Description | Enter the description to update the configuration item. Example: "ExampleDescription" | Text | Optional | |
IP Address | Enter the IP address of the configuration item to update. Example: "1.1.1.1" | Text | Optional | |
Rec ID | Enter the record ID of the CI to update the details. Example: "BA529D30394E4883893722C7817A9797" | Text | Required | |
Extra Params | Enter any additional parameters required to update the configuration item. | Key Value | Optional |
Example Input
[
{
"rec_id": "BA529D30394E4883893722C7817A9797",
"ip_address": "1.1.1.1",
"extra_params": {}
}
]Action: Create CI
This action creates a CI on Ivanti.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
CI Type | Enter the configuration item type. Example: "SampleConfigurationItem" | Text | Required | |
Name | Enter a name for the CI. Example: "ExampleName" | Text | Required | |
Created By | Enter the name of the user creating the configuration item. Example "anna" | Text | Required | |
Owner | Enter the owner's name for the CI. Example: "Robert" | Text | Required | |
Owner CI | Enter the owner team name of the CI. Example: "ExampleOwner" | Text | Required | |
Owner Team ID | Enter the valid ID for the owner's team. Example: "exampleTeam" | Text | Required | |
Owner ID | Enter the owner valid for the configuration item. Example: "1087342EA6954D7D96140D64B452E597" | Text | Required | |
Description | Enter the description for the CI. Example: "Sample Description" | Text | Required | |
Extra Params | Enter any extra parameters that you want to pass. | Key-Value | Optional |
Example Input
[
{
"name": "sample name",
"owner": "Alan.Taylor",
"ci_type": "Contract",
"created_by": "Admin",
"owner_team": "Service Management Team",
"description": "Sample Description",
"owner_valid": "1087342EA6954D7D96140D64B452E597",
"extra_params": {},
"owner_team_valid": "2E4BABD54FB9420D94F836F0D9B80C47"
}
]Action: Create Service Request
This action creates a new service request on Ivanti.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Profile Link Rec ID | Enter the profile link record ID from Ivanti. Example: "2F851094BFE5437C97D19871De1C539C7" | Text | Required | |
Subject | Enter the subject to add in the service request. Example: "Sample Subject" | Text | Required | |
Service Request TMPL Link | Enter the TMPL link for the service request to sort into categories. Example: "EBA0EEBF4D004EE1927BBAFF247F4DDE" | Text | Required | |
Created By | Enter the name of the user creating the service request. Example: "creatorname" | Text | Required | |
Symptom | Enter the symptom details of the service request. Example: "examplesymptom" | Text | Required | |
Owner | Enter the owner details for the service request. Example: "ExampleOwner" | Text | Required | |
Owner Team | Enter the owner team details for the service request. Example: "exampleownerteam" | Text | Required | |
Owner Team ID | Enter the valid ID for the owner team. Example: "8D796372096546AC9008C0EDAB18EE5F" | Text | Required | |
Owner ID | Enter the owner's valid ID for the service request. Example: "147098AD139247F6B177042064C5E39C" | Text | Required | |
Status | Enter the status of the service request. Example: "Active" | Text | Required | Allowed values:
|
Example Input
[
{
"owner": "Alan.Taylor",
"status": "Active",
"subject": "New",
"symptom": "This is a sample symptom",
"created_by": "Admin",
"owner_team": "Accounting",
"owner_valid": "147098AD139247F6B177042064C5E39C",
"owner_team_valid": "8D796372096546AC9008C0EDAB18EE5F",
"svc_req_tmpl_link": "EBA0EEBF4D004EE1927BBAFF247F4DDE",
"profile_link_rec_id": "2F851094BFE5437C97D19871De1C539C7"
}
]Action: Get All Service Request Templates
This action retrieves service request templates from Ivanti.
Action Input Parameters
This action does not require any input parameter.
Action: Get All Service Requests
This action retrieves service requests from Ivanti.
Action Input Parameters
This action does not require any input parameter.
Action: Get Service Request
This action retrieves details of a service request from Ivanti.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Service Request Number | Enter the service request number to get the details. Example: "10168" | Text | Required |
Example Input
[
{
"service_request_number": "10168"
}
]Action: Get CI Details
This action retrieves details of a Configuration Item (CI) from Ivanti.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
CI Rec ID | Enter the record ID to get the details. Example: "BA529D30394E4883893722C7817A9797" | Text | Required |
Example Input
[
{
"rec_id": "BA529D30394E4883893722C7817A9797"
}
]Action: Get All CI
This action retrieves the configuration items (CI) from the Ivanti Neurons ITAM application.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
Top | Enter the number of records to retrieve. Example: 20 | Integer | Optional | Default value: 25 |
Skip | Enter the number of records to skip. Example: 10 Skips the first 10 records and retrieves the 11th record and onwards. | Default value: 0 |
Example Request
[
{
"top":20,
"skip":10
}
]