Map custom attributes

You can map custom attributes that are not included in the default profile. Using the proxyAddresses attribute as an example, the following instructions explain how to map custom attributes.

Start this procedure

To map custom attributes, you need to:

1. Add a custom attribute to your Okta Active Directory profile

2. Add the Attribute to your Office 365 App Profile

3. Map from Okta to Office 365

1. Add a custom attribute to your Okta Active Directory profile

  1. In the Admin Console, go to DirectoryProfile EditorDirectories and select the desired AD profile.

  2. In the Profile Editor, click the Add Attribute button.

    The Pick Schema Attributes screen opens.

  1. Search for, then select the proxyAddresses attribute.

  2. Click Save.

2. Add the Attribute to your Office 365 App Profile

  1. In the Admin Console, go to DirectoryProfile EditorApps and select the Office 365 profile.

  2. In the Profile Editor, click the Add Attribute button.

    The Pick Schema Attributes screen opens.

  1. Search for, then select the ProxyAddresses attribute.
  2. Click Save.

3. Map from Okta to Office 365

  1. ​In the Microsoft Office 365 Profile Editor, click Mappings.

    The Microsoft Office 365 User Profile Mappings screen opens.

  1. Select the Okta to Microsoft Office 365 tab.
  2. Scroll down and enter the following expression for the proxyAddresses attribute: >hasDirectoryUser()?findDirectoryUser().proxyAddresses:null

  3. Click Save Mappings.

  4. Select Apply updates now so that the new mappings apply to all users with this profile.

Related topics