Page Comparison

...

Configure a new Microsoft app

1. Navigate to the Microsoft app registration portal at https://appsportal.dev.microsoftazure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationsListBlade.
2. Sign If necessary, sign in with your work Microsoft account.
3. You should now be looking at your list of Microsoft appsapp registrations in the Azure portal, a screen that looks similar to this:
   Image RemovedYou will be registering this app through the Azure portal. Click on the gray banner at the top to launch the preview experience in the Azure portal.
   
4. You should now be looking at the Azure portal's app registration screen, which should look similar to this:
   Image Removed
5. Click the Register an application buttonImage Added
6. Click the New registration item at the top of the screen.
   
   
7. On the Register an application screen, enter a name for your new Microsoft app, and tick the appropriate radio button for you your use case in the Supported account types section.
   Image Modified
   
   
8. 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
9. Copy the Application (client) ID value from this screen to use for the Jira add-on configuration later.
   
   
10. From the management screen's Manage menu, choose Certificates & secrets.
    Image RemovedImage Added
11. Generate a new Client secret by clicking the New client secret button.
    
    
12. Provide a description and expiration for your app's new client secret.
    Image RemovedImage Added
13. Click the Add button. The Certificates & secrets screen will refresh with the new client secret.
    
    
14. Copy the Value shown on this screen for the new client secret to use for the Jira add-on configuration later.
    Image RemovedImage Added
    
    
15. From the management screen's Manage menu, choose API permissions.
    Image Removed Image Added
    
    
16. Click the Add a permission button and choose the Microsoft Graph banner at the top.
    Image RemovedImage Added
    
    
17. Click the Application permissions banner on the right.
    Image RemovedImage Added
    
    
18. 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 Removed
     Image Added
    
    
19. 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.

Now the setup is complete, continue to the Jira Add-On Configuration page for more information on configuring the add-on.