Microsoft Teams for Jira Server documentation


To start using Microsoft Teams for Jira Server, you need to install both of the following apps:

  • Jira Server app in Microsoft Teams (installed from Microsoft Teams Apps menu)
  • Microsoft Teams for Jira Server in your Jira instance (installed from Atlassian Marketplace)

Note: Jira Server connector doesn’t require Jira app (add-on) installation, it should be configured manually by Jira administrator.

App 1: Installing into Microsoft Teams

Before you begin

Here are the prerequisites for installing this app:

  • Microsoft Office 365. It should be Office 365 with Business license or Enterprise Office 365. Your IT admin also has to enable Microsoft Teams in Office 365.
  • Allow external apps in Microsoft Teams for Office 365 should be set to On. Your IT admin has to enable it in the Admin center by going to Settings > Services & add-ins > Microsoft Teams > choose Apps > Allow external apps in Microsoft Teams > On. Note that after enabling the external apps in Office365, synchronization may take several hours.

Steps

  1. In your Microsoft Teams, go to “Apps” menu in bottom-left corner. 
  2. Search for “Jira Server”.
  3. Click the tile and follow the installation dialog. 

The installation provides the following capabilities within Microsoft Teams:

  • Connector
  • Messaging Extension
  • Bot
  • Team and personal tabs

Connector

Connector provides one-way communications from Jira Server to Microsoft Teams via webhooks. You can add connector to your Microsoft Teams channel from the channel menu:

On the connector configuration page, you will see the instructions and the webhook URL. Following the instructions, you need to create a webhook from your Jira Server instance. This can be done from “Administration” → “System” → “Webhooks”. Paste the webhook URL from connector configuration into Jira webhook and save. Finish by adding the connector in Microsoft Teams. You should receive a channel notification from connector telling that the connector has been added.

Jira ID

Jira ID is a unique identified that is generated after installing Microsoft Teams for Jira Server on your Jira instance. If this app is installed and you have the admin permissions, you'll see the Jira ID at the bottom of the app's configuration page. If you don't have the right permissions, contact your Jira admin to provide you with the Jira ID.

Messaging Extension

You need to have the Microsoft Teams for Jira Server app installed in your Jira instance for this capability to work.

All your messaging extensions can be open from the bottom of the compose box. There are some native messaging extensions, such as Emoji, Giphy, and Sticker. Choose the More Options (...) button to see Jira Server and other messaging extensions. You can also pin Jira Server messaging extension so that you don’t have to select it from options menu every time.

Once you open the messaging extension, click “Sign In” to connect to your Jira instance. You will be asked to provide Jira ID.

When you paste the correct Jira ID, your next step will be to enter your Jira login credentials for authentication. After that, in the messaging extension you should see the search field and the list of recent issues from Jira. You’re all set!

Bot

Bot is another capability of Microsoft Teams. The Jira Server bot will be your personal assistant when working with Jira.

To start your interaction with the bot, click “Open” in front of “Bot” on installation screen, or simply search “Jira Server” in your main search area of Microsoft Teams at the top, and open Jira Server Bot.

To see which commands are available for you, type “help” in your conversation with the bot.

For most of the commands, the bot will ask you to authorize in Jira. To do that, you need to enter the “connect” command and following the dialog, paste your Jira ID and login credentials.

Team and personal tabs

Jira Server tab capability lets you pin your team’s backlog to your channel so that all the team members can see and manage it directly from Microsoft Teams.

There are also pre-defined personal tabs available in your Jira Server app, where you can quickly navigate to issues assigned to you, reported by you, or your issues report with your custom filter applied.

In order to see and interact with the tab, you or your teammates will be asked to authorize in Jira. This can be done by clicking the “Sign in” button on the tab and follow the dialog.

App 2: Installing into Jira

To install the Microsoft Teams for Jira Server app in your Jira instance, you need to be a Jira administrator.

  1. Go to Administration > Applications.
  2. Select Application links.
  3. In the link form, enter https://jira-server.msteams-atlassian.com/, and click Create new link.

    You might see a warning saying that "No response was received from the URL you entered". Ignore it, and click Continue.

  4. On the first screen of the Application link:
    1. Enter Microsoft Teams as the Application Name.
    2. Select the Create incoming link checkbox.
    3. Click Continue. 

  5. On the next screen, enter the following consumer details:
    1. Consumer key: OauthKey
    2. Consumer name: MicrosoftTeamsIntegration
    3. Public key: You can copy it from the app's configuration screen. It looks like the following example: 
  6. On next screen of the Link applications dialog, enter the following consumer details:
    • Consumer key enter "OauthKey" as a value
    • Consumer name enter "MicrosoftTeamsIntegration" as a value
    • Public key which you can copy from app (add-on) configuration screen in a box. Use the following example:
  7. Click Continue. You should now have an application link that looks like this: 

Now, once the configuration is set, you should see the following Jira ID at the bottom of the configuration screen:

The Jira ID will be requested from Microsoft Teams users during authentication. Share this ID with your users.

Configuring firewall

Jira Server for Microsoft Teams uses multiple Microsoft Azure services behind-the-scenes, and they must be reachable from your network. Despite the user’s location, all of the following IP/hosts should be whitelisted:

Jira Server for Microsoft Teams (App 1) uses multiple Microsoft Azure services behind-the-scenes, and they must be reachable from your network. Regardless of the user's location, all of the following IP/hosts should be allowlisted:

  • Web application backends (https://jira-server.msteams-atlassian.com and https://connectors.msteams-atlassian.com/) are hosted on Azure App Service. You may find IP details for whitelist from official source here. You may also copy Azure App Service IPs from the expanded list below and paste them during firewall configuration:

    Azure App Service IPs

    "13.64.73.110/32",
    "13.65.30.245/32",
    "13.65.37.122/32",
    "13.65.39.165/32",
    "13.65.42.35/32",
    "13.65.42.183/32",
    "13.65.45.30/32",
    "13.65.85.146/32",
    "13.65.89.91/32",
    "13.65.92.72/32",
    "13.65.94.204/32",
    "13.65.95.109/32",
    "13.65.97.243/32",
    "13.65.193.29/32",
    "13.65.210.166/32",
    "13.65.212.252/32",
    "13.65.241.130/32",
    "13.65.243.110/32",
    "13.66.16.101/32",
    "13.66.38.99/32",
    "13.66.39.88/32",
    "13.66.138.96/27",
    "13.66.209.135/32",
    "13.66.212.205/32",
    "13.66.226.80/32",
    "13.66.231.217/32",
    "13.66.241.134/32",
    "13.66.244.249/32",
    "13.67.9.0/25",
    "13.67.56.225/32",
    "13.67.63.90/32",
    "13.67.129.26/32",
    "13.67.141.98/32",
    "13.68.29.136/32",
    "13.68.101.62/32",
    "13.69.68.0/23",
    "13.69.186.152/32",
    "13.69.228.0/25",
    "13.69.253.145/32",
    "13.70.72.32/27",
    "13.70.123.149/32",
    "13.70.146.110/32",
    "13.70.147.206/32",
    "13.71.122.35/32",
    "13.71.123.138/32",
    "13.71.149.151/32",
    "13.71.170.128/27",
    "13.71.194.192/27",
    "13.73.1.134/32",
    "13.73.26.73/32",
    "13.73.116.45/32",
    "13.73.118.104/32",
    "13.74.41.233/32",
    "13.74.147.218/32",
    "13.74.158.5/32",
    "13.74.252.44/32",
    "13.75.34.160/27",
    "13.75.46.26/32",
    "13.75.47.15/32",
    "13.75.89.224/32",
    "13.75.112.108/32",
    "13.75.115.40/32",
    "13.75.138.224/32",
    "13.75.147.143/32",
    "13.75.147.201/32",
    "13.75.218.45/32",
    "13.76.44.139/32",
    "13.76.245.96/32",
    "13.77.7.175/32",
    "13.77.50.96/27",
    "13.77.82.141/32",
    "13.77.83.246/32",
    "13.77.96.119/32",
    "13.77.157.133/32",
    "13.77.160.237/32",
    "13.77.182.13/32",
    "13.78.59.237/32",
    "13.78.106.96/27",
    "13.78.117.86/32",
    "13.78.123.87/32",
    "13.78.150.96/32",
    "13.78.184.89/32",
    "13.79.2.71/32",
    "13.79.38.229/32",
    "13.79.172.40/32",
    "13.80.19.74/32",
    "13.81.7.21/32",
    "13.81.108.99/32",
    "13.81.215.235/32",
    "13.82.93.245/32",
    "13.82.101.179/32",
    "13.82.175.96/32",
    "13.84.36.2/32",
    "13.84.40.227/32",
    "13.84.42.35/32",
    "13.84.46.29/32",
    "13.84.55.137/32",
    "13.84.146.60/32",
    "13.84.180.32/32",
    "13.84.181.47/32",
    "13.84.188.162/32",
    "13.84.189.137/32",
    "13.84.227.164/32",
    "13.85.15.194/32",
    "13.85.16.224/32",
    "13.85.20.144/32",
    "13.85.24.220/32",
    "13.85.27.14/32",
    "13.85.31.243/32",
    "13.85.72.129/32",
    "13.85.77.179/32",
    "13.85.82.0/32",
    "13.89.57.7/32",
    "13.89.172.0/23",
    "13.89.238.239/32",
    "13.90.143.69/32",
    "13.90.213.204/32",
    "13.91.40.166/32",
    "13.91.242.166/32",
    "13.92.139.214/32",
    "13.92.193.110/32",
    "13.92.237.218/32",
    "13.93.141.10/32",
    "13.93.158.16/32",
    "13.93.220.109/32",
    "13.93.231.75/32",
    "13.94.47.87/32",
    "13.94.143.57/32",
    "13.94.192.98/32",
    "13.94.211.38/32",
    "13.95.82.181/32",
    "13.95.93.152/32",
    "13.95.150.128/32",
    "13.95.238.192/32",
    "20.36.43.207/32",
    "20.36.72.230/32",
    "20.36.106.96/27",
    "20.37.74.96/27",
    "20.38.146.160/27",
    "20.42.128.96/27",
    "20.44.2.32/27",
    "20.44.26.160/27",
    "20.45.122.160/27",
    "20.150.170.192/27",
    "20.150.178.160/27",
    "20.150.186.160/27",
    "20.188.98.74/32",
    "20.189.104.96/27",
    "23.96.0.52/32",
    "23.96.1.109/32",
    "23.96.13.243/32",
    "23.96.32.128/32",
    "23.96.96.142/32",
    "23.96.103.159/32",
    "23.96.112.53/32",
    "23.96.113.128/32",
    "23.96.124.25/32",
    "23.96.187.5/32",
    "23.96.201.21/32",
    "23.96.207.177/32",
    "23.96.209.155/32",
    "23.96.220.116/32",
    "23.97.56.169/32",
    "23.97.79.119/32",
    "23.97.96.32/32",
    "23.97.160.56/32",
    "23.97.160.74/32",
    "23.97.162.202/32",
    "23.97.195.129/32",
    "23.97.208.18/32",
    "23.97.214.177/32",
    "23.97.216.47/32",
    "23.97.224.11/32",
    "23.98.64.36/32",
    "23.98.64.158/32",
    "23.99.0.12/32",
    "23.99.65.65/32",
    "23.99.91.55/32",
    "23.99.110.192/32",
    "23.99.116.70/32",
    "23.99.128.52/32",
    "23.99.183.149/32",
    "23.99.192.132/32",
    "23.99.196.180/32",
    "23.99.206.151/32",
    "23.99.224.56/32",
    "23.100.1.29/32",
    "23.100.46.198/32",
    "23.100.48.106/32",
    "23.100.50.51/32",
    "23.100.52.22/32",
    "23.100.56.27/32",
    "23.100.72.240/32",
    "23.100.82.11/32",
    "23.101.10.141/32",
    "23.101.27.182/32",
    "23.101.54.230/32",
    "23.101.63.214/32",
    "23.101.67.245/32",
    "23.101.118.145/32",
    "23.101.119.44/32",
    "23.101.119.163/32",
    "23.101.120.195/32",
    "23.101.125.65/32",
    "23.101.147.117/32",
    "23.101.169.175/32",
    "23.101.171.94/32",
    "23.101.172.244/32",
    "23.101.180.75/32",
    "23.101.203.117/32",
    "23.101.203.214/32",
    "23.101.207.250/32",
    "23.101.208.52/32",
    "23.101.224.24/32",
    "23.101.230.162/32",
    "23.102.12.43/32",
    "23.102.21.198/32",
    "23.102.21.212/32",
    "23.102.25.149/32",
    "23.102.28.178/32",
    "23.102.154.38/32",
    "23.102.161.217/32",
    "23.102.191.170/32",
    "40.67.58.192/27",
    "40.68.40.55/32",
    "40.68.205.178/32",
    "40.68.208.131/32",
    "40.68.210.104/32",
    "40.68.214.185/32",
    "40.69.43.225/32",
    "40.69.88.149/32",
    "40.69.106.96/27",
    "40.69.190.41/32",
    "40.69.200.124/32",
    "40.69.210.172/32",
    "40.69.218.150/32",
    "40.70.27.35/32",
    "40.70.147.0/25",
    "40.71.0.179/32",
    "40.71.11.128/25",
    "40.71.177.34/32",
    "40.71.199.117/32",
    "40.71.250.191/32",
    "40.74.100.128/27",
    "40.74.133.20/32",
    "40.74.245.188/32",
    "40.74.253.108/32",
    "40.74.255.112/32",
    "40.76.5.137/32",
    "40.76.192.15/32",
    "40.76.210.54/32",
    "40.76.218.33/32",
    "40.76.223.101/32",
    "40.77.56.174/32",
    "40.78.18.232/32",
    "40.78.25.157/32",
    "40.78.48.219/32",
    "40.78.194.96/27",
    "40.79.65.200/32",
    "40.79.130.128/27",
    "40.79.154.192/27",
    "40.79.171.64/27",
    "40.79.178.96/27",
    "40.79.195.0/27",
    "40.80.50.160/27",
    "40.80.155.102/32",
    "40.80.156.205/32",
    "40.83.16.172/32",
    "40.83.72.59/32",
    "40.83.124.73/32",
    "40.83.145.50/32",
    "40.83.150.233/32",
    "40.83.182.206/32",
    "40.83.183.236/32",
    "40.83.184.25/32",
    "40.84.54.203/32",
    "40.84.59.174/32",
    "40.84.148.247/32",
    "40.84.159.58/32",
    "40.84.194.106/32",
    "40.84.226.176/32",
    "40.84.227.180/32",
    "40.84.232.28/32",
    "40.85.74.227/32",
    "40.85.92.115/32",
    "40.85.96.208/32",
    "40.85.190.10/32",
    "40.85.212.173/32",
    "40.85.230.182/32",
    "40.86.86.144/32",
    "40.86.91.212/32",
    "40.86.96.177/32",
    "40.86.99.202/32",
    "40.86.225.89/32",
    "40.86.230.96/32",
    "40.87.65.131/32",
    "40.87.70.95/32",
    "40.89.131.148/32",
    "40.89.141.103/32",
    "40.112.69.156/32",
    "40.112.90.244/32",
    "40.112.93.201/32",
    "40.112.142.148/32",
    "40.112.143.134/32",
    "40.112.143.140/32",
    "40.112.143.214/32",
    "40.112.165.44/32",
    "40.112.166.161/32",
    "40.112.191.159/32",
    "40.112.192.69/32",
    "40.112.216.189/32",
    "40.112.243.0/25",
    "40.113.2.52/32",
    "40.113.65.9/32",
    "40.113.71.148/32",
    "40.113.81.82/32",
    "40.113.90.202/32",
    "40.113.126.251/32",
    "40.113.131.37/32",
    "40.113.136.240/32",
    "40.113.142.219/32",
    "40.113.204.88/32",
    "40.113.232.243/32",
    "40.113.236.45/32",
    "40.114.13.25/32",
    "40.114.41.245/32",
    "40.114.51.68/32",
    "40.114.68.21/32",
    "40.114.106.25/32",
    "40.114.194.188/32",
    "40.114.210.78/32",
    "40.114.228.161/32",
    "40.114.237.65/32",
    "40.114.243.70/32",
    "40.115.55.251/32",
    "40.115.98.85/32",
    "40.115.179.121/32",
    "40.115.251.148/32",
    "40.117.154.240/32",
    "40.117.188.126/32",
    "40.117.190.72/32",
    "40.118.29.72/32",
    "40.118.71.240/32",
    "40.118.96.231/32",
    "40.118.100.127/32",
    "40.118.101.67/32",
    "40.118.102.46/32",
    "40.118.185.161/32",
    "40.118.235.113/32",
    "40.118.246.51/32",
    "40.118.255.59/32",
    "40.121.8.241/32",
    "40.121.16.193/32",
    "40.121.32.232/32",
    "40.121.35.221/32",
    "40.121.91.199/32",
    "40.121.212.165/32",
    "40.121.221.52/32",
    "40.122.36.65/32",
    "40.122.65.162/32",
    "40.122.110.154/32",
    "40.122.114.229/32",
    "40.123.45.47/32",
    "40.123.47.58/32",
    "40.124.12.75/32",
    "40.124.13.58/32",
    "40.126.227.158/32",
    "40.126.236.22/32",
    "40.126.242.59/32",
    "40.126.245.169/32",
    "40.127.132.204/32",
    "40.127.139.252/32",
    "40.127.192.244/32",
    "40.127.196.56/32",
    "51.105.66.160/27",
    "51.105.74.160/27",
    "51.107.58.160/27",
    "51.107.154.160/27",
    "51.116.58.160/27",
    "51.116.154.224/27",
    "51.116.242.160/27",
    "51.116.250.160/27",
    "51.120.98.192/27",
    "51.120.218.192/27",
    "51.136.14.31/32",
    "51.137.106.13/32",
    "51.140.37.241/32",
    "51.140.57.176/32",
    "51.140.59.233/32",
    "51.140.75.147/32",
    "51.140.84.145/32",
    "51.140.85.106/32",
    "51.140.87.39/32",
    "51.140.122.226/32",
    "51.140.146.128/26",
    "51.140.152.154/32",
    "51.140.153.150/32",
    "51.140.180.76/32",
    "51.140.185.151/32",
    "51.140.191.223/32",
    "51.140.210.96/27",
    "51.140.244.162/32",
    "51.140.245.89/32",
    "51.141.12.112/32",
    "51.141.37.245/32",
    "51.141.44.139/32",
    "51.141.45.207/32",
    "51.141.90.252/32",
    "51.143.102.21/32",
    "51.143.191.44/32",
    "51.144.7.192/32",
    "51.144.107.53/32",
    "51.144.116.43/32",
    "51.144.164.215/32",
    "51.144.182.8/32",
    "52.136.138.55/32",
    "52.138.196.70/32",
    "52.138.218.121/32",
    "52.143.137.150/32",
    "52.151.62.51/32",
    "52.160.40.218/32",
    "52.161.96.193/32",
    "52.162.107.0/25",
    "52.162.208.73/32",
    "52.163.122.160/32",
    "52.164.201.186/32",
    "52.164.250.133/32",
    "52.165.129.203/32",
    "52.165.135.234/32",
    "52.165.155.12/32",
    "52.165.155.237/32",
    "52.165.163.223/32",
    "52.165.168.40/32",
    "52.165.174.123/32",
    "52.165.184.170/32",
    "52.165.220.33/32",
    "52.165.224.81/32",
    "52.165.237.15/32",
    "52.166.78.97/32",
    "52.166.113.188/32",
    "52.166.119.99/32",
    "52.166.178.208/32",
    "52.166.181.85/32",
    "52.166.198.163/32",
    "52.168.125.188/32",
    "52.169.73.236/32",
    "52.169.78.163/32",
    "52.169.180.223/32",
    "52.169.184.163/32",
    "52.169.188.236/32",
    "52.169.191.40/32",
    "52.170.7.25/32",
    "52.170.46.174/32",
    "52.171.56.101/32",
    "52.171.56.110/32",
    "52.171.136.200/32",
    "52.171.140.237/32",
    "52.171.218.239/32",
    "52.171.221.170/32",
    "52.171.222.247/32",
    "52.172.54.225/32",
    "52.172.195.80/32",
    "52.172.204.196/32",
    "52.172.219.121/32",
    "52.173.28.95/32",
    "52.173.36.83/32",
    "52.173.76.33/32",
    "52.173.77.140/32",
    "52.173.83.49/32",
    "52.173.84.157/32",
    "52.173.87.130/32",
    "52.173.94.173/32",
    "52.173.134.115/32",
    "52.173.139.99/32",
    "52.173.139.125/32",
    "52.173.149.254/32",
    "52.173.151.229/32",
    "52.173.184.147/32",
    "52.173.245.249/32",
    "52.173.249.137/32",
    "52.174.3.80/32",
    "52.174.7.133/32",
    "52.174.35.5/32",
    "52.174.106.15/32",
    "52.174.150.25/32",
    "52.174.181.178/32",
    "52.174.184.18/32",
    "52.174.193.210/32",
    "52.174.235.29/32",
    "52.175.158.219/32",
    "52.175.202.25/32",
    "52.175.254.10/32",
    "52.176.2.229/32",
    "52.176.5.241/32",
    "52.176.6.0/32",
    "52.176.6.37/32",
    "52.176.61.128/32",
    "52.176.104.120/32",
    "52.176.149.197/32",
    "52.176.165.69/32",
    "52.177.169.150/32",
    "52.177.189.138/32",
    "52.177.206.73/32",
    "52.178.29.39/32",
    "52.178.37.244/32",
    "52.178.43.209/32",
    "52.178.45.139/32",
    "52.178.46.181/32",
    "52.178.75.200/32",
    "52.178.79.163/32",
    "52.178.89.129/32",
    "52.178.90.230/32",
    "52.178.92.96/32",
    "52.178.105.179/32",
    "52.178.114.226/32",
    "52.178.158.175/32",
    "52.178.164.235/32",
    "52.178.179.169/32",
    "52.178.190.191/32",
    "52.178.201.147/32",
    "52.178.208.12/32",
    "52.178.212.17/32",
    "52.178.214.89/32",
    "52.179.97.15/32",
    "52.179.188.206/32",
    "52.180.178.6/32",
    "52.180.183.66/32",
    "52.183.82.125/32",
    "52.184.162.135/32",
    "52.184.193.103/32",
    "52.184.193.104/32",
    "52.187.17.126/32",
    "52.187.36.104/32",
    "52.187.52.94/32",
    "52.187.135.79/32",
    "52.187.206.243/32",
    "52.187.229.23/32",
    "52.189.213.49/32",
    "52.225.179.39/32",
    "52.225.190.65/32",
    "52.226.134.64/32",
    "52.228.42.76/32",
    "52.229.30.210/32",
    "52.229.115.84/32",
    "52.230.1.186/32",
    "52.231.18.128/27",
    "52.231.32.120/32",
    "52.231.38.95/32",
    "52.231.77.58/32",
    "52.231.146.96/27",
    "52.231.200.101/32",
    "52.231.200.179/32",
    "52.232.19.237/32",
    "52.232.26.228/32",
    "52.232.33.202/32",
    "52.232.56.79/32",
    "52.232.127.196/32",
    "52.233.38.143/32",
    "52.233.128.61/32",
    "52.233.133.18/32",
    "52.233.133.121/32",
    "52.233.155.168/32",
    "52.233.164.195/32",
    "52.233.175.59/32",
    "52.233.184.181/32",
    "52.233.198.206/32",
    "52.234.209.94/32",
    "52.237.18.220/32",
    "52.237.22.139/32",
    "52.237.130.0/32",
    "52.237.205.163/32",
    "52.237.214.221/32",
    "52.237.246.162/32",
    "52.240.149.243/32",
    "52.240.155.58/32",
    "52.242.22.213/32",
    "52.242.27.213/32",
    "52.243.39.89/32",
    "52.246.154.160/27",
    "52.255.35.249/32",
    "52.255.54.134/32",
    "65.52.24.41/32",
    "65.52.128.33/32",
    "65.52.130.1/32",
    "65.52.160.119/32",
    "65.52.168.70/32",
    "65.52.213.73/32",
    "65.52.217.59/32",
    "65.52.218.253/32",
    "65.52.250.96/27",
    "94.245.104.73/32",
    "102.133.26.32/27",
    "102.133.122.160/27",
    "102.133.154.32/27",
    "102.133.250.160/27",
    "104.40.3.53/32",
    "104.40.11.192/32",
    "104.40.28.133/32",
    "104.40.53.219/32",
    "104.40.63.98/32",
    "104.40.84.133/32",
    "104.40.92.107/32",
    "104.40.129.89/32",
    "104.40.147.180/32",
    "104.40.147.216/32",
    "104.40.158.55/32",
    "104.40.179.243/32",
    "104.40.183.236/32",
    "104.40.185.192/32",
    "104.40.187.26/32",
    "104.40.191.174/32",
    "104.40.210.25/32",
    "104.40.215.219/32",
    "104.40.222.81/32",
    "104.40.250.100/32",
    "104.41.9.139/32",
    "104.41.13.179/32",
    "104.41.63.108/32",
    "104.41.186.103/32",
    "104.41.216.137/32",
    "104.41.229.199/32",
    "104.42.53.248/32",
    "104.42.78.153/32",
    "104.42.128.171/32",
    "104.42.148.55/32",
    "104.42.152.64/32",
    "104.42.154.105/32",
    "104.42.188.146/32",
    "104.42.231.5/32",
    "104.43.129.105/32",
    "104.43.140.101/32",
    "104.43.142.33/32",
    "104.43.221.31/32",
    "104.43.246.71/32",
    "104.43.254.102/32",
    "104.44.128.13/32",
    "104.44.130.38/32",
    "104.45.1.117/32",
    "104.45.14.249/32",
    "104.45.81.79/32",
    "104.45.95.61/32",
    "104.45.129.178/32",
    "104.45.141.247/32",
    "104.45.152.13/32",
    "104.45.152.60/32",
    "104.45.154.200/32",
    "104.45.226.98/32",
    "104.45.231.79/32",
    "104.46.38.245/32",
    "104.46.44.78/32",
    "104.46.61.116/32",
    "104.46.101.59/32",
    "104.47.137.62/32",
    "104.47.151.115/32",
    "104.47.160.14/32",
    "104.47.164.119/32",
    "104.209.178.67/32",
    "104.209.192.206/32",
    "104.209.197.87/32",
    "104.210.38.149/32",
    "104.210.69.241/32",
    "104.210.92.71/32",
    "104.210.145.181/32",
    "104.210.147.57/32",
    "104.210.152.76/32",
    "104.210.152.122/32",
    "104.210.153.116/32",
    "104.210.158.20/32",
    "104.211.26.212/32",
    "104.211.81.32/27",
    "104.211.97.138/32",
    "104.211.146.96/27",
    "104.211.160.159/32",
    "104.211.179.11/32",
    "104.211.184.197/32",
    "104.211.224.252/32",
    "104.211.225.167/32",
    "104.214.20.0/23",
    "104.214.29.203/32",
    "104.214.64.238/32",
    "104.214.74.110/32",
    "104.214.77.221/32",
    "104.214.110.60/32",
    "104.214.110.226/32",
    "104.214.118.174/32",
    "104.214.119.36/32",
    "104.214.137.236/32",
    "104.214.231.110/32",
    "104.214.236.47/32",
    "104.214.237.135/32",
    "104.215.11.176/32",
    "104.215.58.230/32",
    "104.215.73.236/32",
    "104.215.78.13/32",
    "104.215.89.22/32",
    "104.215.147.45/32",
    "104.215.155.1/32",
    "111.221.95.27/32",
    "137.116.78.243/32",
    "137.116.88.213/32",
    "137.116.128.188/32",
    "137.116.153.238/32",
    "137.117.9.212/32",
    "137.117.17.70/32",
    "137.117.58.204/32",
    "137.117.66.167/32",
    "137.117.84.54/32",
    "137.117.90.63/32",
    "137.117.93.87/32",
    "137.117.166.35/32",
    "137.117.175.14/32",
    "137.117.203.130/32",
    "137.117.211.244/32",
    "137.117.218.101/32",
    "137.117.224.218/32",
    "137.117.225.87/32",
    "137.135.91.176/32",
    "137.135.107.235/32",
    "137.135.129.175/32",
    "137.135.133.221/32",
    "138.91.0.30/32",
    "138.91.16.18/32",
    "138.91.224.84/32",
    "138.91.225.40/32",
    "138.91.240.81/32",
    "157.56.13.114/32",
    "168.61.152.29/32",
    "168.61.159.114/32",
    "168.61.217.214/32",
    "168.61.218.125/32",
    "168.62.20.37/32",
    "168.62.48.183/32",
    "168.62.180.173/32",
    "168.62.224.13/32",
    "168.62.225.23/32",
    "168.63.5.231/32",
    "168.63.53.239/32",
    "168.63.107.5/32",
    "191.232.38.77/32",
    "191.232.176.16/32",
    "191.233.82.44/32",
    "191.233.85.165/32",
    "191.233.87.194/32",
    "191.233.203.32/27",
    "191.234.16.188/32",
    "191.235.81.73/32",
    "191.235.90.70/32",
    "191.235.160.13/32",
    "191.235.176.12/32",
    "191.235.177.30/32",
    "191.235.208.12/32",
    "191.235.215.184/32",
    "191.236.16.12/32",
    "191.236.59.67/32",
    "191.236.80.12/32",
    "191.236.106.123/32",
    "191.236.148.9/32",
    "191.236.192.121/32",
    "191.237.24.89/32",
    "191.237.27.74/32",
    "191.237.128.238/32",
    "191.238.8.26/32",
    "191.238.33.50/32",
    "191.238.176.139/32",
    "191.238.240.12/32",
    "191.239.58.162/32",
    "191.239.188.11/32",
    "207.46.144.49/32",
    "207.46.147.148/32"


  • Jira Server app (add-on) establishes a connection with Azure SignalR Hub (https://msteams-jira-server.service.signalr.net)
  • Bot is built on top of Azure Bot Framework Service:
    • login.botframework.com (Bot authentication)
    • login.microsoftonline.com (Bot authentication)
    • *.botframework.com (Bot channels)
    • westus.api.cognitive.microsoft.com
    • (for Luis.ai NLP integration)
    • state.botframework.com
    • (Bot state storage)
    • cortanabfchanneleastus.azurewebsites.net
    • (Cortana channel)
    • cortanabfchannelwestus.azurewebsites.net (Cortana channel)

Authorization

Starting with version 1.4., Jira Server for Microsoft Teams (App 1) (Jira Server application 2019.10.20 released on 2019-10-21) uses pure OAuth 1.0a authentication flow.

It requires the end-user to authenticate in Jira Server, allow using her credentials to authenticate as her in future, and provide generated verification code to Microsoft Teams.

Jira Server for Microsoft Teams does not process and store Jira user passwords.

Version 1.4x and above:

To successfully authenticate in app it's required for user to have direct network access to Jira Server. This may mean connecting VPN or doing this inside work subnet where Jira Server is hosted. Please note this is valid only for authentication process and is not needed further for other workflows.

Revamped process now consists of 9 stages:

  1. Enter Jira id in Microsoft Teams. Click “Connect”. 
  2. On the next screen click on the “Authorize” link. It has the following format: https:///jira/plugins/servlet/oauth/authorize?oauth_token=.
  3. It will either open Jira login page or redirect you to third-party identity provider like Azure Active Directory. Please put your credentials and log in.

  4. You will be redirected to Jira authorization page asking to allow Microsoft Teams to access to your data in Jira. Note you do not pass and store password in our app.

  5. Click “Allow”. You will be redirected to “Access Approved” Jira page.

  6. Look for verification code and copy it. Note this page can be displayed in a locale selected in your Jira profile and verification code may have other punctuation signs other than apostrophes around it.
  7. Paste the verification code to a respective field in Microsoft Teams.

  8. Click “Continue”. If the code is correct, you will be redirected to “Authentication successful” page and popup should close.
  9. You are all set and can manage your Jira issues in Microsoft Teams.


Additional notes:

  • To change the user or stop working with the integration, you can use the Sign out function in the tabs, and the disconnect bot command.
  • If you previously grated Microsoft Teams the access to the Jira data, you don't need to re-authorize.
  • If you're trying to authenticate with an old Microsoft Teams for Jira Server app version, you’ll get a warning after ‘Connect’ step asking to contact your Jira administrator to update the app to the most recent version

FAQ

In this section we have gathered the most common requests to our support team and obstacles that users can face working with the app. You might find the answers to your questions here. You may also reach to our support team via the contact form here in case you still have questions.

Where do I find my Jira ID?

Jira ID is a unique identified that is generated after installing Microsoft Teams for Jira on your Jira instance. If you have the Jira admin permissions, you can see the Jira ID at the bottom of the app configuration page. If you're not an admin, you'll need to contact them to get the Jira ID.


How do I connect Microsoft Teams to my Jira instance?

To connect Microsoft Teams to your Jira instance, you need to:

  • Install the Microsoft Teams for Jira app on your Jira instance
  • Configure the Application link

Once the app is installed, in Microsoft Teams you'll be asked to provide the Jira ID. This is a unique ID generated by the app.


How do I revoke access in Jira?

To revoke app access in Jira:

  1. Go to Profile.
  2. Select Tools > View OAuth Access Tokens.
  3. Find MicrosoftTeamsIntegration, and select Revoke Access.


Does the app store Jira login details I have entered?

The app uses OAuth 1.0 to authenticate the user. The app doesn’t store or collect user’s login details.


Can I use the app without Jira admin rights?

Yes, you can use the app if admin has already set up the app in Jira and shared the Jira ID with you. However, you won’t be able to install it without admin rights.


Does everyone within the channel see the data I’m sharing through the app?

If you interact with the bot, everyone can see the replies and data that the bot sends into the channel. Also, if you share Jira issues through messaging extension, it is visible for others in the channel or conversation. However, if you add Jira Server tab to your channel, then the other teammates will have to authorize to see the tab contents.


I don’t receive notifications from Jira Server connector.

If you configured the Jira Server connector in your channel and don’t receive notifications, try doing the following:

  • Check if the connector is added into Microsoft Teams channel. Go to Configured > Find “Jira Server”
  • If you have Jira administrator permissions, go to Administration > System > Webhooks, and make sure the webhook for this connector is added. The webhook URL should start with: https://connectors.msteams-atlassian.com/JiraServer/...


There are a lot of IPs that needed to be allowlisted. Is it possible reduce the list?

No, in order for the application to work properly, all the IPs from the list should be allowlisted in your system. The IPs for whitelist required by the Microsoft Azure services that are running on the backend. You may find IP details for whitelist from official source here.


I’m having error on authorization step in Microsoft Teams when connecting to my Jira instance. What should I do?

Try re-installing both Microsoft Teams for Jira app and Microsoft Teams add-on in your Jira instance. Also, please make sure you use the latest version of the add-on from Marketplace. If the issue persists - reach out to our support team.


I don’t see Jira Server / Jira Cloud / Confluence / Bitbucket app in “Apps” menu in my Microsoft Teams. How can I install them?

Most likely you don’t have permissions to install 3rd-party apps in your Microsoft Teams tenant. Contact your Office 365 admin to help you installing the needed app.


Where do I find Jira add-on configuration?

After the add-on is installed in your Jira instance, you can find the configurations under Administration -> Manage Apps -> Microsoft Teams for Jira Server. Please note, “Administration” menu is only available for the Jira admins.