Your browser does not support JavaScript!

Okta User Provisioning Integration with SCIM

This guide shows how to configure SCIM with a LeaseHawk account using Okta.

Last Update:
July 10, 2023
Reporting
Implementation

Contents

  • Supported Features
  • Requirements
  • Configuration Steps

Supported Features

Users with Single Sign-On (SSO) can exclusively access their LeaseHawk application by logging in using their Okta credentials. When users enter their Okta email address on the LeaseHawk login page, they will be seamlessly redirected to their Okta domain.

The LeaseHawk/Okta SCIM integration currently supports the following features:

  • Push Users: Users in Okta that are assigned to the LeaseHawk application within Okta are automatically added as users in LeaseHawk.
  • Update User Attributes: When users attributes are updated in Okta, they will be updated in LeaseHawk.
  • Deactivate Users: When users are deactivated in Okta, they will be set to “disabled” within LeaseHawk – which prevents the user from logging into LeaseHawk.

Requirements

Before proceeding, ensure that you meet the following requirements:

  • You have an Okta administrator account.
  • You have a LeaseHawk account.

Configuration Steps

This step automatically updates the LeaseHawk platform when Okta users are created or updated.

  1. Obtain Organization ID and API Token from the LeaseHawk support team.
  1. Navigate and login to the Okta Console.
  1. Go to Applications > Applications, select LeaseHawk.
  1. Click the “Provisioning” tab and click “Configure API Integration”.
  1. Next, click the “Enable API Integration”.
  1. Enter the SCIM Settings provided to you by theLeaseHawk support team.
  • Organization ID
  • API Token

Example of API Token Format:

Your API token should be in the following format, including the word "apikey" followed by a space:

apikey 689c872e-5fae-438c-9467-0c9fc33c882e

  1. Test the credentials by clicking Test API Credentials, which attempts to connect to Okta. If there’s an error, check the credentials entered above.
  1. Click Save.
  1. Next, on the “Provisioning” tab click “To App” and click “Edit”.
  1. Check each box for LeaseHawk supported provisioning actions:
  • Create Users
  • Update User Attributes
  • Deactivate Users
  1. Click Save to save complete the API integration.