Subscribe to the feed

Red Hat Satellite provides webhooks to notify or perform an action when an event occurs. For example, webhooks can inform you of the completion of errata installation on Red Hat Enterprise Linux (RHEL) hosts (amongst many other events). The webhook mechanism helps integrate Satellite with applications such as Red Hat Ansible Automation Platform, Splunk and ServiceNow, to name a few.

What is a webhook?

In general, a webhook is an API call (or programmatic procedure/function) using the HTTP protocol. In Satellite, specific events can trigger the running of webhooks. Particular events can include creating a host, creating a new Satellite admin user account, or a remote execution job (and many others).

Diagram of a Satellite event completing, causing a webhook to fire

In the diagram above, a Satellite event or job completes, which causes a webhook to fire. This webhook performs an API call on an application across the network. Upon receiving the API call, the application performs another action, perhaps updating a dashboard or triggering an alert.

When a webhook is triggered, it runs against a preconfigured remote endpoint (such as Ansible Automation Platform, etc.). In other words, the webhook contains information about the remote endpoint, such as the URL and the event that triggered the webhook.

The webhook must be configured to speak to the API of the third-party application according to specifications defined by the third party.

Why wouldn’t we just get Satellite to send an email? You could very well do that, but the webhook allows you to do much more, enabling you to integrate Satellite events with third-party applications. As well, you wouldn’t have to read the email, and it’s easier to automate a response to an API call sent by a webhook.

What are errata?

Errata refers to the correction or update of a software package based on a security issue, bug, or the availability of a new feature. Satellite enables you to apply errata to RHEL hosts automatically in bulk.

An errata example

For example, if a new security vulnerability is discovered, like RHSA-2023:0832, you could use Satellite to apply the errata to resolve the vulnerability. After Satellite has completed the installation of the errata, Satellite can run a webhook to notify a secondary system of that event.

Below is a screenshot of a webhook sent from my test Satellite server, received by https://webhook.site, a webhook testing site. The webhook was fired after I installed the RHSA-2023:0832 errata.

Screenshot of a webhook sent from a test Satellite server

How to configure it

Navigate to the webhook menu

Click on “Administer” and “Webhooks”.

Screenshot of a Satellite menu with "Webhooks" highlighted

Create a new webhook

Click on “Create new.”

Screenshot of the Webhooks page with the "Create new" button highlighted

Select the feed

We’ll need to select a feed of Satellite events. The webhook will fire when an event from the chosen feed occurs.

  1. Click on “Subscribe to”.
  2. Select a feed. In this particular example, we’ll send webhooks whenever a remote execution run job has been completed.
Screenshot of the "Create Webhook" dialog
  1. Give the webhook a name.
  2. Give the webhook a target URL. In this example, I use webhook.site as an endpoint for a test.
  3. Select a template for capturing information contained in the event.
  4. Choose an HTTP method for executing the API call.
  5. Enable the webhook.
  6. Click “Submit” to save the webhook.
Screenshot of the General tab of the Create Webhook dialog

Test the webhook

Now we can test the webhook.

Click on “Test webhook”.

Screenshot of selecting the "Test webhook" option

Click “Submit”.

Screenshot of a "Test Errata Install Succeeded" dialog with the "Submit" button highlighted

If the webhook is configured correctly, we should see an event at webhook.site.

Screenshot of an event at webhook.site

Streamline Satellite management with webhooks

Webhooks can help you keep track of Satellite events, making it easier to automate processes and operations. As well, Satellite’s events and webhooks are also a source of information to audit patching in real-time to provide assurances that your infrastructure and applications are up to date. Satellite webhooks can be integrated into Event-Driven Ansible to drive automated event responses in your data center and cloud-based infrastructure.

Learn more


About the author

As a Senior Principal Technical Marketing Manager in the Red Hat Enterprise Linux business unit, Matthew Yee is here to help everyone understand what our products do. He joined Red Hat in 2021 and is based in Vancouver, Canada.

Read full bio
UI_Icon-Red_Hat-Close-A-Black-RGB

Browse by channel

automation icon

Automation

The latest on IT automation for tech, teams, and environments

AI icon

Artificial intelligence

Updates on the platforms that free customers to run AI workloads anywhere

open hybrid cloud icon

Open hybrid cloud

Explore how we build a more flexible future with hybrid cloud

security icon

Security

The latest on how we reduce risks across environments and technologies

edge icon

Edge computing

Updates on the platforms that simplify operations at the edge

Infrastructure icon

Infrastructure

The latest on the world’s leading enterprise Linux platform

application development icon

Applications

Inside our solutions to the toughest application challenges

Original series icon

Original shows

Entertaining stories from the makers and leaders in enterprise tech