Ivanti Neurons for ITSM - Create Incident

Ivanti Neurons for ITSM - Create Incident creates a new incident in your Ivanti Neurons for ITSM instance for:

• Assets returned by the selected query or assets selected on the relevant asset page.

Required Fields

These fields must be configured to run the Enforcement Action.

• Use stored credentials from the Ivanti Neurons for ITSM adapter - Select this option to use credentials from the adapter connection. By default, the first connection is selected.

  • When you select this option, the Select Adapter Connection drop-down becomes available. Select the adapter connection to use for this Enforcement Action.

    📘

    Note

    To use this option, you must successfully configure an Ivanti Neurons for ITSM adapter connection.

• Category - The category or classification of the incident (for example, Hardware, Software, Network).

• Description - A detailed description of the incident.

• Status - The status of the incident (for example, Logged, Open, In Progress).

• Compute Node - The Axonius node to use when connecting to the specified host. For more details, see Working with Axonius Compute Nodes.

Additional Fields

These fields are optional.

• Subject - The subject or title of the incident.

• Created By - The user who created the incident.

• Owner - The owner of the incident.

• Owner Valid - The valid owner ID or reference for the incident.

• Owner Team - The team that owns the incident.

• Owner Team Valid - The valid owner team ID or reference for the incident.

• Requestor Link RecID - The RecID of the requestor linked to the incident.

Connection Settings

⚠️

Connection and Credentials

When Use stored credentials from the adapter is toggled off, some of the connection fields below are required to create the connection, while other fields are optional.

• Host Name or IP Address - The base URL of your Ivanti Neurons for ITSM tenant. Must include the protocol prefix (https://). For example: https://yourtenant.ivanti.com

• REST API Key - The REST API Key created in Configuration Console > Security Controls > API Keys. This is the Reference ID of the API key.

• Verify SSL (optional) - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.

• HTTPS Proxy (optional) - Connect the adapter to a proxy instead of directly connecting it to the domain.

• HTTPS Proxy User Name (optional) - The user name to use when connecting to the server using the HTTPS Proxy.

• HTTPS Proxy Password (optional) - The password to use when connecting to the server using the HTTPS Proxy.

• Gateway Name - Select the Gateway through which to connect to perform the action.

APIs

Axonius uses the Ivanti Neurons for ITSM REST API - POST /api/odata/businessobject/incidents

Required Ports

Axonius must be able to communicate via the following ports:

• TCP port 443 (HTTPS)

Required Permissions

The following permissions and requirements are needed:

• The REST API Key must have write permissions to the /api/odata/businessobject/incidents endpoint.
• The API Key user role must have permission to create incidents in Ivanti Neurons for ITSM.

Version Matrix

This Enforcement Action was tested only with the versions marked as supported, but may work with other versions. Contact Axonius Support if you have a version that is not listed and it is not functioning as expected.

To learn more about Enforcement Actions, see Enforcement Actions.