Sync user attributes to your organization

If you want to add a public name to an Atlassian user profile, you can include the attribute from your identity provider and synchronize the user to your Atlassian organization. This enables the public name to appear in the Atlassian user's profile.

Set up mapping for Okta

To map an attribute for Okta:

1. Go to Atlassian Cloud app in Okta.

2. Switch to the Provisioning tab.

3. From the left hand pane, under Settings select To App.

4. Under Atlassian Cloud Attribute Mappings, select Go to Profile Editor.

5. Select Add Attributes. Depending on the attribute that you want to add, enter the following values.

   1. For nickname:
      * Variable name: nickName
      * External name: nickName
      * External namespace: <namespace> urn:ietf:params:scim:schemas:core:2.0:User

   2. For location:
      * Variable name: basedIn
      * External name: basedIn
      * External namespace: urn:scim:schemas:extension:atlassian-custom:1.0:Attributes

6. Save the attribute.

7. Select the Mappings button.

8. From the top menu select Okta User to Atlassian Cloud tab.

9. Under Okta User User Profile section, select the variable name for the attribute you added.

   1. Select nickname and map it to the nickname attribute you created.

   2. Select location and map it to the basedIn attribute you created for location.
      If no location attribute exists, you can create your own.

10. Select Save Mappings.

Set up mapping for Microsoft Azure

If you want to set up a mapping for a user’s location, use an existing location attribute. If there’s no location attribute, create one first. To create a location attribute:

1. Go to Atlassian Cloud app in Microsoft Azure AD.

2. Select Provisioning.

3. Under Edit provisioning, select Mappings and select Provision Microsoft Entra ID Users.

4. Under Attribute Mappings, select Edit attribute list for AtlassianCloud.

5. For the attribute name, enter urn:scim:schemas:extension:atlassian-custom:1.0:Attributes:basedIn.

6. Save your changes.

To map an attribute for Microsoft Azure:

1. Go to Atlassian Cloud app in Microsoft Azure AD.

2. Select Provisioning.

3. Under Edit provisioning, select Mappings and select Provision Microsoft Entra ID Users.

4. Under Attribute Mappings, select Add New Mapping. For each mapping you want to add, enter the following:

   1. For nickname:
      * From Source attribute, select Public Name.
      * From Target attribute, select nickName.

   2. For location:
      * From Source attribute, select physicalDeliveryOfficeName.
      * From Target attribute, select urn:scim:schemas:extension:atlassian-custom:1.0:Attributes:basedIn.

5. Save your changes.

Set up mapping for OneLogin

To map an attribute for OneLogin:

1. Go to Atlassian Cloud app in OneLogin.

2. Select Parameters.

3. Under Optional Parameters select Nickname.

4. From the attribute that you’re using for location, map it to urn:scim:schemas:extension:atlassian-custom:1.0:Attributes:basedIn. If there’s no location attribute, create a new one with this mapping.

5. Select the source field.

6. Under Flags options, check Include in User Provisioning.

7. Save the changes.

Sync user to your Atlassian organization

In your identity provider:

1. Go to the profile of the user you want to sync the public name for to Atlassian

2. Add the value to the Source attribute you selected (for example mailNickname field)

3. Sync the user to Atlassian by assigning Atlassian Cloud App to user
   
   

In your Atlassian organization:
To check the user’s public name:

1. Ask user to log in to the Atlassian account

2. View the Profile and visibility page: https://id.atlassian.com/manage-profile/profile-and-visibility