Microapps

Integrate Ivanti

Deploy the Ivanti integration to submit and monitor incidents, service requests, and take action through Citrix Workspace. It also provides microapps for higher tier agents with the ability to review incidents. This integration creates requests using a delegated model that performs the action for incidents on behalf of the user. Service requests are implemented through deep links to Ivanti and allows users to create their own requests.

Note:

We want your feedback! Please provide feedback for this preview integration template as you use it. For any issues, our team will also monitor our dedicated forum on a daily basis.

Review prerequisites

A user account with global admin rights must be created with the last name tenant and the first name defined as the TenantID of your Ivanti implementation. See Create service account.

You need these artifacts to add the integration in Citrix Workspace Microapps:

  • Base URL: https://{TenantID}.trysaasit.com/api/odata/businessobject/
  • TenantID: Find your TenantID using this model: https://{TenantID}.trysaasit.com.
  • Token: The token permits API access. See Collect access token.

Create user account

This account must be created with:

  1. Enter the TenantID of your Ivanti implementation in the field: First Name. Find your TenantID using this model: https://{TenantID}.trysaasit.com
  2. Enter the string tenant in the field: Last Name.

Collect access token

Follow this process to obtain an access token. This access token is valid during its lifetime or until a new access token is requested.

  1. While logged in to your Ivanti instance as an administrator, select the setting icon (wrench) in the upper right corner of the screen.
  2. Select Security Controls in the left navigation menu, and select API Keys.
  3. Select “Add Key Group.
  4. Enter a Name and a Description for the group, and select Save Key Group. Let’s call our group WSi Citrix.
  5. Select the newly created WSi Citrix Key Group and select Add API Key.
  6. Set On Behalf Of to Administrator Role. Set In Role to Administrator. Select Save Key.
  7. Copy the Key to be used as the token when you set up this integration.

Add the integration to Citrix Workspace Microapps

Add the Ivanti integration to Citrix Workspace Microapps to connect to your application. The authentication options are preselected. Ensure that these options are selected as you complete the process. This delivers out-of-the-box microapps with pre-configured notifications and actions that are ready to use within your Workspace.

Follow these steps:

  1. From the Microapp Integrations page, select Add New Integration and Add a new integration from Citrix-provided templates.
  2. Choose the Ivanti tile.
  3. Enter an Integration name for the integration.
  4. Enter Connector parameters.
    • Enter the instance Base URL:
    • Select an Icon for the integration from the Icon Library, or leave this as the default icon.

    Connector parameters

  5. Under Service Authentication, select API Keys from the Authentication method menu and enter the token value that you collected in the Value field. API Keys ensure that your integration meets the maximum security compliance.

    Connector parameters

  6. Leave the Enable request rate limiting toggle as disabled.
  7. (Optional) Enable Logging toggle to keep 24 hours of logging for support purposes.
  8. Select Save to proceed.

    Connector parameters

The Microapp Integrations page opens with your added integration and its microapps. You are now ready to set and run your first data synchronization. For complete information about synchronization rules, synchronization that does not meet its schedule and veto rules, see Synchronize data.

For more details of API endpoints and table entities, see Ivanti connector specifications.

Use Ivanti microapps

Our Ivanti integration template comes with out-of-the-box microapps. Start with these microapps and customize them for your needs.

Agent Incidents: Self-service to manage incidents by an Agent. Subscribers must have agent access to Ivanti or resolutions will fail.

Notification or Page Use-case workflows
Incident Status Change notification When the status of an incident changes, the owner receives a notification with a link to incident details.
New Incident notification When a new incident is created, the owner receives a notification with a link to incident details.
Resolution Target Breached notification When an incident breaches the resolution target, the owner receives a notification with a link to incident details.
Response Target Breached notification When an incident breaches the response target, the owner receives a notification with a link to incident details.
Incident Detail page View details of an incident with an option to add a note and Resolve Incident.
My Incidents page Provides a list of incidents assigned to a user with a link to incident details.

Create from Service Catalog: Create a service request based on the title of the microapp by using a deep link back to the self-service module of Ivanti.

Notification or Page Use-case workflows
Create Service Request page Provides a form to create a new service request with a searchable service list from the service catalog.

Create Incident: Report a new incident in Ivanti. This is a quick create that can be submitted without an owner.

Notification or Page Use-case workflows
Create Incident page Provides a form to create an incident.

My Incidents: Self-service for my incidents.

Notification or Page Use-case workflows
My Incident has Breached its Resolution Target notification When a user’s incident breaches the resolution target, they receive a notification with a link to incident details.
My Incident has Breached its Response Target notification When a user’s incident breaches the response target, they receive a notification with a link to incident details.
My Incident Status has changed notification When the status of a user’s incident changes, they receive a notification with a link to incident details.
My New Incidents notification When a new incident is logged for a user, they receive a notification with a link to incident details.
Incident Detail page View details of an incident with an option to Resolve Incident.
My Active Incidents page Provides a list of incidents assigned to a user with a link to incident details.

My Service Requests: View existing service requests containing deep links to view the dynamic templates associated to the request.

Notification or Page Use-case workflows
New service request notification When a new service request is submitted, the user receives a notification with a link to service request details.
Service Request Status Change notification When the status of a service request changes, the owner receives a notification with a link to service request details.
My Service Requests page Provides a list of service requests assigned to a user with a link to incident details.
Service Request Detail page View details of a service request with an option to add a note and Open Service Request.

Quick Service Request: Quickly create common service requests.

Notification or Page Use-case workflows
Quick Service Request List page Provides a form for submitting common service requests, such as Request Equipment, Request Computer, Reset Password, and Request Access.
Integrate Ivanti