Set up Jira Server / Data Center to connect with Airtable

Your Jira Server’s DNS name must resolve to an externally accessible IP address. If your Jira Server’s DNS name resolves to an IP address that is only accessible from a corporate intranet or VPN, you will need to make some DNS modifications.

There are two options we recommend:

1. Add a public DNS record that uses a different DNS name for external traffic. For example, if internal DNS re solves jira.company.com to the private IP of the JIRA server within the customer's network, one could create a public DNS record that points jira-ext.company.com to the public IP of the customer’s network firewall. One way to do this is to set up a network load balancer that listens on a particular port and redirect the request to internal IP addresses that internal DNS records point to.

2. Configure your DNS server to resolve the same DNS name for internal and external traffic. You want your DNS server to resolve jira.company.com to one IP for internal traffic and another external IP for external traffic.

Your Jira Server must be accessible via HTTPS using a certificate issued from a well-known credible certificate authority to ensure a secure connection between Airtable and your Jira Server. Jira has already built out their own documentation to help guide you through the steps necessary to ensure this is the case for your Jira server:

• Running Jira applications over SSL or HTTPS

• Configuring security in the external environment

• Proxying Atlassian server applications with Apache HTTP Server (mod_proxy_http)

• OAuth Troubleshooting Guide: OAuth Signature Rejected

Your Jira Server REST API must be accessible from Airtable. If your Jira Server is behind a firewall, then you need to configure your firewall to accept incoming API requests from Airtable. To allow Airtable access while still restricting other external traffic from accessing your Jira Server, add the static IP addresses listed in this article to the allowlist in your firewall.

The Airtable sync integration runs in the cloud and needs to make connections from the internet to reach your Jira Server using Atlassian’s REST API. Jira Server REST API endpoints are on a separate path from the Jira User interface and login pages. You may wish to restrict Airtable’s access to the following endpoints that are used by Jira Server REST API:

• https://<jira_server_base_url>/rest/*

• https://<jira_server_base_url>/plugins/*

To create a Jira Server configuration and generate the Consumer and Public key for Jira Application Link:

1. Visit your admin panel.

2. Click Settings, then  Integrations & development. 

3. Click the arrow next to Configure integrations. 

4. Click Add configuration. 

   1. This will open up a form where you can fill in the configuration name and URL of your Jira server.

5. Enter the requested information and click Save.

In the steps below, we will walk you through setting up the Application Link in Jira. If this is your first time working with App Links, then we recommend also checking out their documentation.

1. Sign in to your Jira Server/Data Center instance with Jira Administrator permissions.

2. Choose “Administration (  ) > Applications” and select “Application Links” in the left menu.

3. In the “Enter the URL of the application you want to link” field, enter https://app.airtable.com, and then click “Create new link.” You may be prompted with one of the following messages. You can ignore these messages and click Continueto leave the new URL as is.

   • No response was received from the URL you entered.

   • The supplied Application URL has redirected once. Please check the redirected URL field to ensure this is a URL that you trust. 

4. In the "Create Link" form, select "Atlassian Product" for the "Application type" single select radio button field. Although Airtable is not an Atlassian Product, this is the only way to make Jira Server configure the application link with OAuth 1.0 (supported by Airtable) instead of OAuth 2.0 (not supported by Airtable currently).

5. On the first screen of the “Link applications” dialog:

   • In the Application Name box, type Airtable.

   • For Application Type, accept the default value of Generic Application.

   • Check the Create incoming link checkbox.

   • Leave the rest of the fields empty. 

6. On the next screen of the Link applications dialog, use the Consumer key and Public key you get from Airtable. Put Airtable for Consumer name.

7. Click Continue. Your application link will be created.