This guide assumes you have read the how to sync the manager attribute into Atlas guide, which describes the prerequisites for syncing the manager attribute with Azure AD.

Integration Overview

Atlas determines the manager of a user by taking the value received for the manager field (manager) and looking up for a match by either email (if the value was an email) or user id (if the value was an id). Think about the manager as a reference to another person.

If you have stored the manager information in Azure AD using its native manager field, Azure AD will send us the value as the manager ID, so you don’t need to worry about this. If you’re storing the manager value in a custom field, you need to ensure that the value is either the email or the ID of the manager.

For example, here is the simple reporting line consisting of three people, where the top manager (the right-most person) doesn't have the manager set. This is usually the case with the company's Founders, CEOs, etc.

In this case, the reference is made via the email value (notice the values for the manager field in the blue boxes and how they refer to the person's manager).

Fran reports to Jane, who reports to Kurt. Fran’s manager field is Kurt’s email. Jane’s manager field is Kurt’s email. Kurt’s manager field is null.

And here is the same example but with the references made via the user IDs (notice the values for the manager filed in the blue boxes and how they refer to the person's manager).

Fran reports to Jane, who reports to Kurt. Fran’s manager field is Kurt’s user id. Jane’s manager field is Kurt’s user id. Kurt’s manager field is null.

Step 1: Add the manager attribute mapping

In Azure, navigate to the Atlassian Cloud app by clicking on “Azure Active Directory → Enterprise Applications (under “manage” in the left-side bar) → Atlassian Cloud”;
Click “Provisioning” under the Manage left side-bar, then “Edit attribute mappings“
Click Provision Azure → Active Directory Users;
Click the “Add New Mapping” button at the bottom of the screen;
Select manager (or your custom field) as the “Source attribute” and urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager as the “Target attribute“ and hit OK;
You should see the manager in the list of Attribute mappings. Click Save.

Step 2: Re-sync your users

Azure AD will automatically re-sync all the assigned groups/users once the attribute mapping changes are saved. Check the provisioning logs to confirm at the “Atlassian Cloud → Provisioning” tab.

You can also check the syncing on the Atlassian side by visiting admin.atlassian.com and navigating to “Security → Identity Providers → Your Azure Directory”, and checking the “User provisioning” info.

Once the sync is complete, visit a user profile in Atlas, Jira, or Confluence to see the new section for “Reporting lines“, which shows the user’s manager and direct reports or peers.

Troubleshooting

I don't see the manager attribute in step 5