Jira

Get started with the Jira source!

Obtain the OAuth Credentials

If you need to figure out how to access the necessary credentials, head here for a detailed walk through.

Enable the Source

First, you must decide which flow you would like to add your Jira source.

35823582

Once you have decided on a flow, let's start by enabling the Jira source.

35823582

You will then be asked to provide your specific Jira OAuth Credentials. Go ahead and fill these in and click Save. If you do not know where to find these credentials, you can head here for a detailed walk through.

35823582

You will now be asked to sign in with your Jira account. Go ahead and login.

35823582

You will then be asked to confirm that the OAuth app should have access to your account. Click Accept.

35823582

Once you have signed in, you will then be asked to provide your Jira site name. Input that here. If you don't know where to find your site name, it should follow the format sitename.atlassian.net when you log in to Jira.

35823582

You have now connected your Jira account!

Configure Mapping

You now have added Jira as a data source for your flow.

35823582

Next, you need to configure the mapping for your Jira data. Click on the Jira card to get started.

35823582

Now you can need to open the Field Map Editor. Do so by clicking the corresponding icon.

35823582

You can now select specific streams and/or tables that you want to pull from each Jira account. To edit the exact objects you want to pull, use the corresponding gear icon.

35823582

For any of the fields you do want to pull, go ahead and select them now. I am going to use the the select all option at the top of the column.

35823582

Once you are done mapping any of the fields you want, use the arrow button in the middle to move those objects over to the Chosen column.

35823582

Once you have finished picking which fields you want to pull, click the Confirm button in the bottom right corner.

35823582

You should repeat the previous process until you have selected all the fields you want to bring in. Once you are done with all your selections, click the Save button.

Obtain your Jira OAuth Client ID and OAuth Client Secret

The first thing that you need to do to get your Jira OAuth credentials is to login in to Jira's Developer console. If you do not have a Jira account, you can create a free one here.

35823582

Now that you have logged into Jira, you need to actually head the developer console. Your home page should look similar to this. Head to top right hand corner of the page and click on the icon with your initial in it.

35823582

Creating the app

Now from the resulting drop down, you should click the Developer console tab.

35823582

You should now be on this page. To create an OAuth app, click on the Create button on the right side of the screen.

35823582

When it asks you what kind of app you would like to create, make sure to select the OAuth 2.0 integration option.

35823582

On this page, you should go ahead and name your private app as your company name, not hotglue. Remember, this is the app your customers will be seeing when they are connecting their Jira account to your platform. Once you are done inputting your app name (and agreeing to the Atlassian developer terms), click create.

Configuring Permissions

35823582

On this page, you have the ability to edit the details of your application. The first thing you should do is head to the Permissions section of your app.

35823582

On this page, you can configure the scopes of your OAuth app. Go ahead and click Add on any of the scopes you would like to enable.

35823582

As you can see here, I have added some scopes to my app. It is important that you go in and configure each API in order to make sure the permissions you want are set. For this example, let's do this with the Jira platform REST API.

35823582

When you add the scopes for the Jira platform REST API, it defaults to just enabling the View user profiles permission. Since I want to be able to read into issue data, I am also going to add the View Jira issue data scope.

Note: If you are only going to use this app to read data from Jira, you will only need to check scopes that can View objects in Jira. If you are also planning on writing data to Jira, you should add the Create/Manage scopes as well as the View scopes.

35823582

Once you are done configuring the scopes, you can go ahead and head back to your app.

Getting the credentials

Now it is finally time to grab your credentials.

35823582

Head into the App details section of your app.

35823582

At the bottom of this page, you can access your credentials! Take these and put them in hotglue.