We’re renaming ‘products’ to ‘apps’

Atlassian 'products’ are now ‘apps’. You may see both terms used across our documentation as we roll out this terminology change. Here’s why we’re making this change

Send audit log activities to another tool using webhooks

Establish a real-time streaming solution to automatically send audit log data to designated URLs of your choice.

Audit log webhook is a customized HTTP callbacks that trigger in response to audit log activities. When an activity occurs, the source system sends an HTTP request to the URL registered for the webhook in JSON format.

It’s important to know that webhook can be hosted or provided by any third-party tool. You should make sure that it’s appropriate for this data to be shared with your third-party tool before adding a webhhook.

Who can do this?
Role: Organization admin
Atlassian Cloud: Enterprise plan for Jira, Confluence or Jira Service Management or Atlassian Guard Premium.
Atlassian Government Cloud: Not available

How webhook works

Here is an example of how a webhook works:

  1. Identify and choose a third-party service or application that will process incoming webhook notifications (e.g., a logging tool or a custom API endpoint).

  2. Retrieve the URL from the selected tool which will receive audit log data.

  3. Navigate to webhook settings and register a new webhook by providing the URL obtained from the tool and an optional authorization header.

  4. When an action occurs within the Atlassian organization it triggers an associated audit log event.

  5. The newly generated log is sent to the registered URL. This transmission occurs asynchronously. Explore the structure and appearance of the payload

Add a webhook

You can't ads upto 3 webhooks for an organization.

To register a webhook URL:

  1. Go to Atlassian Administration. Select your organization if you have more than one.

  2. Select Security > Audit log.

  3. Select Settings.

  4. Select the Webhook tab.

  5. Select Add webhook.

  6. Enter a Name for the webhook.

  7. Enter the Webhook URL (the destination where you wish to receive real-time activity updates).

  8. Optionally enter secure authorization credentials to authenticate access to a protected resource. Encode the username and password as Authorization: Basic <credentials>.

  9. Select Add.

You can edit or remove a webhook if you need to.

Add a new webhook to audit log in atlassian Administration

Limitations

Webhook has the following limitations:

  • Retries: events will be retried up to three times before failing to send to the registered URL.

  • Ordering: event delivery is not guaranteed to be in chronological order. For example, Event B may be delivered before Event A, even if Event A occurred first.

  • De-duplication: events may be delivered more than once. Each event will have the same information and ID. You must implement their own de-duplication logic.

  • Service Level Objectives (SLOs): there are no public SLOs. No guarantees are provided regarding uptime or the delivery time of audit log.

Edit a webhook

To edit the details of a registered webhook:

  1. Go to Atlassian Administration. Select your organization if you have more than one.

  2. Select Security > Audit log.

  3. Select Settings.

  4. Under the desired webhook select More actions menu (⋯) .

  5. Select Edit from the dropdown.

  6. Update the details and select Save.

Alternatively, select Remove registration to remove a webhook.

Edit a webhook in audit log in Atlassian Administration

Test a webhook

This test evaluates your webhook's capacity to manage aggregated activities, which are sent with a brief delay to prevent the transmission of redundant updates.

  1. Go to Atlassian Administration. Select your organization if you have more than one.

  2. Select Security > Audit log.

  3. Under the desired webhook select Actions select () and select Test from the dropdown.

 

Still need help?

The Atlassian Community is here for you.