Okta to JSM Assets

Configure the connection to Okta by going to OnLink (Manage your apps) - Connections. Then click on Add System and select “Other Assets Sources”.

Once connection is established, please review instructions here to get started with setting up an Assets import configuration. You can then access OnLink app from the “Manage your apps” menu to further configure and set the field level mapping. Here’s an example mapping configuration. Any field available in this Okta API can be used to map to the asset attribute.

key:id=WorkerID
map:profile.email=Email
map:profile.firstName=First Name
map:profile.lastName=Last Name
map:profile.managerId=ManagerUserId
map:profile.manager=Manager Name
map:profile.department=Department

Here’s a breakdown of some of the mapping configuration items:

Any other field returned by the API can be used in the mapping.

OnLink processes data in two steps - Get Data and Import Data. To manually test, you can click on Get Data first and then wait until you see “No more pending records. Data will be imported on next Import run.” message in Job Logs. Then, click on Import. Production runs are fully automated based on the schedule you choose.

Additional field mapping examples:
map:person.legalName.familyName1=Last Name
map:person.preferredName=Preferred Name
map:person.legalName.givenName=First Name
map:person.communication.emails.emailUri=Email
map:businessCommunication.emails.0.emailUri=Work Email
map:person.legalAddress.countryCode=Country Code
map:workerStatus.statusCode.codeValue=Worker Status
map:workAssignments.0.hireDate=HireDate
map:workAssignments.0.positionID=PositionID
map:workAssignments.0.reportsTo.0.positionID=Manager Position ID
map:workAssignments.0.reportsTo.0.reportsToWorkerName.formattedName=Manager Name
map:workAssignments.0.payrollGroupCode=CompanyCode
map:workAssignments.0.homeWorkLocation.nameCode.shortName=Office
map:workAssignments.0.homeWorkLocation.address.countryCode=Country
map:workAssignments.0.jobCode.longName=JobTitle