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:

• Base URL: https://{AccountName}.samanage.com. See Find or change the account name.
• API Key Value: This value is used for Value when entering the API Keys parameters. See Collect API Token.

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.

Delete Ticket: Delete an incident.

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

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

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

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