Configure Microsoft connection
- Dorrit Riemenschneider-Denecke
- Sandro Herrmann
- Melina Friebel
“Out of Office Sync for Jira and Microsoft” needs access to your Microsoft 365 organization to be able to display information from there.
Admin consent / permissions
The app needs the following permissions in Microsoft Entra ID:
User.Read.All
MailboxSettings.Read
Be aware that the list of permissions may be altered in the future.
Configuring Microsoft 365 access and giving consent
To enable “Out of Office Sync for Jira and Microsoft“ to fetch information from Microsoft 365, a Microsoft tenant administrator has to give their consent to our app by going through an approval process.
As Jira site admin go to “Out of Office Sync for Jira and Microsoft” configuration page > Out of Office Sync for Jira and Microsoft in the left sidebar in the Apps section.
Start the approval process
Follow the instructions on the page.
Share approval link with microsoft tenant admin
The Microsoft 365 administrator will be guided through the approval process.
Step 1 - Basic Information
Information about the Jira system that is about to be connected to the Microsoft tenant is shown. Clicking the “Give consent” button will forward to Microsoft.
Step 2 - Give Consent in the Microsoft 365 tenant
Microsoft will show a login screen. A Microsoft 365 tenant administrator needs to login and give consent for the installation of the “Out of Office Sync for Jira” app.
Step 3 - Approval Check
The Microsoft 365 administrator gets an information about the successful consent. An approval token has been created that needs to be shared with the Jira site administrator.
Finalize Approval process
The Microsoft 365 administrator will provide the Jira site administrator with a token that needs to be inserted into the configuration section. This completes the approval process.
Reconsenting
When introducing new permissions that require consent from the Microsoft 365 administrator, a reconsenting process must be followed. This process requires action from both Jira and Microsoft 365 administrators.
Since the initial consenting process has already been completed, Jira administrators can simply provide the previously generated link, which can be found in the configuration section of the app, to the Microsoft 365 administrator.
The Microsoft 365 administrator can then follow the link and provide consent for the app. The consent form will include the newly requested permissions as well as any previously consented permissions. The approval token does not need to be exchanged in this case.