Service Manager powered by HEAT

Home 

Ivanti Automation Integration

Ivanti Automation (IA) Integration enables ISM customers to create requests for everyday manual tasks like Account Unlock, Reset Password, and Provisioning Computers. Using the integration of ISM with IA can automate such tasks that does not require any manual IT intervention.

Prerequisities

The AM connector should be used to create the Ivanti Service Manager General task to do the following:

  • Update status of pending automation job in ISM
  • Return data from ivanti automation to ISM
  1. Ivanti Automation

The Ivanti Automation, version 2018.1.1 needs to be installed in one of the computers with all the necessary components such as Console, at least one dispatcher, and an agent.

  • The Dispatcher API is disabled by default. You can enable it by enabling the global setting WebAPI state (at Setup > Global Settings > Dispatcher WebAPI section) or the setting on Dispatcher-level (Topology > Dispatchers > Settings > Dispatcher WebAPI section).
  • When using the Dispatcher Web API in your Ivanti Automation environment, it is also possible to secure communication using HTTPS.

Configuring IA Connector

  1. Save both files to AM server.
  2. Go to Ivanti Marketplace and search for Ivanti Service Manager Incident connector (https://marketplace.ivanticloud.com/Tools/Importer).
  3. Open and download the Ivanti Marketplace Solution installer.exe.
  4. When prompted browse to the location of the connector installer. It has a .nupkg extention.
  5. Follow the wizard steps.
  6. You may need to close and reopen AM to see the Ivanti Service Manager General task.
  1. Windows Powershell: The Ivanti Automation (IA) environment should have at least Power shell 5.0 version installed.

Visit the Ivanti Marketplace to download the latest Ivanti Service Manager connector for Automation that contains the Ivanti Service Manager General task.

The following configurations are necessary for successful automation of service requests.

Configuring IA

  1. Log in to the Ivanti Service Manager and select your role as an Administrator.
  2. Navigate to MORE..., and under My Workspace, select the Ivanti Automation Configuration workspace.

The Ivanti Automation Configuration workspace will be displayed with default values.

a. Host. Base URL to access the IAT Server.
b. Username. Username that is used to access the IAT Server.
c. Password. Password that is used to access the IAT Server.
d. Authentication. Type of authentication to connect the IAT Server.
e. Primary Host: Option to be selected, if it is a primary host for the IAT Server.
  1. Update the configuration details.
  2. Click Save to save the configuration details would be saved.

Configuring and Syncing Runbooks

In IAT, you can create and configure specific tasks by creating separate modules. These modules are included in Runbooks, which can carry out the set of tasks that are needed to be executed for routine IT tasks.

Runbooks that have been created should contain defined parameters in IAT such as:

  1. ISM_TransactionID: RecordID of the Ivanti Automation Transaction Record which will be sent by ISM.
  2. P_Status: Job status that need to be sent back to ISM using FRSHeatIntegration API’s of ISM by executing the powershell script.
  3. Ivanti Service Manager Password: Password to connect to the ISM Server.
  4. Ivanti Service Manager Tenant: Tenant that must be connected.
  5. Ivanti Service Manager Tenant URL: URL of the ISM Server that must be connected.
  6. Ivanti Service Manager UserName: Username to connect to the ISM Server.

The list of parameters required will differ, depending on the selected Request Offering.

Once Runbooks have been created with the above parameters, they must be synced with ISM by completing the following steps:

  1. Log in to the Ivanti Service Manager and select your role as an Administrator.
  2. Click the configuration icon .
  3. In the left-hand pane, go to Integration Tools and then select Web Service Connections.
  4. Scroll down to IVNT_Automation_Runbooks and select the Edit icon .
  5. Follow the steps to run the Integration process and select Next after each step. Once you are done, select Publish.

You can also schedule this to run every day/hours by defining the schedule entry.

Verifying the Synced Runbooks

  1. Leave the Configuration UI page and open the Request Offering workspace.
  2. Click Account Unlock.
  3. Select the Plan Request FulFillment Tab.
  4. Double-click the Ivanti Automation block in the workflow.

The Ivanti Automation Block Properties dialog box opens.

  1. The Value drop-down list will show all the Runbooks that have been created.
  2. Select the appropriate Runbook for this particular task and click Save.

Configuring Ivanti Automation Block Properties

  1. Log in to the Ivanti Service Manager and select your role as an Administrator.
  2. Navigate to MORE..., and under My Workspace, select the Request Offering workspace.
  3. From the list available, select the desired Request Offering.
  4. Select the Plan Request Fulfillment tab.
  5. From the Fulfill as: list, the Workflow option is selected by default.
  1. Navigate to Integration, and then double-click the Ivanti Automation block in the workflow.

The Ivanti Automation Block Properties dialog box opens.

  1. Depending on the Runbooks created in the Ivanti Automation Tool, add or edit the required parameters. For example, for account unlock, only the p_username parameter is required.

  1. Click Save to save the parameters.
  2. Click Save on the page to save the entire request offering.

Troubleshooting

Ivanti Automation Transaction - This business object logs all the transactions that has been carried out particular to this automation tool. This provides the status of the job and logs related to a particular transaction.

Viewing the Integration Log

To view the details of the processed job, you can view the Integration Log workspace.

  1. Log in to the Cloud Service User application in the Administrator role.
  2. Open the Integration Log workspace.
  3. To open the workspace, click the and select More > Integration Log.
  4. From the Integration Log workspace, view the information in the columns for the list of logs or open a record to view details.

Viewing the Integration Queue

While the job is being processed, you can view the record from the Integration Queue workspace.

After the job is processed, the record will not be available from the Integration Queue workspace. You can then

view it from the Integration Log workspace.

Log in to the Cloud Service User application in the Administrator role.

  1. Open the Integration Queue
  2. To open the workspace, select More > Integration Queue. The workspace will be empty when there are no records to process.
  3. When the record appears in the Queued Status in the Integration Log workspace, then the record appears while it is being processed in the Integration Queue workspace.

Was this article useful?    

The topic was:

Inaccurate

Incomplete

Not what I expected

Other