How to Use Schema Discovery in Okta
Last Updated:
Overview
The Schema Discovery function allows the import of the user attribute schema from an application into the Okta application user profile. This enables Okta to use custom attributes configured on the application side that the basic application schema lacks. Every available application in the Okta Integration Network (OIN) lists supported features under the Functionality section, including Schema Discovery. The following image displays the supported features under the functionality section of an application in the OIN.
Applies To
- Okta Identity Engine (OIE)
- Okta Classic Engine
- Schema Discovery
- Okta Integration Network (OIN)
Solution
What is Schema Discovery, and how is it used to add missing attributes?
The Schema Discovery function allows the import of the user attribute schema from the application and reflects it in the Okta application user profile. This allows Okta to use custom attributes that the application side configures and that the basic application schema lacks.
To add the missing attribute, navigate to the Profile Editor in the Admin Console, search for the application, and add the desired attribute from the refreshed attribute list as detailed in either the video demonstration or the written instructions.
- In the Okta Admin Console, navigate to Directory > Profile Editor.
- Search for the application profile and select the name of the application to view the application profile.
- On the new page, select the Add Attribute button to open the attribute list.
- If the attribute is visible in the attribute list, select the checkbox next to it and click Save to add the attribute to the application profile in Okta.
- If the attribute is not visible in the attribute list, select the Refresh Attribute List button to refresh the attribute schema. Wait for Okta to complete the schema discovery to populate the list of available application attributes. When the schema discovery finishes, Okta displays a list of attributes that it has permission to discover.
What causes an attribute to remain missing after a refresh?
If the attribute remains missing after the refresh, review the following list of possible causes.
- The application Service Account lacks the required permissions to view or edit the attribute.
- The attribute is not available through the schema discovery flow.
- The application does not support schema discovery.
Contact the application support team for more details regarding the missing attribute.
