Skip to main content
Eptura Knowledge Center

Custom Attributes Mapping for Okta

When your organization needs custom attributes in Okta, these can be added.

  • Prerequisites
  • Mapping Custom Attributes
  • Add Custom Attribute in Okta
    • Step 1. Add attribute the application’s end
    • Step 2. Add attribute at Okta’s end
    • Step 3. Add attribute mapping

Prerequisites

  • Configure SCIM provisioning for Okta.

Mapping Custom Attributes

User custom extension schema, if any organization required other attributes, then you can use CustomExtensionName URI to segregate attributes.

urn:ietf:params:scim:schemas:extension:CustomExtensionName:2.0:User

For example:

"urn:ietf:params:scim:schemas:extension:CustomExtensionName:2.0:User":
 {
       "group": "Grp2",
        "floor": "do-sou barah",
        "middleName": "",
        "phoneExtension": "+242",
        "workMode": "Work from Home",
        "image": "ishika_bajpai.png",
        "usageLocation": "UK",
        "officeLocation": "India"
 }

SCIM allowed URIs are as follows:

  • User Core Schema
urn:ietf:params:scim:schemas:core:2.0:User
  • User Enterprise Schema, it only allows below mentioned attributes.
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User
  • manager
  • costCenter
  • department
  • organization
  • employeeNumber

For example:

"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User":
 {
       "department": "HR",
        "costCenter": "243777",
        "employeeNumber": "EP_ishika_bajpai",
        "manager": {
            "value": "32433d024-7fb7-73bc-2477e-7xxxxxxxxxx2e7",
        },
        "organization": "KPMG"
 }

Add Custom Attribute in Okta

Step 1. Add attribute at the application’s end

  1. Sign into Okta.
  2. From the menu, navigate to the Applications.
  3. Click the Application Name.
  4. Click the Provisioning tab.

On the Provisioning screen you will see the To App, To Okta, and Integration as shown in the screenshot below.

clipboard_e7905e397863e1f789d5b17852117f70e.png

  1. From the menu, click To App.

clipboard_ec5270fc2bfd4cb72454f7a72f8b0aea9.png

  1. Click the Go to Profile Editor button.
  2. Click the + Add Attribute button.

clipboard_e0079741ec648e7f1747473553ba05783.png

  1. Complete the attribute's required information.
  2. Save the attribute.

Now you have you have added one extension attribute at application’s end.

Step 2. Add attribute at Okta’s end

The process of adding extension attribute at Okta’s end is almost same as we have added at application’s end.

  1. From the menu, select Applications.
  2. Click the Application Name.
  3. Select the Provisioning tab.
  4. Click the To Okta button.

clipboard_e147e0ac0505d5ea301352a11f372616b.png

  1. Scroll down to Okta Attribute Mappings.
  2. Click the Go To Profile Editor button.

clipboard_e072f1511893826876cb182365c30254f.png

  1. Click the + Add Attribute.

clipboard_e9bbc87e8230fd0bfb6a759253cce12e3.png

  1. Complete the attribute's required information.
  2. Save the attribute.

Now you have you have added one extension attribute at Okta's end.

The attribute has been added at both ends.

Step 3. Add attribute mapping

Next, add the mapping for the new attribute.

  1. Click To Okta.
  2. Scroll down and click Show Unmapped Attributes.
  3. For the and add mapping for newly added attribute.
  4. For attribute mapping go to (A) To App tab and scroll down.
  5. Click (B) Go To Profile Editor button.
  6. Click (C) Mappings.

clipboard_eae04df39184db07883e568ad4dacb48b.png

  1. From the left-side select the SCIM APP attribute name and map it to the Okta attribute.

clipboard_e1615cff7aac0c9b242af3ef00cc651d1.png

For example:

clipboard_e7c57589bbb5d747ac54aca23775a12bd.png

  1. Click the Save Mappings button.

clipboard_e851bf2d40764e35befa65683ca3ba146.png

  1. Click Apply updates now button.