Your browser does not support JavaScript!

Integration Guide: Okta Single Sign-On

This guide provides instructions on how to integrate LeaseHawk with Okta.

Last Update:
June 27, 2023
Reporting
Implementation

About the Integration

Through our integration with Okta, you can effortlessly enjoy a streamlined Single Sign-On authentication experience into the LeaseHawk platform.

Version Requirements

There are no version requirements for Okta.

What LeaseHawk Will Need From You

Please follow the steps below and provide the requested information to LeaseHawk to properly configure your Okta integration.

Step 1: Add the LeaseHawk integration to your Okta

  1. Login to your Okta Administrator account.
  1. Go to Applications > Applications.
  1. Select Browse App Catalog.
  1. In the Search box, enter LeaseHawk and choose “LeaseHawk” integration.
  1. Select +Add Integration.
  1. In the General Settings tab, select Done.

Step 2: Assign People and Groups to your integration

This step allows you to give permissions to the People and Groups that use their Okta login to access LeaseHawk.

  1. Select the Assignments tab.
  1. Select the Assign dropdown menu and select Assign to People or Assign to Group.
  1. In the Search box, enter and select the person or group you want to assign.
  1. Select Assign.
  1. When you’re done, select Save and Go Back.

Step 3: Send Information to LeaseHawk

Send the information below to your LeaseHawk Client Success Manager or support@leasehawk.com. To find your “Client ID” and “Client Secret” go to Applications > Applications, select LeaseHawk, then Sign On tab.

  1. Client ID
  1. Client Secret

Step 4: Request SSO and SCIM Settings from LeaseHawk

  1. Contact your LeaseHawk Client Success Manager or support@leasehawk.com to request your unique SSO and SCIM settings for Okta.
  1. Go to Applications > Applications, select LeaseHawk.
  1. Enter the following SSO settings in the Advanced Sign-On Settings.
  • LeaseHawk App URI
  • Sign-in redirect URI
  • Sign-out redirect URI
  1. Select Save.

Step 5: Allow LeaseHawk Provisioning Actions

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

  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 during Step 4.
  • Base URL endpoint
  • API Token
  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.

Okta Integration Overview: How it works

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.