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:
  4. Click the 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.


  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:
  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.
  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.
  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.


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


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


  15. Click the Application permissions banner on the right.


  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.
    Note: In cases where your Azure instance has a large number of Team Sites, or you would prefer to limit the add-on's access to a subset of all sites, please use the Sites.Selected permission instead of the Sites.ReadWrite.All permission, and complete these steps after you've finished this initial setup: Limiting Site Access.
     

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

...