• Documentation
    • Search documentation
    karat

    +

    K

    API Reference ↗
    Data connectivity & integrationData ConnectionListeners [Beta]Set up a Jira listener

    Set up a Jira listener

    This guide shows step-by-step how to configure a listener for Jira Cloud, to get a real-time feed of events from Jira to a Foundry streaming dataset.

    Learn more about Jira. ↗

    Prerequisites

    Prior to configuration, ensure:

    Instructions

    1. Create a WebHook in Jira. This can be done in the Jira admin panel by navigating to https://<your jira domain>/plugins/servlet/webhooks#. Visit public Jira documentation on webhooks ↗.

      Blank state for Jira system webhooks.

      Screen after selecting "Create a WebHook" option.

    2. Create a Jira listener in the Palantir platform. This will generate the listener URL that you need to copy and paste into the Jira URL field when creating a WebHook.

      a. You should also generate a message signing secret in Jira, and copy to the message signing secret in the Foundry listener configuration. You can also set up without a signing secret.

      Palantir new listener configuration page.

    3. Choose the set of Jira events that should be sent to your listener and then select Create. The screenshotted example shows subscription for the issue created, updated, and deleted events:

      Jira page showing new WebHook listener.

    4. Save the listener configuration in Foundry to proceed. Administrator approval is now required from the Information Security Officer. Review the toggle description.

    5. Select Start in the listener test screen to start your listener.

      Activating your listener in the Palantir platform.

    6. You will need to allow inbound traffic from the system that is pushing data to your Foundry enrollment. This can be done in Control Panel by an Information Security Officer for your Foundry enrollment. Documentation on managing ingress in the Palantir platform.

    7. Test the new configuration by making a change to trigger an event to your listener. You should see it appear in the incoming messages view in data connection, as well as in the underlying stream that the listener outputs to.

      Testing the listener within the Palantir platform with an event.

    You can now use this streaming data in Foundry pipelines, to put data into the ontology, or monitor using Automate to trigger effects in real time.

    All screenshots of Atlassian Jira® are provided for reference purposes only and are the property of Atlassian Corporation Plc.