Uploaded image for project: 'Jira Software Data Center'
  1. Jira Software Data Center
  2. JSWSERVER-21901

Need to have more documentation on architecture and operation detail of the Jira Server for Microsoft Teams Plugin

    • 6
    • We collect Jira feedback from various sources, and we evaluate what we've collected when planning our product roadmap. To understand how this piece of feedback will be reviewed, see our Implementation of New Features Policy.

      We need to provide our customers with more information on the architecture details of how the Jira Server for Microsoft Teams plugin work.
      The document we currently have in the link: https://www.msteams-atlassian.com/JiraServer/ is very abstract and doesn't give any insight on how the plugin works.

      We need to have some architecture diagrams to show how the plugin connects to Microsoft teams and what are the services that work in between Jira and the Microsoft Teams.
      Having a clear block diagram would help very much in describing the architecture.
      We would need to identify all the Azure services that will directly interface with the plugin on the customer side, Identifying their IP address ranges and their function.

      Also the document: https://www.msteams-atlassian.com/JiraServer/ requests the customer to white list a large list of IPs, it doesn't tell why those needs to be white-listed and what are the hosts/services that correspond to those IPs which makes the job of justifying those white-lists difficult.

      Moreover for customer using an outbound proxy, the documentation must be adjusted as well. The outbound proxy configuration must be adjusted to allow Jira to reach those IP through outbound proxy.

      It is unclear also that it is a bidirectional integration between the Jira server itself and the Teams application. Jira needs to communicate to the following endpoints (plus a few additional others), but these same endpoints/networks also need to communicate with Jira:

            [JSWSERVER-21901] Need to have more documentation on architecture and operation detail of the Jira Server for Microsoft Teams Plugin

            Hopefully the last sentence of the description that was added by Isabel yesterday (Oct 14th 2021) is not true, because our DataCenter System is absolutely not reachable from the internet, and so also the 3 mentioned URL's cant reach our on premise hosted DataCenter Instance.

            And I believe that it is not true, because otherwise we would not be able to use the Integration from MS Teams side at all. But this is possible even the known problems (bad performance, custom field type not supported on create screen , missing configuration options for issue display in single and list view,, etc)

            Michael Mohr added a comment - Hopefully the last sentence of the description that was added by Isabel yesterday (Oct 14th 2021) is not true, because our DataCenter System is absolutely not reachable from the internet, and so also the 3 mentioned URL's cant reach our on premise hosted DataCenter Instance. And I believe that it is not true, because otherwise we would not be able to use the Integration from MS Teams side at all. But this is possible even the known problems (bad performance, custom field type not supported on create screen , missing configuration options for issue display in single and list view,, etc)

            As we are currently have many problems around performance and stability (see also API-403) a more suitable documentation about the Microsoft Teams Plugin as well as the parties that are involved in the communication flow would be good to have for further investigations.

            Michael Mohr added a comment - As we are currently have many problems around performance and stability (see also  API-403 ) a more suitable documentation about the Microsoft Teams Plugin as well as the parties that are involved in the communication flow would be good to have for further investigations.

              Unassigned Unassigned
              sabdelfattah Sherif Abdelfattah (Inactive)
              Votes:
              9 Vote for this issue
              Watchers:
              12 Start watching this issue

                Created:
                Updated: