To access SharePoint Online, the SharePoint Connector must be registered as an application in Microsoft Entra ID. This registration process involves information provided in the apps admin configuration in Jira.
The actual look of the Azure portal might differ from the screenshots in this guide as the user interface is updated frequently by Microsoft.
Choose the Right Directory
Choosing the right Azure AD is only necessary if your account has access to multiple directories.
On the Azure portal home page, click on your user account at the top right of the page. A details panel will open where the option Switch directory is shown. Using this option will forward you to a view with a list of accessible Azure AD tenants. Choose the one connected to your Microsoft 365 tenant.
Register Application in Microsoft Entra ID
1. Navigate to the Microsoft Entra ID service. In case you haven’t set this service up as favorite you can find it by simply searching for “Microsoft Entra ID“ in the global search:
2. Open the App registrations section and select New registration.
3. In the Register an application view, fill in the data as follows:
Please make sure to adjust the Redirect URI to point to your Jira Instance. The exact URI can be copied from the Admin configuration page in Jira:
Click on Register to create the application.
Configure the API Permissions
You should automatically get redirected to the apps configuration after creation (previous step). If not please navigate to your app before you continue.
1. Open the application's API Permissions page and add the following Microsoft Graph permissions:
More information about the required permission scopes can be found here: App Permission Reference
2. To grant the configured permissions for all users of your company simply click on "Grant admin consent for ..." and confirm:
In case you do not grant admin consent every user is asked individually when the app is used for the first time. However we recommend to Grant the consent for all users of your company to avoid unnecessary popups and user interaction.
Configure the Application ID in your Jira instance
Copy the application ID of your Microsoft Entra ID application you created in the steps before:
Open the admin area of your Jira instance and navigate to the apps configuration page
Paste the client ID from step one into the Entra Application ID field and save your configuration:
