Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Navigate to the Microsoft app registration portal at https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationsListBlade.
  2. If necessary, sign in with your work Microsoft account.
  3. You should now be looking at your list of Microsoft app registrations in the Azure portal, a screen that looks similar to this:
    Image RemovedImage Added
  4. Click the Register an application button New registration item at the top of the screen.

  5. On the Register an application screen, enter a name for your new Microsoft app, and tick the appropriate radio button for your use case in the Supported account types section.
    Image Modified

  6. Click the Register button at the bottom of the screen. After successful registration, you will be taken to the new app's management screen:
    Image RemovedImage Added
  7. Copy the Application (client) ID value from this screen to use for the Jira add-on configuration later.

  8. From the management screen's Manage menu, choose Certificates & secrets.
    Image RemovedImage Added
  9. Generate a new Client secret by clicking the New client secret button.

  10. Provide a description and expiration for your app's new client secret.
    Image RemovedImage Added
  11. Click the Add button. The Certificates & secrets screen will refresh with the new client secret.

  12. Copy the Value shown on this screen for the new client secret to use for the Jira add-on configuration later.
    Image RemovedImage Added

  13. From the management screen's Manage menu, choose API permissions.
    Image Removed Image Added

  14. Click the Add a permission button and choose the Microsoft Graph banner at the top.
    Image RemovedImage Added

  15. Click the Application permissions banner on the right.
    Image RemovedImage Added

  16. Tick the checkboxes necessary to enable the Files.ReadWrite.All permission in the Files section, and the Sites.ReadWrite.All permission under the Sites section, then click the Add permissions button.Image RemovedImage Added

  17. Finally, after adding the necessary permissions, click the Grant admin consent for (Your Name) button under the Grant consent section on the API permissions screen and confirm the dialog.Image RemovedImage Added

Configure the Add-on

...

  1. In Jira, click on the Jira settings/gear action from the navigation menu on the left, and choose the Apps item.
    Image RemovedImage Added
  2. Under the Excel Online Integration heading, choose Configuration.

  3. On the Configuration screen, enter your Microsoft domain, the Application ID, and the Client Secret value. After entering these values, a Test button will appear. Click this button to confirm that the Microsoft app and Jira add-on have been set up properly. If the test fails, a message describing the issue will be displayed on the screen. If you need additional help, please contact us.
    Image RemovedImage Added
  4. Click the Save button.

...