This article explains the step-by-step process for adding and mapping custom attributes for an OAG application using the Okta Admin Console and ensuring they are correctly pushed to the Okta Access Gateway for integration with legacy applications.

• Okta Access Gateway (OAG)

1. In the Okta Admin Console, ​​​​navigate to Directory > Profile Editor and search for the OAG application.
2. Click on the Profile button to add custom attributes for the application.
3. Click Mappings and select the Okta to App tab.
4. Write the Okta expression in the Okta to App attribute field created.

NOTE: Change the mapping from Apply mapping on create only to Apply Mapping on user create and update, to make sure values are always pushed to OAG when changed.

5. Test the expression and output using the Preview field at the bottom of the window.
6. Once the expression result looks good, click Save Mappings, followed by Apply updates now.
7. Log back in to OAG Admin UI, open the application in edit mode, navigate to the attribute section, and click the + button to add attributes.
8. Add the attribute to be sent as a header to the legacy app by following the below sub-steps:
9. 1. First, change the Data Source to static.
   2. Map the incoming value from Okta as “appuser.<<Okta Variable Name>>”.
   3. Provide a header name.
   4. Once all fields are mapped, change the Data Source from static to IDP and click the Okay button.
   5. Repeat the above steps for all other attributes.
   6. Click Next > Next > Done to save the changes.