Microapps

Integrate SolarWinds

Integrate with Solarwinds to submit and monitor tickets, service requests, and take action through Citrix Workspace. Higher tier agents have the ability to update tickets and service requests.

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

For comprehensive details of the out-of-the-box microapp for SolarWinds, see Use SolarWinds microapps.

Review prerequisites

These prerequisites assume that the administrator is part of the SolarWinds integration set up of the organization.

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

Note:

We recommend that you always use OAuth 2.0 as your service authentication method where available. OAuth 2.0 ensures that your integration meets the maximum security compliance with your configured microapp.

User account

The integration requires regular access to your SolarWinds instance. We recommend creating a dedicated user account with the following permissions:

  • ROLE: Administrator

Collect API Token

The SolarWinds administrator needs to collect an API Key token. You enter this in the field Value when entering the API Keys parameters.

  1. Log in to SolarWinds Customer Portal using an account with account administrator access.
  2. On the left side of the screen navigate to Setup > Users & Groups > Users.
  3. Select the user name with the administrator role that will be used for the integration.
  4. Next to JSON Web Token, select Show Token.
  5. Copy and save the token value for later use as the API Key Value when configuring the integration, as shown in the next section.

Find or change the account name

To find or change your account name, follow these steps.

  1. Log in to SolarWinds Customer Portal using an account with account administrator access.
  2. In the user menu in the top-left corner of the screen, select My Account.
  3. Copy or assign a value for Account name. This value will be used for the base URL: https://{AccountName}.samanage.com

Add the integration to Citrix Workspace Microapps

Add the SolarWinds 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 which 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 SolarWindsn 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.
  5. Under Service Authentication, select API Keys from the Authentication method menu. API Keys ensure that your integration meets the maximum security compliance.

    1. Header is selected for API Keys Method and X-Samanage-Authorization is entered for Name.
    2. For Value, enter the API Key Value that you collected earlier.
  6. Leave the Service Action Authentication toggle as disabled.
  7. Leave the Request rate limiting toggle as disabled.
  8. Leave Request timeout empty.
  9. (Optional) Enable Logging toggle to keep 24 hours of logging for support purposes.
  10. Select Save to proceed.

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 SolarWinds connector specifications.

Use SolarWinds microapps

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

Create Ticket: Create a new incident.

Notification or Page Use-case workflows
Create Ticket page Provides a form to create a new ticket.

Delete Ticket: Delete an incident.

Notification or Page Use-case workflows
List Tickets page Provides a summary of all tickets requested by the user.
Ticket Details page Provides a detailed page of a ticket and option to delete it.

My Assigned Tickets: View assigned tickets to update them and/or to change its status if needed.

Notification or Page Use-case workflows
Assigned Ticket Created notification When a new assigned ticket is created, the assignee receives a notification.
Assigned Ticket SLA Thresholds Hit notification When an SLA threshold is hit, the assignee receives a notification with details.
Assigned Ticket Status Changed notification When the status of a ticket changes, the assignee receives a notification.
My Assigned Tickets page Provides a summary of all assigned tickets assigned by the user.
Ticket Details page View details of a selected ticket with options to Edit Ticket the ticket and Add comment.
Ticket SLA Details page View SLA details of a ticket.
Update Ticket / Change Status page View and modify details of a ticket selected from the notification, with an Update Ticket option.

My Open Tickets: Allows the user to see his requested incidents and update them if needed.

Notification or Page Use-case workflows
Ticket Created notification When a new ticket is created, the requester receives a notification.
Ticket SLA Thresholds Hit notification When an SLA threshold is hit, the requester receives a notification with details.
Ticket Status Changed notification When the status of a ticket changes, the requester receives a notification.
My Open Tickets page Provides a summary of all assigned tickets assigned by the user.
Ticket Details page View details of a selected ticket with options to Edit Ticket and Add comment.
Ticket SLA Details page View SLA details of a ticket.
Update/Close Ticket page View and modify details of a ticket selected from the notification, with options to Update Ticket and Resolve Ticket.

My Open Service Requests: Allows the user to see his service requests and update them if needed.

Notification or Page Use-case workflows
Service Request Created notification When a new service request is created, the requester receives a notification.
Service Request SLA Thresholds Hit notification When an SLA threshold is hit, the requester receives a notification with details.
Service Request Status Changed notification When the status of a service request changes, the requester receives a notification.
My Service Request page Provides a summary of all open service requests that are requested by the user.
Service Request Details page View details of a selected service request with options to Update Serviec Request, Open Service Request, and Add comment.
Service Request SLA Details page View SLA details of a service request.
Update/Close Service Request page View and modify details of a service request selected from the notification, with options to Update Service Request and Resolve Service Request.

Service Catalog Request: Search for a service catalog item by name or create common service requests quickly.

Notification or Page Use-case workflows
Create Service Request Provides a form to search for a service catalog item by name, and create a request for it, or use Request Service deeplink to create common service requests quickly.
Integrate SolarWinds