Integrating Okta Repository with SysAid

Prev Next

SysAid’s Okta Repository integration allows you to more efficiently manage the users in your company from one central location, by automatically pulling user data from Okta to SysAid. The integration runs these data imports on a schedule that you define, saving time and preventing human error that could occur from manually copying the data.

While this integration provides admins with access to users from Azure within SysAid, the users themselves cannot access SysAid unless you also enable the Okta integration.

Please note:

In case you decide to install the integration that we do not provide our support, you hereby acknowledge and agree that you install and maintain such integration on your sole responsibility and that SysAid will have no responsibility, nor liability, with this regard.

Set up the Okta Repository integration

You must have a Super Admin role in Okta to access all the relevant details for the integration.

To set up the integration:

  1. In SysAid, go to Connect > Marketplace.

  2. Get the Okta Repository add-on.

  3. On the main My apps page, click the cog icon in the Okta Repository card.

  4. Enter your Okta account URL.

  5. Log in to your Okta Admin Console.

  6. Navigate to Security > API.

  7. Switch to the Tokens tab and click Create token.

  8. Give the token a name.

  9. In the API calls made with the token must originate from drop-down, select Any IP.

  10. Click Create token.

  11. Copy the token.

    Please note:

    You will not be able to view the key again. Make sure to save it somewhere if you’ll need to access it again.

  12. Click OK, got it.

  13. Back in SysAid, paste the copied token into the Token field.

  14. Enter the number of hours you want for the update interval.

  15. Click the toggle in the top-right corner to activate the add-on.

  16. Define which SysAid fields get populated by which Okta fields by selecting the fields from the drop-downs.

    • Click Add New Field, to map an additional field.

    • Click the trash can icon to delete a field mapping.

  17. (Optional) Select the Import Groups checkbox if you would like to import groups from Okta to SysAid.

  18. (Optional) If you want to validate a small change in Okta, you can click revert to manually run a sync from Okta to SysAid for validation purposes. Note: We do not recommend using the manual option for large updates in Okta.

  19. Click Save Changes.