Skip to main content
All CollectionsIntegrationsJira integration
How to set up Jira Server integration with StoriesOnBoard
How to set up Jira Server integration with StoriesOnBoard

Learn more about the process of setting up Jira Server integration with StoriesOnBoard.

Tamás Párványik avatar
Written by Tamás Párványik
Updated over a week ago

Contents:

StoriesOnBoard & Jira integration overview

Integrating your story map with a Jira project allows teams to plan more effectively, utilizing the visual power of story mapping to achieve transparency and shared understanding among stakeholders. Bring the team around to the story map to see the big picture and take advantage of real-time and bidirectional sync with Jira to keep everyone up to date at all time. The integration makes it possible to plan releases on the story map and push cards to Jira for execution and keep your backlog in sync.With the powerful integration between StoriesOnBoard and Jira you can build and manage amazing products from the very beginning. This allows to do product discovery with user centric approach to build great products that users love.

Who can setup the Jira integration

You must have Admin role on the story map on StoriesOnBoard to be able to setup the integration with Jira. On the Jira side you must hold Admin rights as well.

How to set up Jira Server integration

  1. Click on your user menu

  2. Select the "Jira integration settings" option

  3. Select the "Jira Server" option

  4. Enter the Jira instance URL

  5. Configure an Application link

    1. Option 1 - Create a new app link

    2. Option 2 - Use an existing app link

  6. Set up the webhook

    1. Option 1 - Automatic webhook configuration

    2. Option 2 - Manual webhook configuration

  7. Connect you story map to the Jira project

Step-by-step guide to set up Jira Server integration

Navigate to your settings then select "Jira integration settings".

Proceed with the "Jira Server" option.

Enter your Jira instance URL then proceed the next step.

In the nest step you must configure the application link to take advantage of the integration.

Setting up an application link with Jira

For a two-way synchronization, you must set up an application link between Jira and StoriesOnBoard. An application link is a trusted relationship between StoriesOnBoard and JIRA. You will need a user with an Administrator role in Jira for this setup.

If you are integrating with an on-premise Jira instance, you may need to whitelist StoriesOnBoard in your firewall so it can make connections to your Jira server.

StoriesOnBoard is using the following IP addresses for the connections:

54.88.136.216 and 54.84.188.199.

In order to finalize the integration with Jira server you must have an active application link configured. There are two options:

  • create a new application link

  • use an existing application link

How to create a new application link

To create a new application link select the "New app link" option.

In the nest step you need to open the Jira Application settings. You will need to copy the StoriesOnBoard URL.

Once you opened the Application settings in Jira, select the "Create link" option.

Now you need to paste the copied StoriesOnBoard URL to the Application URL field and click on "Continue".


If a popup window “Configure Application URL” appears with the error message “No response was received from the URL…”, then just click Continue (it’s normal).


Go back to StoriesOnBoard and proceed the next phase as following.


In the nest step, you need to copy the Application name from StoriesOnBoard as below.


In Jira paste the copied Application name into the "Application Name" field and make sure you enabled the "Create incoming link" option as well. Then select "Continue".


Now your new Application link will appear in the list and select the three dots menu and choose "Edit".


Then go back to StoriesOnBoard and select "Continue" to proceed the next step.

You will need to copy the "Consumer Key and Consumer Name" value which is "StoriesOnBoard". You will also need to copy the Public Key as well.


Paste into Jira the copied "Consumer Key and Consumer Name" value which is "StoriesOnBoard".

Then select the "Incoming Authentication" tab and paste the copied Public Key from StoriesOnBoard into the Public Key field and save your settings.

Now StoriesOnBoard is able to connect to Jira with OAuth, which means you don’t need to give your Jira password to StoriesOnBoard.

Go back to StoriesOnBoard and click on "Continue".

In the next step, you have two options for setting up a webhook:

  • Option 1 - Automatic webhook configuration

  • Option 2 - Manual webhook configuration

🤖 Automatic webhook configuration for Jira

If you want to proceed with the automatic webhook configuration, select the "Automatic Setup" option.

Once the webhook is configured, you can move forward to create your story map and connect it to your selected Jira project by following these steps on the story map:

If you wish to setup your webhook manually, keep follow our guide below.

Manual webhook configuration for Jira

You will need to create a webhook and follow the instructions on your screen as below:

You will see the following screen where you will find the instructions.

To setup the webhook manually, open Jira's Webhook management here.

Proceed with the "Create a webhook" option.

Copy the [ Name ] and [ URL ] from StoriesOnBoard and paste it into the relevant webhook fields in Jira.

Then scroll down to find the "Issue related events" section and enable the following fields:

  • created

  • updated

  • deleted

Then scroll further down to find the "Project related events" section and enable the following fields:

  • created

  • updated

  • deleted

To complete the webhook configuration select "Create" at the bottom of the screen.

If the webhook is successfully created in Jira, select the "Enable integration" option.

You will land on the following screen:

Now you are ready to move forward to create your story map and connect it to your selected Jira project by following these steps on the story map:


Learn more about:

Did this answer your question?