Integrate Citrix Cloud Status Hub

Integrate with Citrix Cloud Status to get updates on incidents and maintenance schedules, which may impact some of the Citrix services.

Note

This integration is built for Citrix Cloud Status, but it can also be used for any other StatusHub subscription by changing the Base URL, and subscribing to the respective Webhook update service.

For a comprehensive list of out-of-the-box Citrix Cloud Status microapps, see Use Citrix Cloud Status microapps.

Add the Citrix Cloud Status integration

Follow these steps to set up the Citrix Cloud Status integration. The authentication options are preselected. Ensure that these options are selected as you complete the process.

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 Citrix Cloud Status tile.
  3. Enter an Integration name for the integration.
  4. Enter Connector parameters.
    • Leave the instance Base URL as-is.
    • Select an Icon for the integration from the Icon Library, or leave this as the default Citrix Cloud Status icon.
  5. Select Add.

The Microapp Integrations page opens with the Citrix Cloud Status integration and its microapps.

Citrix Cloud Status parameters

Set up the webhook listener

After you add the integration above, you need to set up the webhook listener.

Follow these steps:

  1. From the Microapp Integrations page, navigate to the Citrix Cloud Status integration and select the Edit from the menu.
  2. Select Webhook Listeners from the left-hand menu.
  3. Copy the URL you see. Either use a shortcut, or select the ellipsis menu and select Copy URL.

    Citrix Cloud webhook

  4. Navigate to https://status.cloud.com/subscribers/new and select Webhook.
  5. Paste the webhook listener URL in the Webhook URL field. Accept the terms & services and select Next.
  6. Select All services. If you want, for example, to subscribe separately for different regions, you can select Selected services, and then toggle Aggregate by groups.
  7. If you do not want to receive all updates for an incident, select the check box Only send me the minimum number of notifications per incident.
  8. Select Save to finish.

For more info about the synchronized entities, see Verify needed entities.

For more details of API endpoints and table entities, see Citrix Cloud Status connector specifications.

Use Citrix Cloud Status microapps

Existing Web/SaaS integrations come with out-of-the-box microapps. Start with these microapps and customize them for your needs.

Our Citrix Cloud Status integration template comes with the following preconfigured out-of-the-box microapps:

Incident: Receive Notifications for New Incidents and Incident updates. Also search for Incidents, and view their details.

Note

This microapp is mapped to the Webhook tables. It provides new incidents that occurred after adding the integration.

Notification or Page Use-case workflows
Incident - New (Notification) When a new Incident occurs, subscribed users receive a notification.
Incident - Changed (Notification) When an Incident is updated, subscribed users receive a notification.
Incident (Page) Provides a read only view of an Incident when the user clicks an Incident notification.
Incidents (Action Page) A table view with search and filter options for subscribed users to search for incidents in the events table (Webhook).
Incident Detail (Page) Provides a read only view of an Incident when the user clicks an Incident in the Incidents (Action Page).
Incident Update Detail (Page) Provides a read only view of an Incident update when the user clicks an Incident update in the Incident/Incident Detail page.

Maintenance: Receive Notifications for New Maintenance schedules added to the Calendar, and when the Maintenance window starts and ends. Also search for Maintenance schedules, and view their details.

Note

This microapp is mapped to the Webhook tables. It provides new maintenance schedules that were added after adding the integration.

Notification or Page Use-case workflows
Maintenance - New (Notification) When a new Maintenance is scheduled and added to the calendar, subscribed users receive a notification.
Maintenance - Started (Notification) When a Maintenance Window starts, subscribed users receive a notification.
Maintenance - Ended (Notification) When a Maintenance Window ends, subscribed users receive a notification.
Maintenance Schedules (Action Page) A table view with search and filter options for subscribed users to search for Maintenance schedules in the events table (Webhook).
Maintenance Detail (Page) Provides a read only view of a Maintenance when the user clicks a Maintenance notification or Maintenance in the Maintenance Schedules (Action Page).

Service Calendar: View all events (Incidents and Maintenance), and event details of a month (current and past).

Note

This microapp is mapped to the API tables. It provides the calendar for the current month (default). To open the calendar for a different month, select the month, and selecting Get Calendar (Service Action).

Notification or Page Use-case workflows
Service Calendar (Action Page) A table view with filters for subscribed users to search for Calendar events. The table lists the events of current month (default).
Calendar Event (Page) Provides a read only view of an Incident or Maintenance when the user clicks either in the Service Calendar (Action Page).
Incident Update Detail (Page) Provides a read only view of an Incident update when the user clicks an Incident update in the Calendar Event page.

Service Status: Receive Notifications for Platform Alerts (multiple Incidents at once affecting multiple Services), and get the current state of all services.

Note

This microapp is mapped to the API tables. It provides the latest status of services and if there is a platform wide alert (no history).

Notification or Page Use-case workflows
Platform Alert - New (Notification) When a new Platform Alert is raised, subscribed users receive a notification.
Platform Alert - Resolved (Notification) When the Platform Alert is taken down, subscribed users receive a notification.
Platform Alert (Page) Provides details of the Platform Alert, and the status of services.
Service Status (Action Page) Shows the current status of all the services - Up, Affected and Down.

Integrate Citrix Cloud Status Hub